ChorusOS 5.0 Features and Architecture Overview

Administration

The administration facilities available in the ChorusOS operating system mostly consist of a set of commands activated in three different ways:

Through a remote execution mechanism based on the remote shell feature
Through a local command interpreter mechanism known as the LOCAL_CONSOLE feature
At system start-up time, using the sysadm.ini file that can be embedded into the system image

Command Interpreter

In the ChorusOS operating system, commands are interpreted by the C_INIT actor. The C_INIT is loaded when the system is started and is not invoked by a user, but by the ChorusOS operating system. The C_INIT actor is also responsible for authentication of users that issue C_INIT commands.

For details, see the C_INIT(1M) man page.

The C_INIT actor offers the following options:

Remote shell
Local console

Remote Shell

The remote shell (RSH) feature gives access to C_INIT commands. When this feature is set, the C_INIT command rshd starts the rsh daemon. The rshd daemon is usually run from the end of the sysadm.ini file. It can also be run from the local console if it is available.

The RSH feature affects the configuration of the C_INIT actor. When configured, it starts running the C_INIT command interpreter in an rsh daemon thread on the target system forever. This allows a ChorusOS operating system to be administered from a host without needing to access the local console of the target system. This feature is not exclusive to the C_INIT LOCAL_CONSOLE feature. Both can be set, enabling the C_INIT command interpreter to be accessed either locally or remotely through the rsh protocol simultaneously.

See the RSH(5FEA) man page for details.

Remote Shell API

The RSH feature does not have its own API. All commands defined by C_INIT can be typed in on the target console. It is accessed from the host using the standard rsh protocol.

Local Console

This feature gives access to C_INIT commands through the local console of the target. When this feature is set, the C_INIT console command starts the command interpreter on the local console. The console command is usually run at the end of the sysadm.ini file. It can also be run through rsh if it is available.

See the LOCAL_CONSOLE(5FEA) man page for details.

Local Console API

The LOCAL_CONSOLE feature does not have its own API.

The `sysadm.ini` File

When the system is started, once all system components have initialized, the C_INIT component looks for a file named /etc/sysadm.ini in the embedded file system boot image. This script file is executed as the last step of the system initialization and you can customize it to run selected applications directly upon system start-up. The most usual tasks performed by sysadm.ini are as follows:

Creating appropriate device entries in the /dev directory
Parsing the device tree of the system and associating actual devices to correlated /dev entries
Initializing the network interface, for example, to use DHCP or ifconfig
Mounting local or remote file systems, or both
Starting the local console command interpreter or the remote command interpreter, or both

System Administration Commands

The ChorusOS operating system offers a range of commands for system administration, which can be accessed via the command interpreter or included in the sysadm.ini file.

Command	Description
`akill`	Kills an actor
`aps`	Displays the list of all actors running on the target system
`arp`	Address resolution display and control
`arun`	Runs `actor_name` on the target system
`chat`	Automated conversational script with a modem
`chorusNSinet`	ChorusOS name servers
`chorusNSsite`	ChorusOS name servers
`chorusStat`	Print information about ChorusOS resources
`configurator`	ChorusOS configuration utility
`console`	Starts a command interpreter on the console of the target system
`cp`	Copy files
`cs`	Report the status of ChorusOS resources
`date`	Print and set the date
`dd`	Convert and copy a file
`df`	Display free disk space
`dhclient`	Dynamic Host Configuration Protocol client
`disklabel`	Read and write disk pack label
`domainname`	Set or display the name of the current YP/NIS domain
`dtree`	Displays all connected devices in the target device tree
`echo`	Echoes arguments to standard output
`env`	Displays the current environment
`ethIpcStackAttach`	Attaches the IPC stack to an Ethernet device
`flashdefrag`	Defragment a flash memory device
`format`	Format a Flash memory device
`fsck`	File system consistency check and interactive repair
`fsck_dos`	Create an MS-DOS (FAT) file system
`ftp`	ARPANET file transfer program
`ftpd`	Internet File Transfer Protocol server
`help`	Displays a brief message summarizing available commands
`hostname`	Set or print name of current host system
`ifconfig`	Configure network interface parameters
`ifwait`	Waits for an interface to be set up
`inetNS`	Internet name servers
`inetNSdns`	Internet name servers
`inetNShost`	Internet name servers
`inetNSien116`	Internet name servers
`inetNSnis`	Internet name servers
`ls`	List directory contents
`memstat`	Displays information about current memory usage
`mkdev`	Creates a device interface
`mkfd`	Create a bootable floppy disk from a ChorusOS boot image
`mkdir`	Create directories
`mkfifo`	Make FIFOs
`mkfs`	Replaced by `newfs`
`mkmerge`	Create a merged tree
`mknod`	Build special file
`mount`	Mount file systems
`mountd`	NFS daemon providing remote mount services
`mount_msdos`	Mount an MSDOS file system
`mount_nfs`	Mount an NFS file system
`mv`	Move files
`netstat`	Show network status
`newfs`	Construct a new file system
`newfs_dos`	Create an MS-DOS (FAT) file system
`nfsd`	NFS daemon providing remote NFS services
`nfsstat`	Display NFS statistics
`pax`	Read and write file archives and copy directory hierarchies
`ping`	Requests an ICMP `ECHO_RESPONSE` from the specified host
`pppclose`	Requests that `pppstart` daemon starts a thread to open a PPP line on device
`pppd`	Point-to-Point Protocol command
`pppstart`	Enables client PPP connections
`pppstop`	Disables PPP services on the target system
`PROF`	ChorusOS profiler server
`profctl`	ChorusOS profiling control tool
`profrpg`	ChorusOS profiling report generator
`rarp`	Sets the IP address of the Ethernet interface
`rdbc`	ChorusOS remote debugging daemon
`reboot`	Kills all actors on the target system
`restart`	Restarts the system
`rm`	Remove directory entries
`rmdir`	Remove directories
`route`	Manipulate the routing tables manually
`rpcbind`	DARPA port to RPC program number mapper
`rshd`	Command interpreter based on the remote shell protocol
`setenv`	Sets an environment variable
`shutdown`	Shut down and reboot or restart the system, change system state
`sleep`	Suspends execution of current thread
`source`	Reads and executes commands in file
`swapon`	Specify additional device for swapping
`syncd`	Update disks periodically
`sysctl`	Get or set microkernel state
`sysenv`	ChorusOS operating system environment
`telnetd`	Telnet Protocol server
`touch`	Change file access and modification times
`ulimit`	Sets or displays resource limits
`umask`	Displays or sets the file creation mask
`umount`	Unmount file systems
`uname`	Display information about the system
`unsetenv`	Sets the environment variable
`ypbind`	NIS binder process
`ypcat`	Print the values of all keys in a YP database
`ypmatch`	Print the values of one or more keys in a YP database
`ypwhich`	Return the name of the NIS server or map master