/[guile]/guile/guile-core/doc/ref/posix.texi
ViewVC logotype

Diff of /guile/guile-core/doc/ref/posix.texi

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1.1.2.3 by ttn, Sun Nov 25 20:54:40 2001 UTC revision 1.1.2.4 by ttn, Tue Jan 8 09:22:36 2002 UTC
# Line 46  facility. Line 46  facility.
46  @item  @item
47  Underscores in Unix procedure names are converted to hyphens.  Underscores in Unix procedure names are converted to hyphens.
48  @item  @item
49  Procedures which destructively modify Scheme data have exclaimation  Procedures which destructively modify Scheme data have exclamation
50  marks appended, e.g., @code{recv!}.  marks appended, e.g., @code{recv!}.
51  @item  @item
52  Predicates (returning only @code{#t} or @code{#f}) have question marks  Predicates (returning only @code{#t} or @code{#f}) have question marks
# Line 116  environment. Line 116  environment.
116    
117  A file descriptor can be extracted from a port and a new port can be  A file descriptor can be extracted from a port and a new port can be
118  created from a file descriptor.  However a file descriptor is just an  created from a file descriptor.  However a file descriptor is just an
119  integer and the garbage collector doesn't recognise it as a reference  integer and the garbage collector doesn't recognize it as a reference
120  to the port.  If all other references to the port were dropped, then  to the port.  If all other references to the port were dropped, then
121  it's likely that the garbage collector would free the port, with the  it's likely that the garbage collector would free the port, with the
122  side-effect of closing the file descriptor prematurely.  side-effect of closing the file descriptor prematurely.
# Line 125  To assist the programmer in avoiding thi Line 125  To assist the programmer in avoiding thi
125  associated "revealed count" which can be used to keep track of how many  associated "revealed count" which can be used to keep track of how many
126  times the underlying file descriptor has been stored in other places.  times the underlying file descriptor has been stored in other places.
127  If a port's revealed count is greater than zero, the file descriptor  If a port's revealed count is greater than zero, the file descriptor
128  will not be closed when the port is gabage collected.  A programmer  will not be closed when the port is garbage collected.  A programmer
129  can therefore ensure that the revealed count will be greater than  can therefore ensure that the revealed count will be greater than
130  zero if the file descriptor is needed elsewhere.  zero if the file descriptor is needed elsewhere.
131    
# Line 384  used only during port creation are not r Line 384  used only during port creation are not r
384  except for those supplied as arguments.  This procedure  except for those supplied as arguments.  This procedure
385  was intended to be used before an exec call to close file descriptors  was intended to be used before an exec call to close file descriptors
386  which are not needed in the new process.  However it has the  which are not needed in the new process.  However it has the
387  undesirable side-effect of flushing buffes, so it's deprecated.  undesirable side-effect of flushing buffers, so it's deprecated.
388  Use port-for-each instead.  Use port-for-each instead.
389  @end deffn  @end deffn
390    
# Line 455  Don't block when locking.  May be specif Line 455  Don't block when locking.  May be specif
455  it to one of the other operations.  it to one of the other operations.
456  @end table  @end table
457  The return value is not specified. @var{file} may be an open  The return value is not specified. @var{file} may be an open
458  file descriptor or an open file descriptior port.  file descriptor or an open file descriptor port.
459  @end deffn  @end deffn
460    
461  @deffn primitive select reads writes excepts [secs [usecs]]  @deffn primitive select reads writes excepts [secs [usecs]]
462  This procedure has a variety of uses: waiting for the ability  This procedure has a variety of uses: waiting for the ability
463  to provide input, accept output, or the existance of  to provide input, accept output, or the existence of
464  exceptional conditions on a collection of ports or file  exceptional conditions on a collection of ports or file
465  descriptors, or waiting for a timeout to occur.  descriptors, or waiting for a timeout to occur.
466  It also returns if interrupted by a signal.  It also returns if interrupted by a signal.
# Line 751  component, @code{.} is returned. Line 751  component, @code{.} is returned.
751  @deffn primitive basename filename [suffix]  @deffn primitive basename filename [suffix]
752  Return the base name of the file name @var{filename}. The  Return the base name of the file name @var{filename}. The
753  base name is the file name without any directory components.  base name is the file name without any directory components.
754  If @var{suffix} is privided, and is equal to the end of  If @var{suffix} is provided, and is equal to the end of
755  @var{basename}, it is removed also.  @var{basename}, it is removed also.
756  @end deffn  @end deffn
757    
# Line 829  The encrypted group password. Line 829  The encrypted group password.
829  @item group:gid  @item group:gid
830  The group id number.  The group id number.
831  @item group:mem  @item group:mem
832  A list of userids which have this group as a supplimentary group.  A list of userids which have this group as a supplementary group.
833  @end table  @end table
834    
835  @deffn procedure getgrgid gid  @deffn procedure getgrgid gid
836  Look up an integer groupid in the group database.  Look up an integer group id in the group database.
837  @end deffn  @end deffn
838    
839  @deffn procedure getgrnam name  @deffn procedure getgrnam name
# Line 1095  Return the name of the current working d Line 1095  Return the name of the current working d
1095  @end deffn  @end deffn
1096    
1097  @deffn primitive umask [mode]  @deffn primitive umask [mode]
1098  If @var{mode} is omitted, retuns a decimal number representing the current  If @var{mode} is omitted, returns a decimal number representing the current
1099  file creation mask.  Otherwise the file creation mask is set to  file creation mask.  Otherwise the file creation mask is set to
1100  @var{mode} and the previous value is returned.  @var{mode} and the previous value is returned.
1101    
# Line 1116  Return an integer representing the curre Line 1116  Return an integer representing the curre
1116    
1117  @deffn primitive getgroups  @deffn primitive getgroups
1118  Return a vector of integers representing the current  Return a vector of integers representing the current
1119  supplimentary group IDs.  supplementary group IDs.
1120  @end deffn  @end deffn
1121    
1122  @deffn primitive getppid  @deffn primitive getppid
# Line 1278  is @var{status} if supplied, otherwise z Line 1278  is @var{status} if supplied, otherwise z
1278  @deffn primitive execl filename . args  @deffn primitive execl filename . args
1279  Executes the file named by @var{path} as a new process image.  Executes the file named by @var{path} as a new process image.
1280  The remaining arguments are supplied to the process; from a C program  The remaining arguments are supplied to the process; from a C program
1281  they are accessable as the @code{argv} argument to @code{main}.  they are accessible as the @code{argv} argument to @code{main}.
1282  Conventionally the first @var{arg} is the same as @var{path}.  Conventionally the first @var{arg} is the same as @var{path}.
1283  All arguments must be strings.  All arguments must be strings.
1284    
# Line 1964  The return value is unspecified. Line 1964  The return value is unspecified.
1964    
1965  @deffn primitive shutdown sock how  @deffn primitive shutdown sock how
1966  Sockets can be closed simply by using @code{close-port}. The  Sockets can be closed simply by using @code{close-port}. The
1967  @code{shutdown} procedure allows reception or tranmission on a  @code{shutdown} procedure allows reception or transmission on a
1968  connection to be shut down individually, according to the parameter  connection to be shut down individually, according to the parameter
1969  @var{how}:  @var{how}:
1970    
# Line 2101  number. Line 2101  number.
2101  @deffn primitive getsockname sock  @deffn primitive getsockname sock
2102  Return the address of @var{sock}, in the same form as the  Return the address of @var{sock}, in the same form as the
2103  object returned by @code{accept}.  On many systems the address  object returned by @code{accept}.  On many systems the address
2104  of a socket in the @code{AF_FILE} namespace cannot be read.  of a socket in the @code{AF_FILE} name space cannot be read.
2105  @end deffn  @end deffn
2106    
2107  @deffn primitive getpeername sock  @deffn primitive getpeername sock
2108  Return the address that @var{sock}  Return the address that @var{sock}
2109  is connected to, in the same form as the object returned by  is connected to, in the same form as the object returned by
2110  @code{accept}.  On many systems the address of a socket in the  @code{accept}.  On many systems the address of a socket in the
2111  @code{AF_FILE} namespace cannot be read.  @code{AF_FILE} name space cannot be read.
2112  @end deffn  @end deffn
2113    
2114  @deffn primitive recv! sock buf [flags]  @deffn primitive recv! sock buf [flags]
# Line 2305  specified locale category as a system-de Line 2305  specified locale category as a system-de
2305  Otherwise the specified locale category is set to the string  Otherwise the specified locale category is set to the string
2306  @var{locale} and the new value is returned as a  @var{locale} and the new value is returned as a
2307  system-dependent string.  If @var{locale} is an empty string,  system-dependent string.  If @var{locale} is an empty string,
2308  the locale will be set using envirionment variables.  the locale will be set using environment variables.
2309  @end deffn  @end deffn
2310    
2311  @node Encryption  @node Encryption

Legend:
Removed from v.1.1.2.3  
changed lines
  Added in v.1.1.2.4

savannah-hackers-public@gnu.org
ViewVC Help
Powered by ViewVC 1.1.26