DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

(guile.info.gz) User Information

Info Catalog (guile.info.gz) File System (guile.info.gz) POSIX (guile.info.gz) Time
 
 38.4 User Information
 =====================
 
 The facilities in this section provide an interface to the user and
 group database.  They should be used with care since they are not
 reentrant.
 
    The following functions accept an object representing user
 information and return a selected component:
 
 `passwd:name'
      The name of the userid.
 
 `passwd:passwd'
      The encrypted passwd.
 
 `passwd:uid'
      The user id number.
 
 `passwd:gid'
      The group id number.
 
 `passwd:gecos'
      The full name.
 
 `passwd:dir'
      The home directory.
 
 `passwd:shell'
      The login shell.
 
  -- Scheme Procedure: getpwuid uid
      Look up an integer userid in the user database.
 
  -- Scheme Procedure: getpwnam name
      Look up a user name string in the user database.
 
  -- Scheme Procedure: setpwent
      Initializes a stream used by `getpwent' to read from the user
      database.  The next use of `getpwent' will return the first entry.
      The return value is unspecified.
 
  -- Scheme Procedure: getpwent
      Return the next entry in the user database, using the stream set by
      `setpwent'.
 
  -- Scheme Procedure: endpwent
      Closes the stream used by `getpwent'.  The return value is
      unspecified.
 
  -- Scheme Procedure: setpw [arg]
  -- C Function: scm_setpwent (arg)
      If called with a true argument, initialize or reset the password
      data stream.  Otherwise, close the stream.  The `setpwent' and
      `endpwent' procedures are implemented on top of this.
 
  -- Scheme Procedure: getpw [user]
  -- C Function: scm_getpwuid (user)
      Look up an entry in the user database.  OBJ can be an integer, a
      string, or omitted, giving the behaviour of getpwuid, getpwnam or
      getpwent respectively.
 
    The following functions accept an object representing group
 information and return a selected component:
 
 `group:name'
      The group name.
 
 `group:passwd'
      The encrypted group password.
 
 `group:gid'
      The group id number.
 
 `group:mem'
      A list of userids which have this group as a supplementary group.
 
  -- Scheme Procedure: getgrgid gid
      Look up an integer group id in the group database.
 
  -- Scheme Procedure: getgrnam name
      Look up a group name in the group database.
 
  -- Scheme Procedure: setgrent
      Initializes a stream used by `getgrent' to read from the group
      database.  The next use of `getgrent' will return the first entry.
      The return value is unspecified.
 
  -- Scheme Procedure: getgrent
      Return the next entry in the group database, using the stream set
      by `setgrent'.
 
  -- Scheme Procedure: endgrent
      Closes the stream used by `getgrent'.  The return value is
      unspecified.
 
  -- Scheme Procedure: setgr [arg]
  -- C Function: scm_setgrent (arg)
      If called with a true argument, initialize or reset the group data
      stream.  Otherwise, close the stream.  The `setgrent' and
      `endgrent' procedures are implemented on top of this.
 
  -- Scheme Procedure: getgr [name]
  -- C Function: scm_getgrgid (name)
      Look up an entry in the group database.  OBJ can be an integer, a
      string, or omitted, giving the behaviour of getgrgid, getgrnam or
      getgrent respectively.
 
    In addition to the accessor procedures for the user database, the
 following shortcut procedures are also available.
 
  -- Scheme Procedure: cuserid
  -- C Function: scm_cuserid ()
      Return a string containing a user name associated with the
      effective user id of the process.  Return `#f' if this information
      cannot be obtained.
 
  -- Scheme Procedure: getlogin
  -- C Function: scm_getlogin ()
      Return a string containing the name of the user logged in on the
      controlling terminal of the process, or `#f' if this information
      cannot be obtained.
 
Info Catalog (guile.info.gz) File System (guile.info.gz) POSIX (guile.info.gz) Time
automatically generated byinfo2html