From 44aa40b65c3d55f7ad6d5e2b51cd7885a3f5a3db Mon Sep 17 00:00:00 2001 From: "C. McEnroe" Date: Fri, 15 Oct 2021 17:42:11 -0400 Subject: Add back pounce EXAMPLES section --- pounce.1 | 47 +++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 47 insertions(+) diff --git a/pounce.1 b/pounce.1 index 76bd63d..c81c615 100644 --- a/pounce.1 +++ b/pounce.1 @@ -646,6 +646,53 @@ New save files are created in The most likely location of save files. .El . +.Sh EXAMPLES +Start +.Nm : +.Bd -literal -offset indent +$ pounce -H irc.example.org -h irc.tilde.chat -j '#ascii.town' +.Ed +.Pp +Write an equivalent configuration file to +.Pa ~/.config/pounce/tilde.conf : +.Bd -literal -offset indent +local-host = irc.example.org +host = irc.tilde.chat +join = #ascii.town +.Ed +.Pp +Load the configuration file: +.Bd -literal -offset indent +$ pounce tilde.conf +.Ed +. +.Pp +Add a certificate to +.Xr acme-client.conf 5 : +.Bd -literal -offset indent +domain irc.example.org { + domain key "/home/user/.config/pounce/irc.example.org.key" + domain full chain certificate \e + "/home/user/.config/pounce/irc.example.org.pem" + sign with letsencrypt +} +.Ed +.Pp +Obtain the certificate +and make the private key readable by +.Nm : +.Bd -literal -offset indent +# acme-client irc.example.org +# chown user /home/user/.config/pounce/irc.example.org.key +.Ed +.Pp +Renew and reload the certificate with a +.Xr cron 8 +job: +.Bd -literal -offset indent +~ * * * * acme-client irc.example.org && pkill -USR1 pounce +.Ed +. .Sh DIAGNOSTICS Upon receiving the .Dv SIGINFO -- cgit 1.4.1 nput type='hidden' name='id' value='e6759139de296ac8dba53ecdaead4414bc9ebb67'/>
path: root/Makefile (unfollow)
Commit message (Expand)Author
2021-09-05Clarify parts of the manualJune McEnroe
2021-09-03OpenBSD: Drop inet pledge when using unix socketJune McEnroe
2021-09-03OpenBSD: Drop no longer needed unveils and pledge promisesJune McEnroe
2021-09-03Reorder file loading in mainJune McEnroe
2021-09-02Be nice and call tls_close(3) on the serverJune McEnroe
2021-09-02Separate client QUIT and ERROR messagesJune McEnroe
2021-09-02Remove redundant clientDiff functionJune McEnroe
2021-09-02OpenBSD: pledge(2) the genCert code pathJune McEnroe
2021-09-02OpenBSD: pledge(2) the hashPass code pathJune McEnroe
2021-09-02OpenBSD: pledge(2) printCert code path separatelyJune McEnroe
2021-09-02Call serverConfig() with NULLs for -oJune McEnroe
2021-09-02Read from /dev/urandom instead of using getentropy(3)June McEnroe
2021-08-31Separate stateSync intro messagesJune McEnroe
2021-08-30Correct handling of colons in SASL PLAINJune McEnroe
2021-08-28Declare producer staticJune McEnroe
2021-08-28Use CapBits as length of FiltersJune McEnroe
2021-08-21Don't create new tls_server(3), just reconfigureJune McEnroe
2021-08-21Zero local-key memory before freeing itJune McEnroe
2021-08-21Avoid overwriting manual AWAY messagesJune McEnroe
2021-08-20Replace verbose colors with two types of arrowsJune McEnroe
2021-08-20Explicitly clear TLS secrets after handshakeJune McEnroe
2021-08-20Handle TLS_WANT_POLL{IN,OUT} from tls_handshake(3) with serverJune McEnroe
2021-08-20Use "secure" libtls ciphersJune McEnroe
2021-07-08Use seprintf to build final 005June McEnroe
2021-06-19Fix LDADD.crypt on DarwinJune McEnroe
2021-06-18Add -m mode option to set user modesJune McEnroe
2021-06-18Document channel keys in join optionJune McEnroe
2021-06-18Use | to separate flags from config optionsJune McEnroe
2021-06-18Stop referring to server-time as IRCv3.2June McEnroe
2021-06-17Add mailing list archive to READMEJune McEnroe
2021-06-10Stop accumulating ISUPPORT tokens once MOTD startsJune McEnroe
2021-06-09Use seprintf for snip, removing strlcpynJune McEnroe
2021-06-09Use seprintf for reserializeJune McEnroe
2021-06-09Use seprintf for capListJune McEnroe
2021-06-09Add seprintfJune McEnroe
2021-05-27Add pounce-notify to README 2.4June McEnroe
2021-05-27Fix ENVIRONMENT formatting in pounce-notify(1)June McEnroe
2021-05-27Add note about Libera.Chat SASL-only rangesJune McEnroe
2021-05-25Add QUIRKS fileJune McEnroe
2021-05-19Replace freenode with tilde.chatJune McEnroe
2021-05-04notify: Reword pounce-notify manualJune McEnroe
2021-05-02Clean up Makefiles, configure scriptsJune McEnroe
2021-04-30palaver: Exit on getopt failureJune McEnroe
2021-04-30notify: Implement pounce-notifyJune McEnroe