User Commands                                          newtask(1)

NAME
     newtask - create new task

SYNOPSIS
     newtask [ -Flv ]  [  -p project ]  [  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 via getpwnam().

     In the case that extended accounting is active, the  newtask
     command  may  additionally  cause  the  creation  of  a task
     accounting record marking the completion  of  the  preceding
     system task.

OPTIONS
     The following options are supported:

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

     -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 associ-
           ated  with  the  given project name. The invoking user
           must be a valid member of the  requested  project  for
           the  command  to succeed. If no project name is speci-
           fied, 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 com-
           mand  is given, the user's login shell is invoked. (If

SunOS 5.8           Last change: 18 Feb 2000                    1

User Commands                                          newtask(1)

           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:

     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

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.

ATTRIBUTES
     See attributes(5) for a description of the following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWcsu                     |
    |_____________________________|_____________________________|

SEE ALSO
     id(1M),  execvp(2),  settaskid(2),  nsswitch.conf(4),   project(4)
     , attributes(5)

SunOS 5.8           Last change: 18 Feb 2000                    2