Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
newtask(1)			 User Commands			    newtask(1)

NAME
       newtask - create	new task or change task	or project of running process

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

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	speci-
       fied  project.  The  user's  default  shell is the one specified	in the
       passwd database,	and is determined via getpwnam().

       Alternatively, newtask may be used to change the	 task  of  an  already
       running	process.  A  project may also be specified in this form	of the
       command.	This may 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 may
       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
	     Changes  the  task	 or project of a running process. 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 mem-
	     ber  of  the specified project. 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. Con-
	     trols not explicitly specified in the project entry will be  pre-
	     served.

	     This option is incompatible with the -F and -l options.

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

       -l    Changes the environment to	what would  be expected	 if  the  user
	     dactually 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 invoking user must be a valid	member
	     of	 the  requested	 project  for  the  command  to	succeed. If no
	     project name is specified,	the new	task is	started	in the	invok-
	     ing 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	project,  dis-
       playing 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

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  ma-
	     chine.

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

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

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE	TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWcsu			   |
       +-----------------------------+-----------------------------+

SEE ALSO
       proc(1),	 id(1M),  poolbind(1M),	 execvp(2),  setrctl(2), settaskid(2),
       setproject(3PROJECT),  nsswitch.conf(4),	  proc(4),   project(4),   at-
       tributes(5)

SunOS 5.9			  19 Dec 2001			    newtask(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | OPERANDS | EXAMPLES | EXIT STATUS | FILES | ATTRIBUTES | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=newtask&sektion=1&manpath=SunOS+5.9>

home | help