condor_ preen examines the directories belonging to Condor, and removes extraneous files and directories which may be left over from Condor processes which terminated abnormally either due to internal errors or a system crash. The directories checked are the LOG, EXECUTE, and SPOOL directories as defined in the Condor configuration files. condor_ preen is intended to be run as user root (or user condor) periodically as a backup method to ensure reasonable file system cleanliness in the face of errors. This is done automatically by default by the condor_ master. It may also be explicitly invoked on an as needed basis.
When condor_ preen cleans the SPOOL directory, it always leaves behind the files specified in the VALID_SPOOL_FILES list in your config file. For the log directory, the only files removed or reported are those listed in the INVALID_LOG_FILES list. The reason for this difference is that, in general, you want to leave all files in the LOG directory alone, with a few exceptions (namely, core files). condor_ preen still works if you supply a VALID_LOG_FILES list instead, but this usage is depricated. There are new log files for different things introduced all the time, and you wouldn't want to have to keep updating the list of files to leave alone in the LOG directory. For example, the SMP startd can spawn an arbitrary number of condor_ starter processes, each with its own log file. On the other hand, there are only a small, fixed number of files in the SPOOL directory that the condor_ schedd needs to keep around, so it is easier to specify the files you want to keep instead of the ones you want to get rid of.
condor_ preen will exit with a status value of 0 (zero) upon success, and it will exit with the value 1 (one) upon failure.
U.S. Government Rights Restrictions: Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in subparagraph (c)(1)(ii) of The Rights in Technical Data and Computer Software clause at DFARS 252.227-7013 or subparagraphs (c)(1) and (2) of Commercial Computer Software-Restricted Rights at 48 CFR 52.227-19, as applicable, Condor Team, Attention: Professor Miron Livny, 7367 Computer Sciences, 1210 W. Dayton St., Madison, WI 53706-1685, (608) 262-0856 or firstname.lastname@example.org.
See the Condor Version 6.8.7 Manual for additional notices.