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  re‐
17       moves  extraneous files and directories which may be left over from HT‐
18       Condor processes which terminated abnormally either due to internal er‐
19       rors  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 re‐
45                 porting 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-2023, Center for High Throughput Computing, Computer Sciences  De‐
73       partment,  University  of  Wisconsin-Madison, Madison, WI, US. Licensed
74       under the Apache License, Version 2.0.
75
76
77
78
79                                 Oct 02, 2023                  CONDOR_PREEN(1)
Impressum