openbsd-ports/sysutils/safecat/pkg/DESCR
2004-07-12 11:56:51 +00:00

18 lines
1.0 KiB
Plaintext

safecat is a program which implements D. J. Bernstein's maildir
algorithm to copy stdin safely to a file in a specified directory. With
safecat, the user is offered two assurances. First, if safecat returns
a successful exit status, then all data is guaranteed to be saved in the
destination directory. Second, if a file exists in the destination
directory, placed there by safecat, then the file is guaranteed to be
complete.
When saving data with safecat, the user specifies a destination
directory, but not a file name. The file name is selected by safecat to
ensure that no filename collisions occur, even if many safecat processes
and other programs implementing the maildir algorithm are writing to the
directory simultaneously. If particular filenames are desired, then the
user should rename the file after safecat completes. In general, when
spooling data with safecat, a single, separate process should handle
naming, collecting, and deleting these files. Examples of such a
process are daemons, cron jobs, and mail readers.