From owner-freebsd-doc@FreeBSD.ORG Tue Jan 20 06:47:48 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 4B01C16A4CE; Tue, 20 Jan 2004 06:47:48 -0800 (PST) Received: from arthur.nitro.dk (port324.ds1-khk.adsl.cybercity.dk [212.242.113.79]) by mx1.FreeBSD.org (Postfix) with ESMTP id 6E13E43D46; Tue, 20 Jan 2004 06:46:30 -0800 (PST) (envelope-from simon@arthur.nitro.dk) Received: by arthur.nitro.dk (Postfix, from userid 3000) id 2251611858; Tue, 20 Jan 2004 15:46:29 +0100 (CET) Date: Tue, 20 Jan 2004 15:46:29 +0100 From: "Simon L. Nielsen" To: Ceri Davies , Lukas Ertl , Marc Fonvieille , freebsd-doc@freebsd.org Message-ID: <20040120144627.GH686@arthur.nitro.dk> References: <200401201340.i0KDePlc030253@freefall.freebsd.org> <20040120144344.G90355@pcle2.cc.univie.ac.at> <20040120141101.GJ47004@submonkey.net> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="TeJTyD9hb8KJN2Jy" Content-Disposition: inline In-Reply-To: <20040120141101.GJ47004@submonkey.net> User-Agent: Mutt/1.5.5.1i Subject: Re: docs/61625: Wrong maximal UID and GID in Handbook, section 8.2 X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 20 Jan 2004 14:47:48 -0000 --TeJTyD9hb8KJN2Jy Content-Type: multipart/mixed; boundary="vmttodhTwj0NAgWp" Content-Disposition: inline --vmttodhTwj0NAgWp Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On 2004.01.20 14:11:01 +0000, Ceri Davies wrote: > On Tue, Jan 20, 2004 at 02:45:09PM +0100, Lukas Ertl wrote: > > On Tue, 20 Jan 2004, Marc Fonvieille wrote: > >=20 > > > The following reply was made to PR docs/61625; it has been noted by G= NATS. > > > > > > From: Marc Fonvieille > > > To: Marian Cerny > > > Cc: freebsd-gnats-submit@FreeBSD.org > > > Subject: Re: docs/61625: Wrong maximal UID and GID in Handbook, secti= on 8.2 > > > Date: Tue, 20 Jan 2004 14:36:13 +0100 > > > > > > On Tue, Jan 20, 2004 at 05:09:23AM -0800, Marian Cerny wrote: > > > > >Description: > > > > In section 8.2 Introduction is written: > > > > The UID is a number from 0 to 65536 used to ... > > > > The GID is a number from 0 to 65536 used to ... > > > > > > > > By adding a line to passwd (using vipw): > > > > test::65536:65536::0:0:test:/:/sbin/nologin > > > > > > > > I get this as a response: > > > > pwd_mkdb: 65536 > recommended max uid value (65535) > > > > pwd_mkdb: 65536 > recommended max gid value (65535) > > > > > > You forgot to add the line: > > > vipw: done > > > > > > It's just a warning cause some programs may want short IDs/GIDs. > > > However maybe we should say "The UID is, by default, a number from 0 > > > to 65535..." > >=20 > > Actually, the UID can be much larger, since it's defined as a 32bit > > unsigned int (on x86). >=20 > This is already documented in pwd_mkdb(8). Search for PW_SCAN_BIG_IDS, > which will make these warnings go away when set in the environment. How about the attached patch? This is an introduction section/chapter, so I don't think there should be too many details, since it's not relevant to most people anyway. The warning is more or less copy/pasted from pwd_mkdb(8). --=20 Simon L. Nielsen FreeBSD Documentation Team --vmttodhTwj0NAgWp Content-Type: text/plain; charset=us-ascii Content-Disposition: attachment; filename="doc-uidgid-large.patch" Content-Transfer-Encoding: quoted-printable Index: chapter.sgml =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/handbook/users/chapter.sgml,v retrieving revision 1.40 diff -u -r1.40 chapter.sgml --- chapter.sgml 20 Jan 2004 13:39:52 -0000 1.40 +++ chapter.sgml 20 Jan 2004 14:30:44 -0000 @@ -113,7 +113,11 @@ User ID (UID) =20 - The UID is a number from 0 to 65535 used to uniquely identify + The UID is a number, traditionally from 0 to 65535 + It is possible to use larger UID/GID's, but such + IDs can cause serious problems with software that + makes assumptions about the values of IDs. + , used to uniquely identify the user to the system. Internally, FreeBSD uses the UID to identify users—any FreeBSD commands that allow you to specify a user name will convert it to the UID before working with @@ -128,7 +132,7 @@ Group ID (GID) =20 - The GID is a number from 0 to 65535 used to uniquely identify + The GID is a number, traditionally from 0 to 65535, used to uniquely identify the primary group that the user belongs to. Groups are a mechanism for controlling access to resources based on a user's GID rather than their UID. This can significantly reduce the size --vmttodhTwj0NAgWp-- --TeJTyD9hb8KJN2Jy Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.3 (FreeBSD) iD8DBQFADT9Dh9pcDSc1mlERAvrDAJ9YiNn2kLMD9v+iiR2JhIFonruuyQCgvK4F 93WGXy6CxyF1waoruxCUV8E= =QhR5 -----END PGP SIGNATURE----- --TeJTyD9hb8KJN2Jy--