unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



jobs(1)								      jobs(1)



NAME

  jobs - Displays status of jobs in the	current	session

SYNOPSIS

  jobs [-l  | -p] job_id...

  [Tru64 UNIX]

  jobs [-n] job_id...

				     Note

       The C shell has a built-in version of the jobs command.	If you are
       using the C shell, and want to guarantee	that you are using the com-
       mand described here, you	must specify the full path /usr/bin/jobs.
       See the csh(1) reference	page for a description of the built-in com-
       mand.

STANDARDS

  Interfaces documented	on this	reference page conform to industry standards
  as follows:

  jobs:	 XCU5.0

  Refer	to the standards(5) reference page for more information	about indus-
  try standards	and associated tags.

OPTIONS

  -l  Provides more information	about each job listed. This information
      includes the job number, current job, process group ID, state and	the
      command that formed the job.

  -p  Displays only the	process	IDs for	the process group leaders of the
      selected jobs.

  -n  [Tru64 UNIX]  Displays jobs that have stopped or exited since last
      notified.

  By default, the jobs utility displays	the status of all stopped jobs,	run-
  ning background jobs and all jobs whose status has changed and has not been
  reported by the shell.









OPERANDS

  job_id
      Specifies	the jobs for which the status is to be displayed.  If no
      job_id operand is	given, the status information for all jobs is
      displayed.  The format of	job_id is described in the Jobs	section	of
      the ksh(1) reference page.

DESCRIPTION

  The jobs utility displays the	status of jobs that were started in the
  current shell	environment.

  When jobs reports the	termination status of a	job, the shell removes its
  process ID from the list of those "known in the current shell	execution
  environment".	 See the Jobs section of the ksh(1) reference page.

RESTRICTIONS

  The jobs utility does	not work as expected when it is	operating in its own
  utility execution environment	because	that environment has no	applicable
  jobs to manipulate.

EXIT STATUS

  The following	exit values are	returned:

  0   Successful completion.

  >>0  An error occurred.

ENVIRONMENT VARIABLES

  The following	environment variables affect the execution of jobs:

  LANG
      Provides a default value for the internationalization variables that
      are unset	or null. If LANG is unset or null, the corresponding value
      from the default locale is used.	If any of the internationalization
      variables	contain	an invalid setting, the	utility	behaves	as if none of
      the variables had	been defined.

  LC_ALL
      If set to	a non-empty string value, overrides the	values of all the
      other internationalization variables.

  LC_CTYPE
      Determines the locale for	the interpretation of sequences	of bytes of
      text data	as characters (for example, single-byte	as opposed to multi-
      byte characters in arguments).

  LC_MESSAGES
      Determines the locale used to affect the format and contents of diag-
      nostic messages written to standard error	and informative	messages
      written to standard output.

  NLSPATH
      Determines the location of message catalogues for	the processing of
      LC_MESSAGES.







SEE ALSO

  Commands:  bg(1), csh(1), fg(1), kill(1), ksh(1), sh(1p), wait(1)


  Standards:  standards(5)