sysShutdown(2K)

NAME | SYNOPSIS | DESCRIPTION | PARAMETERS | RETURN VALUES | ERRORS | ATTRIBUTES | SEE ALSO

NAME

sysShutdown- shut down or restart the system

SYNOPSIS

int sysShutdown(int argc, char **argv);

DESCRIPTION

sysShutdown() is executed by trusted user actors or supervisor actors to shut down the OS. It is a high-level interface intended for use in multi-command actors such as C_INIT(1M).

PARAMETERS

sysShutdown() parameters are similar to the options for shutdown(1M). If the first parameter is -i, then the subsequent digit indicates the system state and actions to perform as follows:

0

Shut down the entire system safely and reboot.

1

Perform a site restart. A site restart means that the entire system is shut down safely and then restarted from the system image, without accessing stable storage, such that direct hot restartable actors are automatically restarted from persistent memory. This state requires the HOT_RESTART feature.

See the manual entry for restart(1M) for a more detailed description of site restart.

RETURN VALUES

Upon successful completetion, 0 is returned and the system is no longer available. Otherwise, a negative error code is returned if a nucleus error is encountered, or a positive error code is returned if an OS error is encountered.

ERRORS

Nucleus errors include any errors reported by threadCreate(2K) or threadScheduler(2K).

[EFAULT]

Actor capability of the invoker cannot be obtained.

[EINVAL]

Invalid argument.

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Interface Stability	Evolving

SEE ALSO

shutdown(1M), restart(1M)

ChorusOS 4.0  Last Revised December 1999

NAME | SYNOPSIS | DESCRIPTION | PARAMETERS | RETURN VALUES | ERRORS | ATTRIBUTES | SEE ALSO