197 lines
4.8 KiB
HTML
197 lines
4.8 KiB
HTML
|
||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
||
<HTML><HEAD><TITLE>Man page of DH_LINK</TITLE>
|
||
</HEAD><BODY>
|
||
<H1>DH_LINK</H1>
|
||
Section: Debhelper (1)<BR>Updated: 2020-03-27<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>
|
||
|
||
dh_link - create symlinks in package build directories
|
||
<A NAME="lbAC"> </A>
|
||
<H2>SYNOPSIS</H2>
|
||
|
||
|
||
|
||
<B>dh_link</B> [<I>debhelper options</I>] [<B>-A</B>] [<B>-X</B><I>item</I>] [<I>source destination</I> ...]
|
||
<A NAME="lbAD"> </A>
|
||
<H2>DESCRIPTION</H2>
|
||
|
||
|
||
|
||
<B>dh_link</B> is a debhelper program that creates symlinks in package build
|
||
directories.
|
||
<P>
|
||
|
||
<B>dh_link</B> accepts a list of pairs of source and destination
|
||
files. The source files are the already existing files that will be
|
||
symlinked from (called <B>target</B> by <B><A HREF="/cgi-bin/man/man2html?1+ln">ln</A></B>(1)). The destination files
|
||
are the symlinks that will be created (called <B>link name</B> by
|
||
<B><A HREF="/cgi-bin/man/man2html?1+ln">ln</A></B>(1)). There <B>must</B> be an equal number of source and destination
|
||
files specified.
|
||
<P>
|
||
|
||
Be sure you <B>do</B> specify the absolute path to both the source and
|
||
destination files (unlike you would do if you were using something
|
||
like <B><A HREF="/cgi-bin/man/man2html?1+ln">ln</A></B>(1)). Please note that the leading slash is optional.
|
||
<P>
|
||
|
||
<B>dh_link</B> will generate symlinks that comply with Debian policy - absolute
|
||
when policy says they should be absolute, and relative links with as short
|
||
a path as possible. It will also create any subdirectories it needs to put
|
||
the symlinks in.
|
||
<P>
|
||
|
||
Any pre-existing destination files will be replaced with symlinks.
|
||
<P>
|
||
|
||
<B>dh_link</B> also scans the package build tree for existing symlinks which do not
|
||
conform to Debian policy, and corrects them (v4 or later).
|
||
<A NAME="lbAE"> </A>
|
||
<H2>FILES</H2>
|
||
|
||
|
||
|
||
<DL COMPACT>
|
||
<DT id="1">debian/<I>package</I>.links<DD>
|
||
|
||
|
||
Lists pairs of source and destination files to be symlinked. Each pair
|
||
should be put on its own line, with the source and destination separated by
|
||
whitespace.
|
||
|
||
|
||
<P>
|
||
|
||
|
||
In each pair the source file (called <B>target</B> by <B><A HREF="/cgi-bin/man/man2html?1+ln">ln</A></B>(1)) comes
|
||
first and is followed by the destination file (called <B>link name</B> by
|
||
<B><A HREF="/cgi-bin/man/man2html?1+ln">ln</A></B>(1)). Thus the pairs of source and destination files in each line
|
||
are given in the same order as they would be given to <B><A HREF="/cgi-bin/man/man2html?1+ln">ln</A></B>(1).
|
||
|
||
|
||
<P>
|
||
|
||
|
||
In contrast to <B><A HREF="/cgi-bin/man/man2html?1+ln">ln</A></B>(1), source and destination paths must be absolute
|
||
(the leading slash is optional).
|
||
|
||
|
||
<P>
|
||
|
||
|
||
Supports substitution variables in compat 13 and later as
|
||
documented in <B><A HREF="/cgi-bin/man/man2html?7+debhelper">debhelper</A></B>(7).
|
||
</DL>
|
||
<A NAME="lbAF"> </A>
|
||
<H2>OPTIONS</H2>
|
||
|
||
|
||
|
||
<DL COMPACT>
|
||
<DT id="2"><B>-A</B>, <B>--all</B><DD>
|
||
|
||
|
||
Create any links specified by command line parameters in <FONT SIZE="-1">ALL</FONT> packages
|
||
acted on, not just the first.
|
||
<DT id="3"><B>-X</B><I>item</I>, <B>--exclude=</B><I>item</I><DD>
|
||
|
||
|
||
Exclude symlinks that contain <I>item</I> anywhere in their filename from
|
||
being corrected to comply with Debian policy.
|
||
<DT id="4"><I>source destination</I> ...<DD>
|
||
|
||
|
||
Create a file named <I>destination</I> as a link to a file named <I>source</I>. Do
|
||
this in the package build directory of the first package acted on.
|
||
(Or in all packages if <B>-A</B> is specified.)
|
||
</DL>
|
||
<A NAME="lbAG"> </A>
|
||
<H2>EXAMPLES</H2>
|
||
|
||
|
||
|
||
|
||
|
||
<PRE>
|
||
dh_link usr/share/man/man1/foo.1 usr/share/man/man1/bar.1
|
||
|
||
</PRE>
|
||
|
||
|
||
<P>
|
||
|
||
Make <I>bar.1</I> be a symlink to <I>foo.1</I>
|
||
<P>
|
||
|
||
|
||
|
||
<PRE>
|
||
dh_link var/lib/foo usr/lib/foo \
|
||
usr/share/man/man1/foo.1 usr/share/man/man1/bar.1
|
||
|
||
</PRE>
|
||
|
||
|
||
<P>
|
||
|
||
Make <I>/usr/lib/foo/</I> be a link to <I>/var/lib/foo/</I>, and <I>bar.1</I> be a symlink to
|
||
the <I>foo.1</I>
|
||
<P>
|
||
|
||
|
||
|
||
<PRE>
|
||
var/lib/foo usr/lib/foo
|
||
usr/share/man/man1/foo.1 usr/share/man/man1/bar.1
|
||
|
||
</PRE>
|
||
|
||
|
||
<P>
|
||
|
||
Same as above but as content for a debian/<I>package</I>.links file.
|
||
<A NAME="lbAH"> </A>
|
||
<H2>SEE ALSO</H2>
|
||
|
||
|
||
|
||
<B><A HREF="/cgi-bin/man/man2html?7+debhelper">debhelper</A></B>(7)
|
||
<P>
|
||
|
||
This program is a part of debhelper.
|
||
<A NAME="lbAI"> </A>
|
||
<H2>AUTHOR</H2>
|
||
|
||
|
||
|
||
Joey Hess <<A HREF="mailto:joeyh@debian.org">joeyh@debian.org</A>>
|
||
<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">FILES</A><DD>
|
||
<DT id="9"><A HREF="#lbAF">OPTIONS</A><DD>
|
||
<DT id="10"><A HREF="#lbAG">EXAMPLES</A><DD>
|
||
<DT id="11"><A HREF="#lbAH">SEE ALSO</A><DD>
|
||
<DT id="12"><A HREF="#lbAI">AUTHOR</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:10 GMT, March 31, 2021
|
||
</BODY>
|
||
</HTML>
|