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 |
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. |
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 |
|
|
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 |
|
|
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. |
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 |
|
|
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 |
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 |
|
|
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 |
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 |
|
|
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 |
|
|
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 |
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] |
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 |