1CONDOR_PREEN(1)                 HTCondor Manual                CONDOR_PREEN(1)
2
3
4

NAME

6       condor_preen - HTCondor Manual
7
8       remove extraneous files from HTCondor directories
9
10

SYNOPSIS

12       condor_preen  [-mail  ]  [-remove  ] [-verbose ] [-debug ] [-log <file‐
13       name>]
14

DESCRIPTION

16       condor_preen  examines  the  directories  belonging  to  HTCondor,  and
17       removes  extraneous  files  and directories which may be left over from
18       HTCondor processes which terminated abnormally either due  to  internal
19       errors or a system crash. The directories checked are the LOG, EXECUTE,
20       and SPOOL directories as defined in the HTCondor  configuration  files.
21       condor_preen is intended to be run as user root or user condor periodi‐
22       cally as a backup method to ensure reasonable file  system  cleanliness
23       in  the  face  of  errors. This is done automatically by default by the
24       condor_master daemon. It may also be explicitly invoked on an as needed
25       basis.
26
27       When  condor_preen  cleans the SPOOL directory, it always leaves behind
28       the files specified in the  configuration  variables  VALID_SPOOL_FILES
29       and  SYSTEM_VALID_SPOOL_FILES  , as given by the configuration. For the
30       LOG directory, the only files removed  or  reported  are  those  listed
31       within  the configuration variable INVALID_LOG_FILES   list. The reason
32       for this difference is that, in general, the files in the LOG directory
33       ought  to  be left alone, with few exceptions. An example of exceptions
34       are core files. As there are new log files introduced regularly, it  is
35       less  effort  to specify those that ought to be removed than those that
36       are not to be removed.
37

OPTIONS

39          -mail  Send mail to the user defined in the PREEN_ADMIN
40                   configuration variable, instead of writing to the  standard
41                 output.
42
43          -remove
44                 Remove  the  offending  files  and  directories  rather  than
45                 reporting on them.
46
47          -verbose
48                 List all files or directories found in the Condor directories
49                 and  considered for deletion, even those which are not extra‐
50                 neous. This option also modifies the output produced  by  the
51                 -debug and -log options
52
53          -debug Print  extra  debugging  information to stderr as the command
54                 executes.
55
56          -log <filename>
57                 Write extra debugging information to <filename> as  the  com‐
58                 mand executes.
59

EXIT STATUS

61       condor_preen  will  exit  with a status value of 0 (zero) upon success,
62       and it will exit with a non-zero value upon failure.  An exit status of
63       2  indicates  that  condor_preen  attempted to send email about deleted
64       files but was unable to. This usually indicates an error in the config‐
65       uration  for  sending  email.   An exit status of 1 indicates a general
66       failure.
67

AUTHOR

69       HTCondor Team
70

72       1990-2020, Center for  High  Throughput  Computing,  Computer  Sciences
73       Department,  University of Wisconsin-Madison, Madison, WI, US. Licensed
74       under the Apache License, Version 2.0.
75
76
77
78
798.8                              Aug 06, 2020                  CONDOR_PREEN(1)
Impressum