118 lines
3.4 KiB
HTML
118 lines
3.4 KiB
HTML
|
||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
||
<HTML><HEAD><TITLE>Man page of DH_USRLOCAL</TITLE>
|
||
</HEAD><BODY>
|
||
<H1>DH_USRLOCAL</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_usrlocal - migrate usr/local directories to maintainer scripts
|
||
<A NAME="lbAC"> </A>
|
||
<H2>SYNOPSIS</H2>
|
||
|
||
|
||
|
||
<B>dh_usrlocal</B> [<I>debhelper options</I>] [<B>-n</B>]
|
||
<A NAME="lbAD"> </A>
|
||
<H2>DESCRIPTION</H2>
|
||
|
||
|
||
|
||
<B>dh_usrlocal</B> is a debhelper program that can be used for building packages
|
||
that will provide a subdirectory in <I>/usr/local</I> when installed.
|
||
<P>
|
||
|
||
It finds subdirectories of <I>usr/local</I> in the package build directory, and
|
||
removes them, replacing them with maintainer script snippets (unless <B>-n</B>
|
||
is used) to create the directories at install time, and remove them when
|
||
the package is removed, in a manner compliant with Debian policy. These
|
||
snippets are inserted into the maintainer scripts by <B>dh_installdeb</B>. See
|
||
<B><A HREF="/cgi-bin/man/man2html?1+dh_installdeb">dh_installdeb</A></B>(1) for an explanation of debhelper maintainer script
|
||
snippets.
|
||
<P>
|
||
|
||
When the <I></I><FONT SIZE="-1"><I>DEB_RULES_REQUIRES_ROOT</I></FONT><I></I> environment variable is not (effectively)
|
||
<I>binary-targets</I>, the directories in <I>/usr/local</I> will be handled as if
|
||
they were owned by root:root (see below).
|
||
<P>
|
||
|
||
When the <I></I><FONT SIZE="-1"><I>DEB_RULES_REQUIRES_ROOT</I></FONT><I></I> environment variable has an effective value of
|
||
<I>binary-targets</I>, the owners, groups and permissions will be
|
||
preserved with the sole exception where the directory is owned by root:root.
|
||
<P>
|
||
|
||
If a directory is owned by root:root, then ownership will be determined
|
||
at install time. The ownership and permission bits will either be root:root
|
||
mode 0755 or root:staff mode 02775. The actual choice depends on whether
|
||
the system has <I>/etc/staff-group-for-usr-local</I> (as documented in the Debian
|
||
Policy Manual §9.1.2 since version 4.1.4)
|
||
<A NAME="lbAE"> </A>
|
||
<H2>OPTIONS</H2>
|
||
|
||
|
||
|
||
<DL COMPACT>
|
||
<DT id="1"><B>-n</B>, <B>--no-scripts</B><DD>
|
||
|
||
|
||
Do not modify <I>postinst</I>/<I>prerm</I> scripts.
|
||
</DL>
|
||
<A NAME="lbAF"> </A>
|
||
<H2>NOTES</H2>
|
||
|
||
|
||
|
||
Note that this command is not idempotent. <B><A HREF="/cgi-bin/man/man2html?1+dh_prep">dh_prep</A></B>(1) should be called
|
||
between invocations of this command. Otherwise, it may cause multiple
|
||
instances of the same text to be added to maintainer scripts.
|
||
<A NAME="lbAG"> </A>
|
||
<H2>CONFORMS TO</H2>
|
||
|
||
|
||
|
||
Debian policy, version 2.2
|
||
<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>
|
||
|
||
|
||
|
||
Andrew Stribblehill <<A HREF="mailto:ads@debian.org">ads@debian.org</A>>
|
||
<P>
|
||
|
||
<HR>
|
||
<A NAME="index"> </A><H2>Index</H2>
|
||
<DL>
|
||
<DT id="2"><A HREF="#lbAB">NAME</A><DD>
|
||
<DT id="3"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
||
<DT id="4"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
||
<DT id="5"><A HREF="#lbAE">OPTIONS</A><DD>
|
||
<DT id="6"><A HREF="#lbAF">NOTES</A><DD>
|
||
<DT id="7"><A HREF="#lbAG">CONFORMS TO</A><DD>
|
||
<DT id="8"><A HREF="#lbAH">SEE ALSO</A><DD>
|
||
<DT id="9"><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:11 GMT, March 31, 2021
|
||
</BODY>
|
||
</HTML>
|