os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

- Update section on adding users and groups to new USERS/GROUPS variables

Browse source 
- Move to Section 6 Special considerations
This commit is contained in:
Pav Lucistnik 2009-12-03 13:54:47 +00:00
parent 51fc314125
commit e55b980f53
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=35018
1 changed files with 27 additions and 24 deletions

51
en_US.ISO8859-1/books/porters-handbook/book.sgml
View file

@ -8517,6 +8517,33 @@ run_rc_command "$1"</programlisting>
<makevar>USE_RC_SUBR</makevar> variable.</para>
</sect2>
</sect1>
<sect1 id="users-and-groups">
<title>Adding users and groups</title>
<para>Some ports require a certain user to be on the installed
system. Choose a free UID from 50 to 999 and register it either in
<filename>ports/UIDs</filename> (for users) or in
<filename>ports/GIDs</filename> (for groups). Make sure you do not
use a UID already used by the system or other ports.</para>
<para>Please include a patch against these two files when you
require a new user or group to be created for your
port.</para>
<para>Then you can use <makevar>USERS</makevar> and <makevar>GROUPS</makevar>
variables in your <filename>Makefile</filename>, and the user
will be automatically created when installing the port.</para>
<programlisting>USERS= pulse
GROUPS= pulse pulse-access pulse-rt</programlisting>
<para>The current list of reserved UIDs and GIDs can be found
in <filename>ports/UIDs</filename> and
<filename>ports/GIDs</filename>.</para>
</sect1>
</chapter>
<chapter id="plist">
@ -13569,30 +13596,6 @@ exec %%LOCALBASE%%/bin/java -jar %%DATADIR%%/foo.jar "$@"</programlisting>
</sect1>
<sect1 id="dads-uid-and-gids">
<title>UIDs and GIDs</title>
<para>The current list of reserved UIDs and GIDs can be found
in <filename>ports/UIDs</filename> and
<filename>ports/GIDs</filename>.</para>
<para>If your port requires a certain user to be on the installed
system, let the <filename>pkg-install</filename> script call
<command>pw</command> to create it automatically. Look at
<filename role="package">sysutils/symon</filename> for an example.
Your port must use a fixed user/group ID number. You must
choose a free UID from 50 to 999 and register it either in
<filename>ports/UIDs</filename> (for users) or in
<filename>ports/GIDs</filename> (for groups).</para>
<para>Make sure you do not use a UID already used by the system or
other ports.</para>
<para>Please include a patch against these two files when you
require a new user or group to be created for your
port.</para>
</sect1>
<sect1 id="dads-rational">
<title>Do things rationally</title>