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

FreeBSD Manual Pages

  
 
  

home | help
just-man-pages/condor_rm(1) General Commands Manualjust-man-pages/condor_rm(1)

Name
       condor_rm remove	jobs from the HTCondor queue

Synopsis
       condor_rm [ -help -version ]

       condor_rm  [ -debug ] [ -forcex ] [ -pool centralmanagerhostname[:port-
       number] -name scheddname	][ -addr  _a.b.c.d:port_  ]  cluster...	 clus-
       ter.process... user...  -constraint expression ...

       condor_rm  [ -debug ] [ -pool centralmanagerhostname[:portnumber] -name
       scheddname ][ -addr _a.b.c.d:port_ ] -all

Description
       condor_rm removes one or	more jobs from the HTCondor job	queue. If  the
       -name option is specified, the named condor_schedd is targeted for pro-
       cessing.	Otherwise, the local condor_schedd is targeted.	The jobs to be
       removed are identified by one or	more job identifiers, as described be-
       low. For	any given job, only the	owner of the job or one	of  the	 queue
       super  users  (defined  by the  QUEUE_SUPER_USERS macro)	can remove the
       job.

       When removing a grid job, the job may remain in the ``X'' state	for  a
       very  long  time. This is normal, as HTCondor is	attempting to communi-
       cate with the remote scheduling system, ensuring	that the job has  been
       properly	 cleaned up. If	it takes too long, or in rare circumstances is
       never removed, the job may be forced to leave the job  queue  by	 using
       the  -forcex  option.  This forcibly removes jobs that are in the ``X''
       state without attempting	to finish any clean up at  the	remote	sched-
       uler.

Options
       -help

	  Display usage	information

       -version

	  Display version information

       -pool centralmanagerhostname[:portnumber]

	  Specify  a pool by giving the	central	manager's host name and	an op-
	  tional port number

       -name scheddname

	  Send the command to a	machine	identified by scheddname

       -addr _a.b.c.d:port_

	  Send the command to a	machine	located	at _a.b.c.d:port_

       -debug

	  Causes debugging information to be sent to  stderr ,	based  on  the
	  value	of the configuration variable  TOOL_DEBUG

       -forcex

	  Force	the immediate local removal of jobs in the 'X' state (only af-
	  fects	jobs already being removed)

       cluster

	  Remove all jobs in the specified cluster

       cluster.process

	  Remove the specific job in the cluster

       user

	  Remove jobs belonging	to specified user

       -constraint expression

	  Remove all jobs which	match the job ClassAd expression constraint

       -all

	  Remove all the jobs in the queue

General	Remarks
       Use the -forcex argument	with caution, as it will remove	jobs from  the
       local  queue immediately, but can orphan	parts of the job that are run-
       ning remotely and have not yet been stopped or removed.

Examples
       For a user to remove all	their jobs that	are not	currently running:

       % condor_rm -constraint 'JobStatus =!= 2'

Exit Status
       condor_rm will exit with	a status value of 0 (zero) upon	 success,  and
       it will exit with the value 1 (one) upon	failure.

Author
       Center for High Throughput Computing, University	of Wisconsin-Madison

Copyright
       Copyright  (C) 1990-2015	Center for High	Throughput Computing, Computer
       Sciences	Department, University of Wisconsin-Madison, Madison, WI.  All
       Rights Reserved.	Licensed under the Apache License, Version 2.0.

				     date	   just-man-pages/condor_rm(1)

Name | Synopsis | Description | Options | General Remarks | Examples | Exit Status | Author | Copyright

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=condor_rm&sektion=1&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help