[Python-checkins] CVS: python/dist/src/Doc/lib libgrp.tex,1.13,1.13.4.1 libpwd.tex,1.11,1.11.4.1

Fred L. Drake fdrake@weyr.cnri.reston.va.us
Wed, 16 Feb 2000 12:17:03 -0500 (EST)


Update of /projects/cvsroot/python/dist/src/Doc/lib
In directory weyr:/home/fdrake/projects/python/Doc-152p1/lib

Modified Files:
      Tag: release152p1-patches
	libgrp.tex libpwd.tex 
Log Message:

Improved descriptions and added cross-references from Peter Funk
<pf@artcom-gmbh.de>.  Includes limited markup changes by FLD.


Index: libgrp.tex
===================================================================
RCS file: /projects/cvsroot/python/dist/src/Doc/lib/libgrp.tex,v
retrieving revision 1.13
retrieving revision 1.13.4.1
diff -C2 -r1.13 -r1.13.4.1
*** libgrp.tex	1999/03/02 17:03:37	1.13
--- libgrp.tex	2000/02/16 17:16:59	1.13.4.1
***************
*** 12,19 ****
  Group database entries are reported as 4-tuples containing the
  following items from the group database (see \code{<grp.h>}), in order:
! \code{gr_name},
! \code{gr_passwd},
! \code{gr_gid},
! \code{gr_mem}.
  The gid is an integer, name and password are strings, and the member
  list is a list of strings.
--- 12,23 ----
  Group database entries are reported as 4-tuples containing the
  following items from the group database (see \code{<grp.h>}), in order:
! 
! \begin{tableiii}{r|l|l}{textrm}{Index}{Field}{Meaning}
!   \lineiii{0}{gr_name}{the name of the group}
!   \lineiii{1}{gr_passwd}{the (encrypted) group password; often empty}
!   \lineiii{2}{gr_gid}{the numerical group ID}
!   \lineiii{3}{gr_mem}{all the group member's  user  names}
! \end{tableiii}
! 
  The gid is an integer, name and password are strings, and the member
  list is a list of strings.
***************
*** 35,36 ****
--- 39,45 ----
  Return a list of all available group entries, in arbitrary order.
  \end{funcdesc}
+ 
+ 
+ \begin{seealso}
+   \seemodule{pwd}{An interface to the user database, similar to this.}
+ \end{seealso}

Index: libpwd.tex
===================================================================
RCS file: /projects/cvsroot/python/dist/src/Doc/lib/libpwd.tex,v
retrieving revision 1.11
retrieving revision 1.11.4.1
diff -C2 -r1.11 -r1.11.4.1
*** libpwd.tex	1999/03/02 17:03:39	1.11
--- libpwd.tex	2000/02/16 17:17:00	1.11.4.1
***************
*** 6,24 ****
  \modulesynopsis{The password database (\function{getpwnam()} and friends).}
  
! This module provides access to the \UNIX{} password database.
! It is available on all \UNIX{} versions.
  
  Password database entries are reported as 7-tuples containing the
  following items from the password database (see \code{<pwd.h>}), in order:
! \code{pw_name},
! \code{pw_passwd},
! \code{pw_uid},
! \code{pw_gid},
! \code{pw_gecos},
! \code{pw_dir},
! \code{pw_shell}.
  The uid and gid items are integers, all others are strings.
  \exception{KeyError} is raised if the entry asked for cannot be found.
  
  It defines the following items:
  
--- 6,36 ----
  \modulesynopsis{The password database (\function{getpwnam()} and friends).}
  
! This module provides access to the \UNIX{} user account and password
! database.  It is available on all \UNIX{} versions.
  
  Password database entries are reported as 7-tuples containing the
  following items from the password database (see \code{<pwd.h>}), in order:
! 
! \begin{tableiii}{r|l|l}{textrm}{Index}{Field}{Meaning}
!   \lineiii{0}{\code{pw_name}}{Login name}
!   \lineiii{1}{\code{pw_passwd}}{Optional encrypted password}
!   \lineiii{2}{\code{pw_uid}}{Numerical user ID}
!   \lineiii{3}{\code{pw_gid}}{Numerical group ID}
!   \lineiii{4}{\code{pw_gecos}}{User name or comment field}
!   \lineiii{5}{\code{pw_dir}}{User home directory}
!   \lineiii{6}{\code{pw_shell}}{User command interpreter}
! \end{tableiii}
! 
  The uid and gid items are integers, all others are strings.
  \exception{KeyError} is raised if the entry asked for cannot be found.
  
+ \strong{Note:} In traditional \UNIX{} the field \code{pw_passwd} usually
+ contains a password encrypted with a DES derived algorithm (see module
+ \refmodule{crypt}\refbimodindex{crypt}).  However most modern unices 
+ use a so-called \emph{shadow password} system.  On those unices the
+ field \code{pw_passwd} only contains a asterisk (\code{'*'}) or the 
+ letter \character{x} where the encrypted password is stored in a file
+ \file{/etc/shadow} which is not world readable.
+ 
  It defines the following items:
  
***************
*** 34,35 ****
--- 46,52 ----
  Return a list of all available password database entries, in arbitrary order.
  \end{funcdesc}
+ 
+ 
+ \begin{seealso}
+   \seemodule{grp}{An interface to the group database, similar to this.}
+ \end{seealso}