Document getgroups(), getlogin(), fpathconf(), pathconf(),

pathconf_names, confstr(), confstr_names, sysconf(), sysconf_names.

1 files changed, 107 insertions, 1 deletions

diff --git a/Doc/lib/libos.tex b/Doc/lib/libos.tex
index ef07b11..c03d0d9 100644
--- a/Doc/lib/libos.tex
+++ b/Doc/lib/libos.tex
@@ -130,6 +130,18 @@ Return the current process' group id.
 Availability: \UNIX{}.
 \end{funcdesc}
 
+\begin{funcdesc}{getgroups}{}
+Return list of supplemental group ids associated with the current
+process.
+Availability: \UNIX{}.
+\end{funcdesc}
+
+\begin{funcdesc}{getlogin}{}
+Return the actual login name for the current process, even if there
+are multiple login names which map to the same user id.
+Availability: \UNIX{}.
+\end{funcdesc}
+
 \begin{funcdesc}{getpgrp}{}
 \index{process!group}
 Return the current process group id.
@@ -290,6 +302,25 @@ first if necessary.
 Availability: \UNIX{}, Windows.
 \end{funcdesc}
 
+\begin{funcdesc}{fpathconf}{fd, name}
+Return system configration information relevant to an open file.
+\var{name} specifies the configuration value to retrieve; it may be a
+string which is the name of a defined system value; these names are
+specified in a number of standards (\POSIX.1, Unix95, Unix98, and
+others).  Some platforms define additional names as well.  The names
+known to the host operating system are given in the
+\code{pathconf_names} dictionary.  For configuration variables not
+included in that mapping, passing an integer for \var{name} is also
+accepted.
+Availability: \UNIX{}.
+
+If \var{name} is a string and is not known, \exception{ValueError} is
+raised.  If a specific value for \var{name} is not supported by the
+host system, even if it is included in \code{pathconf_names}, an
+\exception{OSError} is raised with \constant{errno.EINVAL} for the
+error number.
+\end{funcdesc}
+
 \begin{funcdesc}{fstat}{fd}
 Return status for file descriptor \var{fd}, like \function{stat()}.
 Availability: \UNIX{}, Windows.
@@ -490,6 +521,33 @@ is \code{0777} (octal).
 \versionadded{1.5.2}
 \end{funcdesc}
 
+\begin{funcdesc}{pathconf}{path, name}
+Return system configration information relevant to a named file.
+\var{name} specifies the configuration value to retrieve; it may be a
+string which is the name of a defined system value; these names are
+specified in a number of standards (\POSIX.1, Unix95, Unix98, and
+others).  Some platforms define additional names as well.  The names
+known to the host operating system are given in the
+\code{pathconf_names} dictionary.  For configuration variables not
+included in that mapping, passing an integer for \var{name} is also
+accepted.
+Availability: \UNIX{}.
+
+If \var{name} is a string and is not known, \exception{ValueError} is
+raised.  If a specific value for \var{name} is not supported by the
+host system, even if it is included in \code{pathconf_names}, an
+\exception{OSError} is raised with \constant{errno.EINVAL} for the
+error number.
+\end{funcdesc}
+
+\begin{datadesc}{pathconf_names}
+Dictionary mapping names accepted by \function{pathconf()} and
+\function{fpathconf()} to the integer values defined for those names
+by the host operating system.  This can be used to determine the set
+of names known to the system.
+Availability: \UNIX.
+\end{datadesc}
+
 \begin{funcdesc}{readlink}{path}
 Return a string representing the path to which the symbolic link
 points.
@@ -850,7 +908,55 @@ Availability: \UNIX{}.
 \end{funcdesc}
 
 
-\subsection{Miscellanenous System Data \label{os-path}}
+\subsection{Miscellanenous System Information \label{os-path}}
+
+
+\begin{funcdesc}{confstr}{name}
+Return string-valued system configuration values.
+\var{name} specifies the configuration value to retrieve; it may be a
+string which is the name of a defined system value; these names are
+specified in a number of standards (\POSIX, Unix95, Unix98, and
+others).  Some platforms define additional names as well.  The names
+known to the host operating system are given in the
+\code{confstr_names} dictionary.  For configuration variables not
+included in that mapping, passing an integer for \var{name} is also
+accepted.
+Availability: \UNIX{}.
+
+If the configuration value specified by \var{name} isn't defined, the
+empty string is returned.
+
+If \var{name} is a string and is not known, \exception{ValueError} is
+raised.  If a specific value for \var{name} is not supported by the
+host system, even if it is included in \code{confstr_names}, an
+\exception{OSError} is raised with \constant{errno.EINVAL} for the
+error number.
+\end{funcdesc}
+
+\begin{datadesc}{confstr_names}
+Dictionary mapping names accepted by \function{confstr()} to the
+integer values defined for those names by the host operating system.
+This can be used to determine the set of names known to the system.
+Availability: \UNIX.
+\end{datadesc}
+
+\begin{funcdesc}{sysconf}{name}
+Return integer-valued system configuration values.
+If the configuration value specified by \var{name} isn't defined,
+\code{-1} is returned.  The comments regarding the \var{name}
+parameter for \function{confstr()} apply here as well; the dictionary
+that provides information on the known names is given by
+\code{sysconf_names}.
+Availability: \UNIX{}.
+\end{funcdesc}
+
+\begin{datadesc}{sysconf_names}
+Dictionary mapping names accepted by \function{sysconf()} to the
+integer values defined for those names by the host operating system.
+This can be used to determine the set of names known to the system.
+Availability: \UNIX.
+\end{datadesc}
+
 
 The follow data values are used to support path manipulation
 operations.  These are defined for all platforms.