pkgsrc/doc/guide
jlam 2797f2c4fb Add two new capabilities to the pkginstall framework:
(1) Allow specifying the numeric UID and GID for users and groups in
    /etc/mk.conf by setting PKG_UID.<user> and PKG_GID.<group> to
    those values.  If these values are specified, then the +USERGROUP
    script will verify that existing users and groups match the
    requested UIDs and GIDs for the package, and otherwise create them
    with these UIDs and GIDs.  For example:

	PKG_UID.courier=	10001
	PKG_GID.mail=		6

    In this example, the courier-authlib binary package will be created
    to use uid 10001 for the "courier" user and gid 6 for the "mail"
    group.

(2) Allow a package to request that users and groups be created prior
    to configuring or building a package by setting USERGROUP_PHASE
    to "configure" or "build".  Because the reason for this is typically
    to hardcode the UIDs and GIDs of requested users and groups directly
    into the package's executables, these hardcoded values will be
    automatically determined and put into the +USERGROUP script.  For
    example:

	USERGROUP_PHASE=	configure

	PKG_GROUPS=	qmail nofiles
	PKG_USERS+=	qmaill:nofiles
	PKG_USERS+=	qmailq:qmail

    In this example, the users and groups are created before the
    configure phase when building qmail, and the qmail binary package's
    +INSTALL script will try to create (or verify) users and groups
    with the same UIDs and GIDs that were used during the build.

As part of these changes, the format for PKG_USERS and PKG_GROUPS has
changed -- the optional parts of the corresponding entries are no
longer used and cannot be specified.  Instead, the following variables
should be set:

        PKG_GID.<group> is the group's numeric GID.
        PKG_UID.<user> is the user's numeric UID.
        PKG_GECOS.<user> is the user's description.
        PKG_HOME.<user> is the user's home directory.
        PKG_SHELL.<user> is the user's login shell.

A separate commit will follow which will fix all packages that set
PKG_USERS and PKG_GROUPS to use the new syntax and variables.
2006-04-23 00:00:43 +00:00
..
files Add two new capabilities to the pkginstall framework: 2006-04-23 00:00:43 +00:00
DESCR
distinfo Sync with htdocs and add NetBSD.css so that "make install" works. 2006-01-14 17:18:31 +00:00
Makefile Sync with htdocs and add NetBSD.css so that "make install" works. 2006-01-14 17:18:31 +00:00
Makefile.common Change all instances of including mk/ghostscript.mk into asking for 2005-11-28 06:41:20 +00:00
PLIST
README Added a README file that describes where to get some basic information 2006-01-11 22:39:49 +00:00

$Id: README,v 1.1 2006/01/11 22:39:49 rillig Exp $

The pkgsrc guide is written in DocBook, which is an SGML schema for
writing technical documentation. A reference of the valid XML tags can
be found on the web site:

    http://www.docbook.org/tdg5/en/html/docbook.html