File Systems and I/O

  unix:uread stream [buffer] [size] [function]

• reads size bytes from stream. stream may either be a stream object or an integer representing fd. If buffer is given, the input is stored there. Otherwise, input goes to the buffer-string in stream. Therefore, if stream is fd, buffer must be given. unix:uread never allocates a new string buffer. unix:uread returns the byte count actually read.

  unix:write stream string &optional size [function]

• writes size bytes of string to stream. If size is omitted, the full length of string is output.

  unix:fcntl stream command argument [function]

  unix:ioctl stream command buffer [function]

  unix:ioctl_ stream command1 command2 [function]

  unix:ioctl_R stream command1 command2 buffer [size] [function]

  unix:ioctl_W stream command1 command2 buffer [size] [function]

  unix:ioctl_WR stream command1 command2 buffer [size] [function]

  unix:close fd [function]

• close a file specifying its file descriptor fd.

  unix:dup fd [function]

• returns the duplicated file descriptor for fd.

  unix:pipe [function]

• creates a pipe. An io-stream for this pipe is returned.

  unix:lseek stream position [whence 0] [function]

• sets the file pointer for stream at position counted from whence.

  unix:link path1 path2 [function]

• makes a hard link.

  unix:unlink path [function]

• removes a hard link to the file specified by path. If no reference to the file lefts, it is deleted.

  unix:mknod path mode [function]

• makes inode in a file system. path must be a string, not a pathname object.

  unix:access path mode [function]

• checks the access rights to path.

  unix:stat path [function]

• gets inode information of path and returns a list of integers described below.

  st_ctime	; file last status change time
  st_mtime	; file last modify time
  st_atime	; file last access time
  st_size	; total size of file, in bytes
  st_gid	; group ID of owne
  st_uid	; user ID of owner
  st_nlink	; number of hard links to the file
  st_rdev	; the device identifier (special files only)
  st_dev	; device file resides on
  st_ino	; the file serial number
  st_mode	; file mode

  unix:chdir path [function]

• changes the current working directory to path.

  unix:getwd [function]

• gets current working directory.

  unix:chmod path integer [function]

• changes access mode (permission) for path.

  unix:chown path integer [function]

• changes the owner of the file path.

  unix:isatty (stream | fd) [function]

• returns T if stream is connected to a tty-type device (a serial port or a pseudo tty) .

  unix:msgget key mode [function]

• creates or allocates a message queue which is addressed by key.

  unix:msgsnd qid buf [mtype [flag]] [function]

  unix:msgrcv qid buf [size [mtype [flag]]] [function]

  unix:socket domain type &optional proto [function]

• creates a socket whose name is defined in domain and whose abstract type is type. type should be one of 1 (SOCK_STREAM), 2 (SOCK_DGRAM), 3 (SOCK_RAW), 4 (SOCK_RDM) and 5 (SOCK_SEQPACKET).

  unix:bind socket name [function]

• associates name to socket. name should be a unix path-name if the socket is defined in unix-domain.

  unix:connect socket addr [function]

• connects socket to another socket specified by addr.

  unix:listen socket &optional backlog [function]

• begins to accept connection request on socket. backlog specifies the length of the queue waiting for the establishment of connection.

  unix:accept socket [function]

• accepts the connection request on socket and returns a file-descriptor on which messages can be exchanged bidirectionally.

  unix:recvfrom socket &optional mesg from flag [function]

• receives a datagram message from socket. The socket must be assigned a name by unix:bind. mesg is a string in which the incoming message will be stored. If mesg is given, recvfrom returns the number of bytes received. If it is omitted, a new string is created for the storage of the message and returned.

  unix:sendto socket addr mesg &optional len flag [function]

• sends a datagram message to another socket specified by addr. Socket must be a datagram-type socket which has no name assigned. Mesg is a string to be sent and len is the length of the message counting from the beginning of the string. If omitted, whole string is sent.

  unix:getservbyname servicename [function]

• returns the service number (integer) for servicename registered in /etc/services or in NIS database.

  unix:gethostbyname hostname [function]

• returns the list of ip address of hostname and its address type (currently always AF_INET==2).

  unix:syserrlist errno [function]

• returns a string describing the error information for the error code errno.