Network access functions

These functions provide a layer of indirection between the TCP routines and upper level routines. This makes it possible to insert additional code (for example, privacy or checksum handling).

• net_open

  NETSTREAM *net_open(char *host, char *service, unsigned long port);
  

  
  host

  Host name.

  
  service

  Contact service name.

  
  port

  Contact port number.

  This function opens a TCP connection to the given host and service or port.

• net_aopen

  NETSTREAM *net_aopen(NETMBX *mb, char *service, char *usrbuf);
  

  
  mb

  Parsed mailbox specification.

  
  service

  Stream to open (at present, only /etc/rimapd is used).

  
  usrbuf

  Buffer to return login user name.

  This function attempts to open a preauthenticated connection to the given mailbox and service. It will return the login user name of the preauthenticated connection, as well as an open network stream, if successful.

• net_getline

  char *net_getline(NETSTREAM *stream);
  

  
  stream

  Network stream to read.

  This routine reads a text line from the stream. It calls stream->dtb->getline, which normally points to tcp_getline, but can be set to some other function.

• net_getbuffer

  long net_getbuffer(void *stream, unsigned long size, char *buffer);
  

  
  stream

  Network stream to read.

  
  size

  Length of data in octets.

  
  buffer

  Buffer of at least size octets.

  This routine reads data from the stream. It calls stream->dtb->getbuffer, which normally points to tcp_getbuffer, but can be set to some other function.

• net_soutr

  long net_soutr(NETSTREAM *stream, char *string);
  

  
  stream

  Network stream to write.

  
  string

  Null-terminated string to output.

  This routine writes a null-terminated string to the stream. It calls stream->dtb->soutr, which normally points to tcp_soutr, but can be set to some other function.

• net_sout

  long net_sout(NETSTREAM *stream, char *string, unsigned long size);
  

  
  stream

  Network stream to write.

  
  string

  String to output.

  
  size

  Length of string in octets.

  This routine writes a string of length size to the stream. It calls stream->dtb->sout, which normally points to tcp_sout, but can be set to some other function.

• net_close

  void net_close(NETSTREAM *stream);
  

  
  stream

  Stream to close.

  This routine closes the stream. It calls stream->dtb->close, which normally points to tcp_close, but can point to some other function.

• net_host

  char *net_host(NETSTREAM *stream);
  

  
  stream

  Stream to inspect.

  This routine returns the remote host name of the stream. It calls stream->dtb->host, which normally points to tcp_host, but can point to some other function.

• net_port

  unsigned long net_port(NETSTREAM *stream);
  

  
  stream

  Stream to inspect.

  This routine returns the remote port number of the stream. It calls stream->dtb->port, which normally points to tcp_port, but can point to some other function.

• net_localhost

  char *net_localhost(NETSTREAM *stream);
  

  
  stream

  Stream to inspect.

  This routine returns the local host name of the stream. It calls stream->dtb->localhost, which normally points to tcp_localhost, but can point to some other function.