diff --git a/en_US.ISO8859-1/books/porters-handbook/book.sgml b/en_US.ISO8859-1/books/porters-handbook/book.sgml index 674fd081ff..dcbff231b9 100644 --- a/en_US.ISO8859-1/books/porters-handbook/book.sgml +++ b/en_US.ISO8859-1/books/porters-handbook/book.sgml @@ -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>