From 1e8b63eb887344ce2fe06b580eecbfba5a5be3dd Mon Sep 17 00:00:00 2001 From: Guido van Rossum Date: Wed, 26 Jun 1996 19:22:46 +0000 Subject: Document some process group stuff; mkdir mode arg optional; mkfifo. --- Doc/lib/libposix.tex | 56 +++++++++++++++++++++++++++++++++++++++++++++++++++- Doc/libposix.tex | 56 +++++++++++++++++++++++++++++++++++++++++++++++++++- 2 files changed, 110 insertions(+), 2 deletions(-) diff --git a/Doc/lib/libposix.tex b/Doc/lib/libposix.tex index 6696a28..bbb1b57 100644 --- a/Doc/lib/libposix.tex +++ b/Doc/lib/libposix.tex @@ -150,6 +150,11 @@ Return the current process's group id. (Not on MS-DOS.) \end{funcdesc} +\begin{funcdesc}{getpgrp}{} +Return the current process group id. +(Not on MS-DOS.) +\end{funcdesc} + \begin{funcdesc}{getpid}{} Return the current process id. (Not on MS-DOS.) @@ -194,8 +199,25 @@ Like \code{stat()}, but do not follow symbolic links. (On systems without symbolic links, this is identical to \code{posix.stat}.) \end{funcdesc} -\begin{funcdesc}{mkdir}{path\, mode} +\begin{funcdesc}{mkfifo}{path\optional{\, mode}} +Create a FIFO (a POSIX named pipe) named \var{path} with numeric mode +\var{mode}. The default \var{mode} is 0666 (octal). The current +umask value is first masked out from the mode. +(Not on MS-DOS.) + +FIFOs are pipes that can be accessed like regular files. FIFOs exist +until they are deleted (for example with \code{os.unlink}). +Generally, FIFOs are used as rendez-vous between ``client'' and +``server'' type processes: the server opens the FIFO for reading, and +the client opens it for writing. Note that \code{mkfifo()} doesn't +open the FIFO -- it just creates the rendez-vous point. +\end{funcdesc} + +\begin{funcdesc}{mkdir}{path\optional{\, mode}} Create a directory named \var{path} with numeric mode \var{mode}. +The default \var{mode} is 0777 (octal). On some systems, \var{mode} +is ignored. Where it is used, the current umask value is first +masked out. \end{funcdesc} \begin{funcdesc}{nice}{increment} @@ -263,6 +285,25 @@ Set the current process's group id. (Not on MS-DOS.) \end{funcdesc} +\begin{funcdesc}{setpgrp}{} +Calls the system call \code{setpgrp()} or \code{setpgrp(0, 0)} +depending on which version is implemented (if any). See the {\UNIX} +manual for the semantics. +(Not on MS-DOS.) +\end{funcdesc} + +\begin{funcdesc}{setpgid}{pid\, pgrp} +Calls the system call \code{setpgid()}. See the {\UNIX} manual for +the semantics. +(Not on MS-DOS.) +\end{funcdesc} + +\begin{funcdesc}{setsid}{} +Calls the system call \code{setsid()}. See the {\UNIX} manual for the +semantics. +(Not on MS-DOS.) +\end{funcdesc} + \begin{funcdesc}{setuid}{uid} Set the current process's user id. (Not on MS-DOS.) @@ -304,6 +345,19 @@ value is the exit status of the process as returned by Standard C \code{system()}. \end{funcdesc} +\begin{funcdesc}{tcgetpgrp}{fd} +Return the process group associated with the terminal given by +\var{fd} (an open file descriptor as returned by \code{posix.open()}). +(Not on MS-DOS.) +\end{funcdesc} + +\begin{funcdesc}{tcsetpgrp}{fd\, pg} +Set the process group associated with the terminal given by +\var{fd} (an open file descriptor as returned by \code{posix.open()}) +to \var{pg}. +(Not on MS-DOS.) +\end{funcdesc} + \begin{funcdesc}{times}{} Return a 5-tuple of floating point numbers indicating accumulated (CPU or other) diff --git a/Doc/libposix.tex b/Doc/libposix.tex index 6696a28..bbb1b57 100644 --- a/Doc/libposix.tex +++ b/Doc/libposix.tex @@ -150,6 +150,11 @@ Return the current process's group id. (Not on MS-DOS.) \end{funcdesc} +\begin{funcdesc}{getpgrp}{} +Return the current process group id. +(Not on MS-DOS.) +\end{funcdesc} + \begin{funcdesc}{getpid}{} Return the current process id. (Not on MS-DOS.) @@ -194,8 +199,25 @@ Like \code{stat()}, but do not follow symbolic links. (On systems without symbolic links, this is identical to \code{posix.stat}.) \end{funcdesc} -\begin{funcdesc}{mkdir}{path\, mode} +\begin{funcdesc}{mkfifo}{path\optional{\, mode}} +Create a FIFO (a POSIX named pipe) named \var{path} with numeric mode +\var{mode}. The default \var{mode} is 0666 (octal). The current +umask value is first masked out from the mode. +(Not on MS-DOS.) + +FIFOs are pipes that can be accessed like regular files. FIFOs exist +until they are deleted (for example with \code{os.unlink}). +Generally, FIFOs are used as rendez-vous between ``client'' and +``server'' type processes: the server opens the FIFO for reading, and +the client opens it for writing. Note that \code{mkfifo()} doesn't +open the FIFO -- it just creates the rendez-vous point. +\end{funcdesc} + +\begin{funcdesc}{mkdir}{path\optional{\, mode}} Create a directory named \var{path} with numeric mode \var{mode}. +The default \var{mode} is 0777 (octal). On some systems, \var{mode} +is ignored. Where it is used, the current umask value is first +masked out. \end{funcdesc} \begin{funcdesc}{nice}{increment} @@ -263,6 +285,25 @@ Set the current process's group id. (Not on MS-DOS.) \end{funcdesc} +\begin{funcdesc}{setpgrp}{} +Calls the system call \code{setpgrp()} or \code{setpgrp(0, 0)} +depending on which version is implemented (if any). See the {\UNIX} +manual for the semantics. +(Not on MS-DOS.) +\end{funcdesc} + +\begin{funcdesc}{setpgid}{pid\, pgrp} +Calls the system call \code{setpgid()}. See the {\UNIX} manual for +the semantics. +(Not on MS-DOS.) +\end{funcdesc} + +\begin{funcdesc}{setsid}{} +Calls the system call \code{setsid()}. See the {\UNIX} manual for the +semantics. +(Not on MS-DOS.) +\end{funcdesc} + \begin{funcdesc}{setuid}{uid} Set the current process's user id. (Not on MS-DOS.) @@ -304,6 +345,19 @@ value is the exit status of the process as returned by Standard C \code{system()}. \end{funcdesc} +\begin{funcdesc}{tcgetpgrp}{fd} +Return the process group associated with the terminal given by +\var{fd} (an open file descriptor as returned by \code{posix.open()}). +(Not on MS-DOS.) +\end{funcdesc} + +\begin{funcdesc}{tcsetpgrp}{fd\, pg} +Set the process group associated with the terminal given by +\var{fd} (an open file descriptor as returned by \code{posix.open()}) +to \var{pg}. +(Not on MS-DOS.) +\end{funcdesc} + \begin{funcdesc}{times}{} Return a 5-tuple of floating point numbers indicating accumulated (CPU or other) -- cgit v0.12