From 71e9c0c9b8df136c3cde34356fcaad875fe16758 Mon Sep 17 00:00:00 2001 From: =?utf8?q?Rapha=C3=ABl=20Gertz?= Date: Sun, 19 Apr 2020 14:20:44 +0200 Subject: [PATCH] Add new acme, acme-cron, acme-cert and acme-cron man pages --- acme-cert.1 | 73 ++++++++++++++++++++++++++++++++++ acme-conf.1 | 82 ++++++++++++++++++++++++++++++++++++++ acme-cron.1 | 111 ++++++++++++++++++++++++++++++++++++++++++++++++++++ acme.1 | 76 +++++++++++++++++++++++++++++++++++ 4 files changed, 342 insertions(+) create mode 100644 acme-cert.1 create mode 100644 acme-conf.1 create mode 100644 acme-cron.1 create mode 100644 acme.1 diff --git a/acme-cert.1 b/acme-cert.1 new file mode 100644 index 0000000..36fbb0c --- /dev/null +++ b/acme-cert.1 @@ -0,0 +1,73 @@ +.\" Manpage for acme cert. +.\" Contact acme@rapsys.eu to correct errors or typos. +.TH man 1 "19 Apr 2020" "2\&.0\&.0" "acme-cert man page" +.SH "NAME" +acme-cert \- the acme certificate generator + +.SH "SYNOPSIS" +\fIacme\fR cert [\-(v|\-verbose)] [\-(c|\-config)[=/etc/acme/config]] [example.com] [...] + +.SH "DESCRIPTION" +Acme cert is a fast and simple certificate generator. + +.sp +See \fBacme-conf\fR(1) to configure your certificate and eventually look at \fBacme-cron\fR(1) to setup the cron job\&. + +.SH "DOCUMENTATION" +A formated and hyperlinked copy of the lastest ACME v2 API documentation can be viewed at \fBhttps://ietf-wg-acme\&.github\&.io/acme/draft-ietf-acme-acme\&.html\fR\&. + +.sp +This Acme implementation can be used for Let's Encrypt free, automated and open certificate authority, their documentation can be viewed at \fBhttps://letsencrypt\&.org/docs/\fR\&. + +.SH "OPTIONS" +.PP +\-\-verbose +.RS 4 +Produces a verbose report about the current process for the purpose of problem analysis\&. +.RE +.PP +\-\-config +.RS 4 +Use the specified configuration file\&. If the pathname is omitted, the file specified in Acme::CONFIG constant (normally /etc/acme/config) is assumed\&. +.RE +.PP + +.SH "ARGUMENTS" +.PP +\fBexample.com\fR +.RS 4 +Will generate the certificate for the domain as common name and the associated domains as subject alt names\&. +.RE +.PP +without argument +.RS 4 +Will generate the certificate for all domain and associated domains declared in the configuration file. +.RE + +.SH "CONTRIBUTE" +You may buy me a Beer, a Tea or help with Server fees with a paypal donation to the address \m[blue]\fBpaypal@rapsys\&.eu\fR\m[] or via the donation page. + +Don't forget to show your love for this project, feel free to report bugs to the author, issues which are security relevant should be disclosed privately first\&. + +Patches are welcomed and grant credit when requested\&. + +.SH "DONATION" +\m[blue]\fBhttps://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=JNWGK8Z2TBHFN\fR\m[] + +.SH "FURTHER DOCUMENTATION" +A formated and hyperlinked copy of the lastest ACME v2 API documentation can be viewed at \fBhttps://ietf-wg-acme\&.github\&.io/acme/draft-ietf-acme-acme\&.html\fR\&. + +.sp +This Acme implementation can be used for Let's Encrypt free, automated and open certificate authority, their documentation can be viewed at \fBhttps://letsencrypt\&.org/docs/\fR\&. + +.SH "AUTHOR" +Raphaël Gertz (Rapsys) + +.SH "BUGS" +No known bugs. + +.SH "SEE ALSO" +\fBacme\fR(1), \fBacme-conf\fR(1), \fBacme-cron\fR(1) + +.SH "ACME" +Part of the \fBacme\fR(1) suite diff --git a/acme-conf.1 b/acme-conf.1 new file mode 100644 index 0000000..363b1a8 --- /dev/null +++ b/acme-conf.1 @@ -0,0 +1,82 @@ +.\" Manpage for acme conf. +.\" Contact acme@rapsys.eu to correct errors or typos. +.TH man 1 "19 Apr 2020" "2\&.0\&.0" "acme-conf man page" +.SH "NAME" +acme-conf \- the acme conf generator + +.SH "SYNOPSIS" +\fIacme\fR conf [\-(v|\-verbose)] [\-(c|\-config)[=/etc/acme/config]] [\-(d|\-debian)] example.com[=www.example.com[,cdn.example.com]] [...] + +.SH "DESCRIPTION" +Acme conf is a fast and simple configuration generator. + +.sp +See \fBacme-cert\fR(1) to generate your certificate and eventually look at \fBacme-cron\fR(1) to setup the cron job\&. + +.SH "DOCUMENTATION" +A formated and hyperlinked copy of the lastest ACME v2 API documentation can be viewed at \fBhttps://ietf-wg-acme\&.github\&.io/acme/draft-ietf-acme-acme\&.html\fR\&. + +.sp +This Acme implementation can be used for Let's Encrypt free, automated and open certificate authority, their documentation can be viewed at \fBhttps://letsencrypt\&.org/docs/\fR\&. + +.SH "OPTIONS" +.PP +\-\-verbose +.RS 4 +Produces a verbose report about the current process for the purpose of problem analysis\&. +.RE +.PP +\-\-config +.RS 4 +Use the specified configuration file\&. If the pathname is omitted, the file specified in Acme::CONFIG constant (normally /etc/acme/config) is assumed\&. +.RE +.PP +\-\-debian +.RS 4 +Use debian specific path schema in configuration file\&. If omitted, the default redhat path schema is assumed\&. +.RE + +.SH "ARGUMENTS" +.PP +\fBexample.com\fR +.RS 4 +Will generate certificate configuration, with example.com common name\&. +.RE +.PP +\fBexample.com=www.example.com\fR +.RS 4 +Will generate certificate configuration, with example.com common name and www.example.com in subject alt name\&. +.RE +.PP +\fBexample.com=www.example.com,cdn.example.com\fR +.RS 4 +Will generate certificate configuration, with example.com common name and www.example.com + cdn.example.com in subject alt name\&. +.RE + +.SH "CONTRIBUTE" +You may buy me a Beer, a Tea or help with Server fees with a paypal donation to the address \m[blue]\fBpaypal@rapsys\&.eu\fR\m[] or via the donation page. + +Don't forget to show your love for this project, feel free to report bugs to the author, issues which are security relevant should be disclosed privately first\&. + +Patches are welcomed and grant credit when requested\&. + +.SH "DONATION" +\m[blue]\fBhttps://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=JNWGK8Z2TBHFN\fR\m[] + +.SH "FURTHER DOCUMENTATION" +A formated and hyperlinked copy of the lastest ACME v2 API documentation can be viewed at \fBhttps://ietf-wg-acme\&.github\&.io/acme/draft-ietf-acme-acme\&.html\fR\&. + +.sp +This Acme implementation can be used for Let's Encrypt free, automated and open certificate authority, their documentation can be viewed at \fBhttps://letsencrypt\&.org/docs/\fR\&. + +.SH "AUTHOR" +Raphaël Gertz (Rapsys) + +.SH "BUGS" +No known bugs. + +.SH "SEE ALSO" +\fBacme\fR(1), \fBacme-cert\fR(1), \fBacme-cron\fR(1) + +.SH "ACME" +Part of the \fBacme\fR(1) suite diff --git a/acme-cron.1 b/acme-cron.1 new file mode 100644 index 0000000..2040c40 --- /dev/null +++ b/acme-cron.1 @@ -0,0 +1,111 @@ +.\" Manpage for acme cron. +.\" Contact acme@rapsys.eu to correct errors or typos. +.TH man 1 "19 Apr 2020" "2\&.0\&.0" "acme-cron man page" +.SH "NAME" +acme-cron \- the acme cron job + +.SH "SYNOPSIS" +\fIacme\fR cron [\-(v|\-verbose)] [\-(c|\-config)[=/etc/acme/config]] [example.com] [...] + +.SH "DESCRIPTION" +Acme cert is a fast and simple certificate regenerator cron job. + +.sp +See \fBacme-conf\fR(1) to configure your certificate and loot at \fBacme-cert\fR(1) to generate your certificate\&. + +.SH "DOCUMENTATION" +A formated and hyperlinked copy of the lastest ACME v2 API documentation can be viewed at \fBhttps://ietf-wg-acme\&.github\&.io/acme/draft-ietf-acme-acme\&.html\fR\&. + +.sp +This Acme implementation can be used for Let's Encrypt free, automated and open certificate authority, their documentation can be viewed at \fBhttps://letsencrypt\&.org/docs/\fR\&. + +.SH "OPTIONS" +.PP +\-\-verbose +.RS 4 +Produces a verbose report about the current process for the purpose of problem analysis\&. +.RE +.PP +\-\-config +.RS 4 +Use the specified configuration file\&. If the pathname is omitted, the file specified in Acme::CONFIG constant (normally /etc/acme/config) is assumed\&. +.RE +.PP + +.SH "ARGUMENTS" +.PP +\fBexample.com\fR +.RS 4 +Will regenerate the certificate when older than 60 days for the domain as common name and the associated domains as subject alt names\&. +.RE +.PP +without argument +.RS 4 +Will generate the certificate when older than 60 days for all domain and associated domains declared in the configuration file. +.RE + +.SH "CRONJOBS" + +.SS "CRON\&.DAILY SCRIPT" +You may add a daily cron by creating /etc/cron\&.daily/acme file with the content: +.nf + #! /bin/sh + acme cron +.fi + +.sp +Don't forget to set the executable flag: +.nf + # chmod a+x /etc/cron\&.daily/acme +.fi + +.SS "CRONTAB FRAGMENT" +You may add a crontab fragment by creating /etc/cron\&.d/acme file with the content: +.nf + #! /bin/sh + 0 0 * * * \fBusername\fR acme cron +.fi + +.sp +Don't forget to replace \fBusername\fR with desired user identifier\&. + +.SS "USER CRONTAB" +You may add a daily cron by running the following command : +.nf + $ crontab -e +.fi + +.sp +With the following content: +.nf + #! /bin/sh + 0 0 * * * acme cron +.fi + +.SH "CONTRIBUTE" +You may buy me a Beer, a Tea or help with Server fees with a paypal donation to the address \m[blue]\fBpaypal@rapsys\&.eu\fR\m[] or via the donation page. + +Don't forget to show your love for this project, feel free to report bugs to the author, issues which are security relevant should be disclosed privately first\&. + +Patches are welcomed and grant credit when requested\&. + +.SH "DONATION" +\m[blue]\fBhttps://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=JNWGK8Z2TBHFN\fR\m[] + +.SH "FURTHER DOCUMENTATION" +A formated and hyperlinked copy of the lastest ACME v2 API documentation can be viewed at \fBhttps://ietf-wg-acme\&.github\&.io/acme/draft-ietf-acme-acme\&.html\fR\&. + +.sp +This Acme implementation can be used for Let's Encrypt free, automated and open certificate authority, their documentation can be viewed at \fBhttps://letsencrypt\&.org/docs/\fR\&. + +.SH "AUTHOR" +Raphaël Gertz (Rapsys) + +.SH "BUGS" +No known bugs. + +.SH "SEE ALSO" +\fBacme\fR(1), \fBacme-conf\fR(1), \fBacme-cert\fR(1) + +.SH "ACME" +Part of the \fBacme\fR(1) suite diff --git a/acme.1 b/acme.1 new file mode 100644 index 0000000..eee9b3c --- /dev/null +++ b/acme.1 @@ -0,0 +1,76 @@ +.\" Manpage for acme. +.\" Contact acme@rapsys.eu to correct errors or typos. +.TH man 1 "19 Apr 2020" "2\&.0\&.0" "acme man page" +.SH "NAME" +acme \- the acme certificate generator + +.SH "SYNOPSIS" +\fIacme\fR [\-(v|\-verbose)] [\-(c|\-config)[=/etc/acme/config]] [example.com] [...] + +.SH "DESCRIPTION" +Acme is a fast and simple certificate generator using ACME v2 API. + +.sp +See \fBacme-conf\fR(1) to generate configuration, then see \fBacme-cert\fR(1) to generate your certificate and eventually look at \fBacme-cron\fR(1) to setup the cron job\&. + +.SH "OPTIONS" +.PP +\-\-verbose +.RS 4 +Produces a verbose report about the current process for the purpose of problem analysis\&. +.RE +.PP +\-\-config +.RS 4 +Use the specified configuration file\&. If the pathname is omitted, the file specified in Acme::CONFIG constant (normally /etc/acme/config) is assumed\&. +.RE +.PP +\-\-debian +.RS 4 +Use debian specific path schema in configuration file\&. If omitted, the default redhat path schema is assumed\&. +.RE + +.SH "COMMANDS" +.PP +\fBconf\fR +.RS 4 +Generate configuration, see \fBacme-conf\fR(1) for more details\&. +.RE +.PP +\fBcert\fR +.RS 4 +Generate certificate, see \fBacme-cert\fR(1) for more details\&. +.RE +.PP +\fBcron\fR +.RS 4 +Refresh certificate when needed, see \fBacme-cert\fR(1) for more details\&. +.RE + +.SH "CONTRIBUTE" +You may buy me a Beer, a Tea or help with Server fees with a paypal donation to the address \m[blue]\fBpaypal@rapsys\&.eu\fR\m[] or via the donation page. + +Don't forget to show your love for this project, feel free to report bugs to the author, issues which are security relevant should be disclosed privately first\&. + +Patches are welcomed and grant credit when requested\&. + +.SH "DONATION" +\m[blue]\fBhttps://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=JNWGK8Z2TBHFN\fR\m[] + +.SH "FURTHER DOCUMENTATION" +A formated and hyperlinked copy of the lastest ACME v2 API documentation can be viewed at \fBhttps://ietf-wg-acme\&.github\&.io/acme/draft-ietf-acme-acme\&.html\fR\&. + +.sp +This Acme implementation can be used for Let's Encrypt free, automated and open certificate authority, their documentation can be viewed at \fBhttps://letsencrypt\&.org/docs/\fR\&. + +.SH "AUTHOR" +Raphaël Gertz (Rapsys) + +.SH "BUGS" +No known bugs. + +.SH "SEE ALSO" +\fBacme-conf\fR(1), \fBacme-cert\fR(1), \fBacme-cron\fR(1) + +.SH "ACME" +Part of the \fBacme\fR(1) suite -- 2.41.0