158 lines
4.2 KiB
HTML
158 lines
4.2 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of LNDIR</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>LNDIR</H1>
|
|
Section: User Commands (1)<BR>Updated: lndir 1.0.3<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
lndir - create a shadow directory of symbolic links to another directory tree
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<B>lndir</B>
|
|
|
|
[
|
|
<B>-silent</B>
|
|
|
|
] [
|
|
<B>-ignorelinks</B>
|
|
|
|
] [
|
|
<B>-withrevinfo</B>
|
|
|
|
]
|
|
<I>fromdir</I>
|
|
|
|
[
|
|
<I>todir</I>
|
|
|
|
]
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
The
|
|
<I>lndir</I>
|
|
|
|
program makes a shadow copy
|
|
<I>todir </I>
|
|
|
|
of a directory tree
|
|
<I>fromdir, </I>
|
|
|
|
except that the shadow is not
|
|
populated with real files but instead with symbolic links pointing at
|
|
the real files in the
|
|
<I>fromdir</I>
|
|
|
|
directory tree. This is usually useful for maintaining source code for
|
|
different machine architectures. You create a shadow directory
|
|
containing links to the real source, which you will have usually
|
|
mounted from a remote machine. You can build in the shadow tree, and
|
|
the object files will be in the shadow directory, while the
|
|
source files in the shadow directory are just symlinks to the real
|
|
files.
|
|
<P>
|
|
|
|
This scheme has the advantage that if you update the source, you need not
|
|
propagate the change to the other architectures by hand, since all
|
|
source in all shadow directories are symlinks to the real thing: just cd
|
|
to the shadow directory and recompile away.
|
|
<P>
|
|
|
|
The
|
|
<I>todir</I>
|
|
|
|
argument is optional and defaults to the current directory. The
|
|
<I>fromdir</I>
|
|
|
|
argument may be relative (e.g., ../src) and is relative to
|
|
<I>todir</I>
|
|
|
|
(not the current directory).
|
|
<P>
|
|
|
|
|
|
Note that BitKeeper, CVS, CVS.adm, .git, .hg, RCS, SCCS, and .svn directories
|
|
are shadowed only if the <B>-withrevinfo</B> flag is specified.
|
|
Files with names ending in <I>~</I> are never shadowed.
|
|
<P>
|
|
|
|
If you add files, simply run
|
|
<I>lndir</I>
|
|
|
|
again. New files will be silently added. Old files will be
|
|
checked that they have the correct link.
|
|
<P>
|
|
|
|
Deleting files is a more painful problem; the symlinks will
|
|
just point into never never land.
|
|
<P>
|
|
|
|
If a file in <I>fromdir</I> is a symbolic link, <I>lndir</I> will make
|
|
the same link in <I>todir</I> rather than making a link back to the
|
|
(symbolic link) entry in <I>fromdir.</I> The <B>-ignorelinks</B> flag
|
|
changes this behavior.
|
|
<A NAME="lbAE"> </A>
|
|
<H2>OPTIONS</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="1">-silent<DD>
|
|
Normally <I>lndir</I> outputs the name of each subdirectory as it
|
|
descends into it. The <B>-silent</B> option suppresses these status
|
|
messages.
|
|
<DT id="2">-ignorelinks<DD>
|
|
Causes the program to not treat symbolic links in <I>fromdir</I>
|
|
specially. The link created in <I>todir</I> will point back to the
|
|
corresponding (symbolic link) file in <I>fromdir</I>.
|
|
If the link is to a directory, this is almost certainly the wrong thing.
|
|
<DT id="3"><DD>
|
|
This option exists mostly to emulate the behavior the C version of
|
|
<I>lndir</I> had in X11R6. Its use is not recommended.
|
|
<DT id="4">-withrevinfo<DD>
|
|
Causes any source control manager subdirectories
|
|
(those named BitKeeper, CVS, CVS.adm, .git, .hg, RCS, SCCS, or .svn)
|
|
to be treated as any other directory, rather than ignored.
|
|
</DL>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>DIAGNOSTICS</H2>
|
|
|
|
The program displays the name of each subdirectory it enters, followed
|
|
by a colon. The <B>-silent</B> option suppresses these messages.
|
|
<P>
|
|
|
|
A warning message is displayed if the symbolic link cannot be created.
|
|
The usual problem is that a regular file of the same name already
|
|
exists.
|
|
<P>
|
|
|
|
If the link already exists but doesn't point to the correct file, the
|
|
program prints the link name and the location where it does point.
|
|
<A NAME="lbAG"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+ln">ln</A></B>(1).
|
|
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="5"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="6"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="7"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="8"><A HREF="#lbAE">OPTIONS</A><DD>
|
|
<DT id="9"><A HREF="#lbAF">DIAGNOSTICS</A><DD>
|
|
<DT id="10"><A HREF="#lbAG">SEE ALSO</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:05:18 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|