home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-bin / x11r6.1 / man / cat1 / lndir.0 < prev    next >
Encoding:
Text File  |  1996-10-17  |  4.1 KB  |  133 lines
  1.  
  2.  
  3.  
  4. LNDIR(1)                         LNDIR(1)
  5.  
  6.  
  7. NNAAMMEE
  8.        lndir  -     create     a  shadow directory of symbolic links to
  9.        another directory tree
  10.  
  11. SSYYNNOOPPSSIISS
  12.        llnnddiirr [ --ssiilleenntt ] [ --iiggnnoorreelliinnkkss ] _f_r_o_m_d_i_r [ _t_o_d_i_r ]
  13.  
  14. DDEESSCCRRIIPPTTIIOONN
  15.        The _l_n_d_i_r program makes a shadow copy _t_o_d_i_r of a directory
  16.        tree _f_r_o_m_d_i_r_, except that the shadow is not populated with
  17.        real files but instead with symbolic links pointing at the
  18.        real files in the _f_r_o_m_d_i_r directory tree.  This is usually
  19.        useful for maintaining source code for  different  machine
  20.        architectures.    You  create a shadow directory containing
  21.        links to the real source,  which     you  will  have  usually
  22.        mounted    from  a     remote     machine.   You     can build in the
  23.        shadow tree, and the object files will be  in  the  shadow
  24.        directory,  while the source files in the shadow directory
  25.        are just symlinks to the real files.
  26.  
  27.        This scheme has the  advantage  that  if     you  update  the
  28.        source,    you  need  not    propagate the change to the other
  29.        architectures by hand, since  all  source  in  all  shadow
  30.        directories are symlinks to the real thing: just cd to the
  31.        shadow directory and recompile away.
  32.  
  33.        The _t_o_d_i_r argument is optional and defaults to the current
  34.        directory.   The     _f_r_o_m_d_i_r  argument may be relative (e.g.,
  35.        ../src) and is relative to _t_o_d_i_r (not the  current  direc-
  36.        tory).
  37.  
  38.        Note  that  RCS, SCCS, CVS and CVS.adm directories are not
  39.        shadowed.
  40.  
  41.        If you add files, simply run _l_n_d_i_r again.  New files  will
  42.        be  silently  added.   Old files will be checked that they
  43.        have the correct link.
  44.  
  45.        Deleting files is a more     painful  problem;  the     symlinks
  46.        will just point into never never land.
  47.  
  48.        If  a  file in _f_r_o_m_d_i_r is a symbolic link, _l_n_d_i_r will make
  49.        the same link in _t_o_d_i_r rather than making a link     back  to
  50.        the  (symbolic  link)  entry in _f_r_o_m_d_i_r_.     The --iiggnnoorreelliinnkkss
  51.        flag changes this behavior.
  52.  
  53. OOPPTTIIOONNSS
  54.        -silent
  55.           Normally _l_n_d_i_r outputs the name of  each    subdirec-
  56.           tory  as    it  descends into it.  The --ssiilleenntt option
  57.           suppresses these status messages.
  58.  
  59.        -ignorelinks
  60.           Causes the program to not treat symbolic    links  in
  61.  
  62.  
  63.  
  64. X Version 11           Release 6.1                1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. LNDIR(1)                         LNDIR(1)
  71.  
  72.  
  73.           _f_r_o_m_d_i_r  specially.  The link created in _t_o_d_i_r will
  74.           point back to  the  corresponding     (symbolic  link)
  75.           file  in    _f_r_o_m_d_i_r.   If the link is to a directory,
  76.           this is almost certainly the wrong thing.
  77.  
  78.           This option exists mostly to emulate  the     behavior
  79.           the  C  version  of _l_n_d_i_r had in X11R6.  Its use is
  80.           not recommended.
  81.  
  82. DDIIAAGGNNOOSSTTIICCSS
  83.        The program displays the     name  of  each     subdirectory  it
  84.        enters,    followed  by  a     colon.      The --ssiilleenntt option sup-
  85.        presses these messages.
  86.  
  87.        A warning message is displayed if the symbolic link cannot
  88.        be  created.   The usual problem is that a regular file of
  89.        the same name already exists.
  90.  
  91.        If the link already exists but doesn't point to    the  cor-
  92.        rect  file, the program prints the link name and the loca-
  93.        tion where it does point.
  94.  
  95. BBUUGGSS
  96.        The _p_a_t_c_h program gets  upset  if  it  cannot  change  the
  97.        files.  You should never run _p_a_t_c_h from a shadow directory
  98.        anyway.
  99.  
  100.        You need to use something like
  101.         find todir -type l -print | xargs rm
  102.        to clear out all files before you can relink  (if  fromdir
  103.        moved, for instance).  Something like
  104.          find . \! -type d -print
  105.        will find all files that are not directories.
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130. X Version 11           Release 6.1                2
  131.  
  132.  
  133.