info > DOTLOCK.MAILUTILS

man perldoc info pydoc3 ri search

📄 NAME

dotlock.mailutils - lock mail spool files.

🚀 Quick Reference

Use Case	Command	Description
Lock a mail spool file	dotlock.mailutils FILE	🔒 Lock the specified file (default action)
Unlock a file	dotlock.mailutils -u FILE	🔓 Release an existing lock
Force break an old lock	dotlock.mailutils -f[=MINUTES] FILE	⏰ Break lock older than MINUTES (default 5)
Retry locking with delay	dotlock.mailutils -r RETRIES -t SECONDS FILE	🔄 Retry lock up to RETRIES times, SECONDS apart
Enable debug output	dotlock.mailutils -d FILE	🐛 Print failure details to stderr
Check if lock owner PID is alive	dotlock.mailutils -p FILE	🔍 Verify lock owner's PID still active

📋 SYNOPSIS

dotlock.mailutils [OPTION...] FILE

📝 DESCRIPTION

GNU dotlock — lock mail spool files.

Options:

• -d, --[no-]debug — 🔍 print details of failure reasons to stderr
• -f, --force[=MINUTES] — ⏰ forcibly break an existing lock older than a certain time
• -p, --[no-]pid-check — 🔍 check if the PID of lock owner is still active
• -r, --retry=RETRIES — 🔄 retry the lock a few times
• -t, --delay=SECONDS — ⏱️ delay between two successive locking attempts (in seconds)
• -u, --[no-]unlock — 🔓 unlock

⚙️ Global debugging settings

• --debug-level=LEVEL — 🐛 set Mailutils debugging level
• --[no-]debug-line-info — 📄 show source info with debugging messages

🔧 Configuration handling

• --config-file=FILE — 📂 load this configuration file; implies --no-config
• --config-lint — ✅ check configuration file syntax and exit
• --config-verbose — 🗣️ verbosely log parsing of the configuration files
• --no-config — 🚫 do not load site and user configuration files
• --no-site-config — 🏢 do not load site-wide configuration file
• --no-user-config — 👤 do not load user configuration file
• --set=PARAM=VALUE — ⚙️ set configuration parameter

ℹ️ Informational options

• --config-help — 📖 show configuration file summary
• --show-config-options — 🛠️ show compilation options
• -?, --help — ❓ give this help list
• --usage — 📋 give a short usage message
• -V, --version — 📌 print program version

Mandatory or optional arguments to long options are also mandatory or optional for any corresponding short options.

🚪 Exit Codes

• 0 — ✅ Success
• 1 — ❌ Other error occurred
• 3 — 🔒 Locking failed because file is already locked

🐛 REPORTING BUGS

Report bugs to bug-mailutils AT gnu.org.
GNU Mailutils home page: http://mailutils.org
General help using GNU software: http://www.gnu.org/gethelp/

©️ COPYRIGHT

Copyright © 2007-2022 Free Software Foundation, inc. License GPLv3+: GNU GPL version 3 or later http://gnu.org/licenses/gpl.html
This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.

📚 SEE ALSO

The complete GNU mailutils documentation is maintained as a Texinfo manual. If the mailutils-doc package is installed, the command

info mailutils

should give you access to the complete manual.

You can also find this manual online in the GNU mailutils webpage:
https://www.gnu.org/software/mailutils/manual/index.html.

Please note this manpage was automatically generated by the Debian mailutils packagers. Do not file bugs for its content to the GNU Mailutils upstream authors.

📄 NAME 🚀 Quick Reference 📋 SYNOPSIS 📝 DESCRIPTION 🚪 Exit Codes 🐛 REPORTING BUGS ©️ COPYRIGHT 📚 SEE ALSO