man-pages/man1/dh_usrlocal.1.html
2021-03-31 01:06:50 +01:00

118 lines
3.4 KiB
HTML
Raw Permalink Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!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">&nbsp;</A>
<H2>NAME</H2>
dh_usrlocal - migrate usr/local directories to maintainer scripts
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<B>dh_usrlocal</B> [<I>debhelper options</I>] [<B>-n</B>]
<A NAME="lbAD">&nbsp;</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">&nbsp;</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">&nbsp;</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">&nbsp;</A>
<H2>CONFORMS TO</H2>
Debian policy, version 2.2
<A NAME="lbAH">&nbsp;</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">&nbsp;</A>
<H2>AUTHOR</H2>
Andrew Stribblehill &lt;<A HREF="mailto:ads@debian.org">ads@debian.org</A>&gt;
<P>
<HR>
<A NAME="index">&nbsp;</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>