Reformatting page.  Please Wait... done


User Commands                                          NEWTASK(1)


NAME
     newtask - create new task and optionally change project

SYNOPSIS
     newtask [-p project] [-v] [-c pid | [-Fl] [command...]]


DESCRIPTION
     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  run-
     ning  process  to  enter a newly created task. A project for
     the new task can also be specified in this form of the  com-
     mand. 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.

OPTIONS
     The following options are supported:

     -c pid
               Cause a running process to enter a  newly  created
               task.  A  project  for  the  new  task can also be
               specified using the -p option. The  invoking  user
               must  either  own  the  process or have super-user
               privileges.

               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.


Illumos             Last change: Nov 17, 2004                   1


User Commands                                          NEWTASK(1)


     -F
               Creates a finalized  task,  within  which  further
               newtask  or  settaskid(2)  invocations would fail.
               Finalized tasks can be useful at  some  sites  for
               simplifying  the  attribution of resource consump-
               tion.


     -l
               Changes the environment to what would be  expected
               if  the  user actually logged in again as a member
               of the new project.


     -p
               Changes the project ID of the  new  task  to  that
               associated with the given project name. The invok-
               ing user must be a valid member of  the  requested
               project,  or  must have super-user privileges, for
               the command to succeed.  If  no  project  name  is
               specified, the new task is started in the invoking
               user's current project.


     -v
               Verbose: displays the system task id  as  the  new
               system task is begun.


OPERANDS
     The following operands are supported:

     project
                The  project  to  which  resource  usage  by  the
                created  task  should  be  charged. The requested
                project must be defined in the project  databases
                defined in nsswitch.conf(4).


     command
                The command to be executed as the new task. If no
                command  is  given,  the  user's  login  shell is
                invoked. (If the login shell  is  not  available,
                /bin/sh is invoked.)


EXAMPLES
     Example 1 Creating a New Shell


     The following example creates a new shell in the canada pro-
     ject, displaying the task id:


Illumos             Last change: Nov 17, 2004                   2


User Commands                                          NEWTASK(1)


       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


EXIT STATUS
     The following exit values are returned:

     0
          Successful execution.


     1
          A fatal error occurred during execution.


     2
          Invalid command line options were specified.


FILES
     /etc/project
                     Local  database  containing  valid   project
                     definitions for this machine.


Illumos             Last change: Nov 17, 2004                   3


User Commands                                          NEWTASK(1)


     /proc/pid/*
                     Process information and control files.


SEE ALSO
     proc(1)id(1M)poolbind(1M)execvp(2),  setrctl(2),  set-
     taskid(2),  setproject(3PROJECT)nsswitch.conf(4)proc(4),
     project(4)attributes(5)


Illumos             Last change: Nov 17, 2004                   4