vovstop

Stop a list of objects. The jobs are normally descheduled, but if the -f (-force) option is used, then also running jobs are stopped.


vovstop: Usage Message

DESCRIPTION:
   Stop a list of objects.  The jobs are normally descheduled,
   but if the -f (-force) option is used, then also running jobs
   are stopped.

USAGE:
   % vovstop [options]
   % vovstop [options] objectId ...
   % vovstop [options] setName ...

OPTIONS:
    Most options can be abbreviated to one character.

   -help               -- Print this message.
   -q                  -- Quiet.
   -s                  -- Quiet (same as -q).
   -silent             -- Quiet (same as -q).
   -v                  -- Increase verbosity.
   -f                  -- Stop running jobs also, same as -force
   -force              -- Stop running jobs also, same as -f
   -running            -- Stop running jobs ONLY for the specified
                          jobs or set, do not dequeue jobs.
                          Implies -force.
   -dir      <dirname> -- Stop jobs in a directory.
   -subdirs  <dirname> -- Stop jobs in a directory and all subdirs.
   -downcone           -- Stop also all jobs in the downcone
                          of the specified nodes.

   -retraces           -- Stop all current retrace requests.
   -alljobs            -- Stop all jobs.
   -project            -- Stop current project.
   -signals <SIGLIST>  -- Comma separated list of signals to send to the jobs
                          (default sequence is TERM,HUP,INT,KILL )
                          This can be also set with property NC_STOP_SIGNALS
                          or with the environment variables NC_STOP_SIGNALS
                          or VOV_STOP_SIGNALS.
                          Priority: 1. Option -signal
                                    2. job property NC_STOP_SIGNALS,
                                       STOP_SIGNALS
                                    3. env variable VOV_STOP_SIGNALS,
                                       NC_STOP_SIGNALS
                                    4. default (can be configured as
                                       defaultStopSignalCascade in policy.tcl)
                          See also:  vovshow -env VOV_STOP_SIGNALS
                                     vovshow -env NC_STOP_SIGNALS
   -sig     <SIGLIST>  -- Same as -signals.
   -exclude <PROCLIST> -- List of processes to exclude from receiving the
                          signal.
   -include <PROCLIST> -- List of processes to receive the signal.
   -delay   <s>        -- Minimum delay between signals (in seconds),
                          between 0 and 20s. Default is 3.
                          This can also be set with the property
                          NC_STOP_SIG_DELAY, or with the environment
                          variables NC_STOP_SIG_DELAY or
                          VOV_STOP_SIGNAL_DELAY. If both NC_STOP_SIG_DELAY
                          and VOV_STOP_SIGNAL_DELAY are present in the
                          environment, the value of NC_STOP_SIG_DELAY will
                          be used.
                          Priority: 1. Option -delay
                                    2. job property NC_STOP_SIG_DELAY
                                    3. env variable VOV_STOP_SIGNAL_DELAY,
                                       NC_STOP_SIG_DELAY
                                    4. default
    -why    <REASON>   -- The reason why vovstop is being called. This gets
                          passed to the WHYSTATUS field and property if it
                          causes a status change.
    -skiptop <0|1>     -- Whether to skip the top process.
                          This is normally the job wrapper (e.g. vov, vrt, vw).
                          Default is 0.
The 'objectId' argument can refer to a: job, user, retrace, set,
                                        bucket, or file

EXAMPLES:
   % vovstop System:jobs           -- Stop jobs in specified set.
   % vovstop 00023456              -- Stop job by id.
                                      The id refers to a job, set, retrace,
                                      file, bucket, or user.
   % vovstop -dir .                -- Stop jobs in current dir.
   % vovstop -subdirs .            -- Stop jobs in current dir
                                      and all subdirs.
   % vovstop -alljobs
   % vovstop -f -alljobs           -- Stop and kill all jobs
   % vovstop -f -signal HUP,TERM   -- Send SIGHUP and SIGTERM to all jobs
   % vovstop -f -include sleep     -- Stop all "sleep" jobs
   % vovstop -f -exclude sleep,ls  -- Stop all jobs EXCEPT "sleep" and
                                      "ls" jobs
   % vovstop -retraces -why "The reason why all retraces were stopped"