ChorusOS 5.0 Features and Architecture Overview

Network Libraries

This section describes the network libraries provided with the ChorusOS product.

RPC

The RPC library is compatible with Sun RPC, also known as ONC+. Extensions have been introduced into the library provided with the ChorusOS operating system, as well as into the Solaris operating environment, to support asynchronous communication.

The RPC library calls are available with the POSIX_SOCKETS feature. These calls support multithreaded applications. This feature is simply a library that might or might not be linked to an application. It is not a feature that can be turned on or off when configuring a system.

For details about RPC in the ChorusOS operating system, see RPC(5FEA).

LDAP

The Lightweight Directory Access Protocol (LDAP) provides access to X.500 directory services. These services can be a stand-alone part of a distributed directory service. Both synchronous and asynchronous APIs are provided. Also included are various routines to parse the results returned from these routines.

The basic interaction is as follows. Firstly, a session handle is created. The underlying session is established upon first use, which is commonly an LDAP bind operation. Next, other operations are performed by calling one of the synchronous or asynchronous search routines. Results returned from these routines are interpreted by calling the LDAP parsing routines. The LDAP association and underlying connection is then terminated. There are also APIs to interpret errors returned by LDAP server.

The LDAP API is summarized in the following table:

Function	Description
`ldap_add()`	Perform an LDAP adding operation
`ldap_init()`	Initialize the LDAP library
`ldap_open()`	Open a connection to an LDAP server
`ldap_get_values()`	Retrieve attribute values from an LDAP entry
`ldap_search_s()`	Perform synchronous LDAP search
`ldap_search_st()`	Perform synchronous LDAP search, with timeout
`ldap_abandon()`	Abandon an LDAP operation
`ldap_abandon_ext()`	Abandon an LDAP operation
`ldap_delete_ext()`	Perform an LDAP delete operation
`ldap_delete_ext_s()`	Perform an LDAP delete operation synchronously
`ldap_control_free()`	Dispose of a single control or an array of controls allocated by other LDAP APIs
`ldap_controls_free()`	Dispose of a single control or an array of controls allocated by other LDAP APIs
`ldap_extended_operation_s()`
`ldap_msgtype()`	Returns the type of an LDAP message
`ldap_msgid()`	Returns the ID of an LDAP message
`ldap_count_values()`	Count number of values in an array
`ldap_explode_dn()`	Takes a domain name (DN) as returned by `ldap_get_dn()` and breaks it into its component parts
`ldap_dn2ufn()`	Turn a DN as returned by `ldap_get_dn()` into a more user- friendly form
`ldap_explode_dns()`	Take a DNS-style DN and break it up into its component parts
`ldap_dns_to_dn()`	Converts a DNS domain name into an X.500 distinguished name
`ldap_value_free()`	Free an array of values
`ldap_is_dns_dn()`	Returns non-zero if the DN string is an experimental DNS-style DN
`ldap_explode_rdn()`	Breaks an RDN into its component parts
`ldap_bind()`	Perform an LDAP bind operation
`ldap_bind_s()`	Perform an LDAP bind operation synchronously
`ldap_simple_bind()`	Initiate asynchronous bind operation and return message ID of the request sent
`ldap_simple_bind_s()`	Initiate synchronous bind operation and return message ID of the request sent
`ldap_sasl_cram_md5_bind_s()`	General and extensible authentication over LDAP through the use of the Simple Authentication Security Layer (SASL)
`ldap_init()`	Allocates an LDAP structure but does not open an initial connection
`ldap_modify_ext_s()`	Perform an LDAP modify operation
`ldap_modrdn_s()`	Perform an LDAP modify RDN operation synchronously
`ldap_search()`	Perform LDAP search operations

For details, see the ldap(3LDAP) man page.

FTP

The FTP utility is the user interface to the ARPANET standard File Transfer Protocol. The program allows a user to transfer files to and from a remote network site.

The FTP API is summarized in the following table:

Function	Description
`ftpd()`	Internet File Transfer Protocol server
`ftpdStartSrv()`	Initializes FTP service
`ftpdHandleCnx()`	Manages an FTP connection
`lreply()`	Reply to an FTP client
`perror_reply()`	Reply to an FTP client
`reply()`	Reply to an FTP client
`ftpdGetCnx()`	Accepts a new FTP connection
`ftpdOob()`	Check for out-of-band data on the control connection

For details, see the ChorusOS man pages section 3FTPD: FTP Daemon Library.

Telnet

You can perform remote login operations on the ChorusOS operating system using the Telnet virtual terminal protocol. The Telnet API is summarized in the following table:

Function	Description
`inetAccept()`	Wait for a new INET connection
`inetBind()`	Bind, close INET sockets
`inetClient()`	Wait for a new INET connection
`inetClose()`	Bind, close INET socket
`telnetdFlush()`	Write or flush a Telnet session
`telnetdFree()`	Initialize or free a Telnet session
`telnetdGetTermState()`	Get or set Telnet terminal state
`telnetdInit()`	Initialize or free a Telnet session
`telnetdPasswd()`	Telnet session authentication
`telnetdRead()`	Read from a Telnet session
`telnetdReadLine()`	Read a line of characters from a Telnet session
`telnetdSetTermState()`	Get or set Telnet terminal state
`telnetdUser()`	Telnet session authentication
`telnetdWrite()`	Write or flush a Telnet session

See the ChorusOS man pages section 3TELD: Telnet Services.