/[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.4 by ttn, Sun Nov 25 20:53:19 2001 UTC revision 1.5 by ttn, Tue Jan 8 08:29:00 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 400  used only during port creation are not r Line 400  used only during port creation are not r
400  except for those supplied as arguments.  This procedure  except for those supplied as arguments.  This procedure
401  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
402  which are not needed in the new process.  However it has the  which are not needed in the new process.  However it has the
403  undesirable side-effect of flushing buffes, so it's deprecated.  undesirable side-effect of flushing buffers, so it's deprecated.
404  Use port-for-each instead.  Use port-for-each instead.
405  @end deffn  @end deffn
406    
# Line 475  Don't block when locking.  May be specif Line 475  Don't block when locking.  May be specif
475  it to one of the other operations.  it to one of the other operations.
476  @end table  @end table
477  The return value is not specified. @var{file} may be an open  The return value is not specified. @var{file} may be an open
478  file descriptor or an open file descriptior port.  file descriptor or an open file descriptor port.
479  @end deffn  @end deffn
480    
481  @deffn {Scheme Procedure} select reads writes excepts [secs [usecs]]  @deffn {Scheme Procedure} select reads writes excepts [secs [usecs]]
482  @deffnx {C Function} scm_select (reads, writes, excepts, secs, usecs)  @deffnx {C Function} scm_select (reads, writes, excepts, secs, usecs)
483  This procedure has a variety of uses: waiting for the ability  This procedure has a variety of uses: waiting for the ability
484  to provide input, accept output, or the existance of  to provide input, accept output, or the existence of
485  exceptional conditions on a collection of ports or file  exceptional conditions on a collection of ports or file
486  descriptors, or waiting for a timeout to occur.  descriptors, or waiting for a timeout to occur.
487  It also returns if interrupted by a signal.  It also returns if interrupted by a signal.
# Line 797  component, @code{.} is returned. Line 797  component, @code{.} is returned.
797  @deffnx {C Function} scm_basename (filename, suffix)  @deffnx {C Function} scm_basename (filename, suffix)
798  Return the base name of the file name @var{filename}. The  Return the base name of the file name @var{filename}. The
799  base name is the file name without any directory components.  base name is the file name without any directory components.
800  If @var{suffix} is privided, and is equal to the end of  If @var{suffix} is provided, and is equal to the end of
801  @var{basename}, it is removed also.  @var{basename}, it is removed also.
802  @end deffn  @end deffn
803    
# Line 877  The encrypted group password. Line 877  The encrypted group password.
877  @item group:gid  @item group:gid
878  The group id number.  The group id number.
879  @item group:mem  @item group:mem
880  A list of userids which have this group as a supplimentary group.  A list of userids which have this group as a supplementary group.
881  @end table  @end table
882    
883  @deffn {Scheme Procedure} getgrgid gid  @deffn {Scheme Procedure} getgrgid gid
884  Look up an integer groupid in the group database.  Look up an integer group id in the group database.
885  @end deffn  @end deffn
886    
887  @deffn {Scheme Procedure} getgrnam name  @deffn {Scheme Procedure} getgrnam name
# Line 1165  Return the name of the current working d Line 1165  Return the name of the current working d
1165    
1166  @deffn {Scheme Procedure} umask [mode]  @deffn {Scheme Procedure} umask [mode]
1167  @deffnx {C Function} scm_umask (mode)  @deffnx {C Function} scm_umask (mode)
1168  If @var{mode} is omitted, retuns a decimal number representing the current  If @var{mode} is omitted, returns a decimal number representing the current
1169  file creation mask.  Otherwise the file creation mask is set to  file creation mask.  Otherwise the file creation mask is set to
1170  @var{mode} and the previous value is returned.  @var{mode} and the previous value is returned.
1171    
# Line 1189  Return an integer representing the curre Line 1189  Return an integer representing the curre
1189  @deffn {Scheme Procedure} getgroups  @deffn {Scheme Procedure} getgroups
1190  @deffnx {C Function} scm_getgroups ()  @deffnx {C Function} scm_getgroups ()
1191  Return a vector of integers representing the current  Return a vector of integers representing the current
1192  supplimentary group IDs.  supplementary group IDs.
1193  @end deffn  @end deffn
1194    
1195  @deffn {Scheme Procedure} getppid  @deffn {Scheme Procedure} getppid
# Line 1370  is @var{status} if supplied, otherwise z Line 1370  is @var{status} if supplied, otherwise z
1370  @deffnx {C Function} scm_execl (filename, args)  @deffnx {C Function} scm_execl (filename, args)
1371  Executes the file named by @var{path} as a new process image.  Executes the file named by @var{path} as a new process image.
1372  The remaining arguments are supplied to the process; from a C program  The remaining arguments are supplied to the process; from a C program
1373  they are accessable as the @code{argv} argument to @code{main}.  they are accessible as the @code{argv} argument to @code{main}.
1374  Conventionally the first @var{arg} is the same as @var{path}.  Conventionally the first @var{arg} is the same as @var{path}.
1375  All arguments must be strings.  All arguments must be strings.
1376    
# Line 2097  The return value is unspecified. Line 2097  The return value is unspecified.
2097  @deffn {Scheme Procedure} shutdown sock how  @deffn {Scheme Procedure} shutdown sock how
2098  @deffnx {C Function} scm_shutdown (sock, how)  @deffnx {C Function} scm_shutdown (sock, how)
2099  Sockets can be closed simply by using @code{close-port}. The  Sockets can be closed simply by using @code{close-port}. The
2100  @code{shutdown} procedure allows reception or tranmission on a  @code{shutdown} procedure allows reception or transmission on a
2101  connection to be shut down individually, according to the parameter  connection to be shut down individually, according to the parameter
2102  @var{how}:  @var{how}:
2103    
# Line 2239  number. Line 2239  number.
2239  @deffnx {C Function} scm_getsockname (sock)  @deffnx {C Function} scm_getsockname (sock)
2240  Return the address of @var{sock}, in the same form as the  Return the address of @var{sock}, in the same form as the
2241  object returned by @code{accept}.  On many systems the address  object returned by @code{accept}.  On many systems the address
2242  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.
2243  @end deffn  @end deffn
2244    
2245  @deffn {Scheme Procedure} getpeername sock  @deffn {Scheme Procedure} getpeername sock
# Line 2247  of a socket in the @code{AF_FILE} namesp Line 2247  of a socket in the @code{AF_FILE} namesp
2247  Return the address that @var{sock}  Return the address that @var{sock}
2248  is connected to, in the same form as the object returned by  is connected to, in the same form as the object returned by
2249  @code{accept}.  On many systems the address of a socket in the  @code{accept}.  On many systems the address of a socket in the
2250  @code{AF_FILE} namespace cannot be read.  @code{AF_FILE} name space cannot be read.
2251  @end deffn  @end deffn
2252    
2253  @deffn {Scheme Procedure} recv! sock buf [flags]  @deffn {Scheme Procedure} recv! sock buf [flags]
# Line 2456  specified locale category as a system-de Line 2456  specified locale category as a system-de
2456  Otherwise the specified locale category is set to the string  Otherwise the specified locale category is set to the string
2457  @var{locale} and the new value is returned as a  @var{locale} and the new value is returned as a
2458  system-dependent string.  If @var{locale} is an empty string,  system-dependent string.  If @var{locale} is an empty string,
2459  the locale will be set using envirionment variables.  the locale will be set using environment variables.
2460  @end deffn  @end deffn
2461    
2462  @node Encryption  @node Encryption

Legend:
Removed from v.1.4  
changed lines
  Added in v.1.5

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