aboutsummaryrefslogtreecommitdiff
path: root/man/man1/gms.1df
diff options
context:
space:
mode:
authorTom Ryder <tom@sanctum.geek.nz>2016-08-26 12:13:03 +1200
committerTom Ryder <tom@sanctum.geek.nz>2016-08-26 12:50:25 +1200
commitcde1926a3c65830bceed5e8e76cd94e81b19386c (patch)
tree5abe782d2c9567f3d7c3affa8fc077fb3d5d5e5c /man/man1/gms.1df
parentAdd notifications to dmp(1) (diff)
downloaddotfiles-cde1926a3c65830bceed5e8e76cd94e81b19386c.tar.gz
dotfiles-cde1926a3c65830bceed5e8e76cd94e81b19386c.zip
Put dotfiles manuals into their own section
This probably contains a few mistakes
Diffstat (limited to 'man/man1/gms.1df')
-rw-r--r--man/man1/gms.1df24
1 files changed, 24 insertions, 0 deletions
diff --git a/man/man1/gms.1df b/man/man1/gms.1df
new file mode 100644
index 00000000..b6b0f716
--- /dev/null
+++ b/man/man1/gms.1df
@@ -0,0 +1,24 @@
+.TH GMS 1df "June 2016" "Manual page for gms"
+.SH NAME
+.B gms
+\- run getmail(1) requests in parallel over multiple getmailrc.* files
+.SH SYNOPSIS
+.B gms
+.SH DESCRIPTION
+.B gms
+runs getmail(1) for each file matching the pattern ~/.getmail/getmailrc.*,
+doing much the same thing as the getmails(1) script included in the Getmail
+distribution. It differs from that script in a few ways:
+.IP \[bu] 4
+It includes per-rc-file locking so that at most one getmail(1) process runs for
+the same account, but allows multiple instances of gms(1df) to run at the same
+time.
+.IP \[bu]
+It runs the requests in parallel using fork(2)/wait(2).
+.IP \[bu]
+It uses try(1df) to attempt each fetch three times, with 15 seconds between each
+attempt, and only prints errors if all three attempts fail.
+.SH SEE ALSO
+getmail(1), try(1df)
+.SH AUTHOR
+Tom Ryder <tom@sanctum.geek.nz>