package miou

Type of file-descriptors.

of_file_descr ?non_blocking ?owner fd creates a new file_descr. Depending on non_blocking (defaults to true), we set the given fd to non-blocking mode or not.

to_file_descr fd returns the real Unix.file_descr.

tcpv4 () allocates a new IPv4 socket.

tcpv6 () allocates a new IPv6 socket.

bind_and_listen fd sockaddr binds the given socket to the given sockaddr and set up the given fd for receiving connection requests. backlog is the maximal number of pending requests.

accept ?cloexec fd is a Miou friendly Unix.accept which returns file descritptors in non-blocking mode.

connect fd sockaddr is a Miou friendly Unix.connect. The function accepts only file_descrs in non-blocking mode.

read fd buf ~off ~len reads up to len bytes (defaults to Bytes.length buf - off from the given file-descriptor fd, storing them in byte sequence buf, starting at position off in buf (defaults to 0). It returns the actual number of characters read, between 0 and len (inclusive).

• raises Unix_error

  raised by the system call Unix.read. The function handles Unix.EINTR, Unix.EAGAIN and Unix.EWOULDBLOCK exceptions and redo the system call.

• raises Invalid_argument

  if off and len do not designate a valid range of buf

really_read fd buf ~off ~len reads len bytes (defaults to Bytes.length buf - off) from the given file-descriptor fd, storing them in byte sequence buf, starting at position off in buf (defaults to 0). If len = 0, really_read does nothing.

• raises Unix_error

  raised by the system call Unix.read. The function handles Unix.EINTR, Unix.EAGAIN and Unix.EWOULDBLOCK exceptions and redo the system call.

• raises End_of_file

  if Unix.read returns 0 before len characters have been read.

• raises Invalid_argument

  if off and len do not designate a valid range of buf

write fd str ~off ~len writes len bytes (defaults to String.length str - off) from byte sequence buf, starting at offset off (defaults to 0), to the given file-descriptor fd.

• raises Unix_error

  raised by the system call Unix.read. The function handles Unix.EINTR, Unix.EAGAIN and Unix.EWOULDBLOCK exceptions and redo the system call.

• raises Invalid_argument

  if off and len do not designate a valid range of buf

close fd closes properly the given fd.

sleep v suspends the current task and sleeps v seconds.