NAME | SYNOPSIS | DESCRIPTION | ATTRIBUTES | SEE ALSO
The C_INIT(1M)
built-in command, arun, is used to run actor_name on the target system and report the actor ID (aid) of the new c_actor
. If secured mode
is activated, actor_name runs with the credentials
specified in /etc/security. If not, actor_name runs with the uid and gid
specified during configuration of the ChorusOS system image. The current
working directory is the root directory of the target system where actor_name started. The search PATH for C_INIT
is /bin.
arun accepts the following arguments:
Starts actor_name in DEBUGMODE mode, in which system retains extra information about thread execution that is useful for some source-level debuggers.
Starts actor_name in a stopped state, usually to allow a debugger to
attach itself to the c_actor
before the actor starts.
This argument can only be used if the HOT_RESTART feature
is present. It starts actor_name as part of a restartable
actor group whose identifier is specified as gid. The gid parameter must be between 0 and hrCtrl.maxgroups-1
. If no gid is specified, the default
value is 0.
When an actor is run using this argument, the actor name and all arun arguments are stored as part of the file image in persistent memory. When the actor is restarted from this file image, the same name and arguments will be used. Note that the actor ID and capability are not persistent, that is, they will change when the actor is restarted.
Allows the debugger to access the symbol table of actor_name.
This option is ignored for user c_actor
s.
Do not print the string Started aid aid.
Starts actor_name as a supervisor actor. Mutually exclusive with -U. This option may only be used by TRUSTED users.
If neither -S nor -U is set, privilege is deduced from the binary at load time.
Loads the binary text segment of the actor code in place, without copying it. The data segment is copied, however. By default, both new actor code and data segments are loaded in newly allocated memory regions.
The -xip option allows execution of absolute binaries built into the system image such as network administration daemons located in the /image/sys_bank directory. In order to optimize memory use even further, you can make the actor a boot actor. For boot actors, both text and data segments are loaded in place.Note, however, that boot actors are limited in that they cannot be started dynamically, using the arun command, and, futhermore, only one instance of a boot actor may be run.
Starts actor_name as a TRUSTED actor. This option may only be used by TRUSTED users.
Starts actor_name as a user actor. Mutually exclusive with -S.
If neither -S nor -U is set, privilege is deduced from the binary at load time.
Starts actor_name in a stopped state, usually to allow a debugger to
attach itself to the c_actor
before the actor starts.
Full path name to the actor on the target system.
Arguments passed to the actor without being interpreted by C_INIT
.
See attributes(5) for descriptions of the following attributes:
ATTRIBUTE TYPE | ATTRIBUTE VALUE |
---|---|
Interface Stability | Evolving |
NAME | SYNOPSIS | DESCRIPTION | ATTRIBUTES | SEE ALSO