newtask [-p project] [-v] [-c pid | [-Fl] [command...]]
The newtask command executes the user's default shell or a specified command, placing the executed command in a new task owned by the specified project. The user's default shell is the one specified in the passwd database, and is determined using getpwnam().
Alternatively, newtask can be used to cause an already running process to enter a newly created task. A project for the new task can also be specified in this form of the command. This might be desirable for processes that are mission critical and cannot be restarted in order to put them into a new project.
In the case that extended accounting is active, the newtask command can additionally cause the creation of a task accounting record marking the completion of the preceding system task.
The following options are supported:
If the project is being changed, the process owner must be a member of the specified project, or the invoking user must have super-user privileges. When the project is changed for a running process, its pool binding as well as resource controls are modified to match the configuration of the new project. Controls not explicitly specified in the project entry is preserved.
This option is incompatible with the -F and -l options.
The following operands are supported:
The following example creates a new shell in the canada project, displaying the task id:
example$ id -p uid=565(gh) gid=10(staff) projid=10(default) example$ newtask -v -p canada 38 example$ id -p uid=565(gh) gid=10(staff) projid=82(canada)
Example 2 Running the date Command
The following example runs the date command in the russia project:
example$ newtask -p russia date Tue Aug 31 11:12:10 PDT 1999
Example 3 Changing the Project of an Existing Process
The following example changes the project of the existing process with a pid of 9999 to russia:
example$ newtask -c 9999 -p russia
The following exit values are returned:
|November 17, 2004||OmniOS|