From 616a243635c6185e95b5e26417243be8382c1523 Mon Sep 17 00:00:00 2001 From: Curtis McEnroe Date: Fri, 25 Oct 2019 20:35:36 -0400 Subject: Rename project pounce --- .gitignore | 2 +- Makefile | 6 +- README.7 | 6 +- linger.1 | 201 ------------------------------------------------------------- pounce.1 | 201 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 5 files changed, 208 insertions(+), 208 deletions(-) delete mode 100644 linger.1 create mode 100644 pounce.1 diff --git a/.gitignore b/.gitignore index 1532716..1833d1e 100644 --- a/.gitignore +++ b/.gitignore @@ -1,5 +1,5 @@ *.o *.pem config.mk -linger +pounce tags diff --git a/Makefile b/Makefile index 4ebdd0c..c21a1a6 100644 --- a/Makefile +++ b/Makefile @@ -14,9 +14,9 @@ OBJS += ring.o OBJS += server.o OBJS += state.o -all: tags linger +all: tags pounce -linger: ${OBJS} +pounce: ${OBJS} ${CC} ${LDFLAGS} ${OBJS} ${LDLIBS} -o $@ ${OBJS}: bounce.h @@ -25,4 +25,4 @@ tags: *.c *.h ctags -w *.c *.h clean: - rm -f tags linger ${OBJS} + rm -f tags pounce ${OBJS} diff --git a/README.7 b/README.7 index 562dbe6..6223c4f 100644 --- a/README.7 +++ b/README.7 @@ -1,9 +1,9 @@ -.Dd October 22, 2019 +.Dd October 25, 2019 .Dt README 7 .Os "Causal Agency" . .Sh NAME -.Nm linger +.Nm pounce .Nd IRC bouncer . .Sh DESCRIPTION @@ -32,4 +32,4 @@ buffer between server and clients .El . .Sh SEE ALSO -.Xr linger 1 +.Xr pounce 1 diff --git a/linger.1 b/linger.1 deleted file mode 100644 index 1b6c09f..0000000 --- a/linger.1 +++ /dev/null @@ -1,201 +0,0 @@ -.Dd October 24, 2019 -.Dt LINGER 1 -.Os -. -.Sh NAME -.Nm linger -.Nd IRC bouncer -. -.Sh SYNOPSIS -.Nm -.Op Fl v -.Op Fl C Ar cert -.Op Fl H Ar host -.Op Fl K Ar priv -.Op Fl P Ar port -.Op Fl W Ar pass -.Op Fl a Ar auth -.Op Fl h Ar host -.Op Fl j Ar chan -.Op Fl n Ar nick -.Op Fl p Ar port -.Op Fl r Ar real -.Op Fl u Ar user -.Op Fl w Ar pass -. -.Sh DESCRIPTION -The -.Nm -daemon -is a multi-client, TLS-only IRC bouncer. -It maintains a persistent connection to an IRC server -while allowing clients to connect and disconnect, -receiving messages that were missed upon reconnection. -Clients should use the IRCv3.2 server-time extension -to know when missed messages were received -and uniquely identify themselves by username. -. -.Pp -The arguments are as follows: -. -.Bl -tag -width "-C cert" -.It Fl C Ar cert -Load TLS certificate from -.Ar cert . -The default path is -.Pa /usr/local/etc/letsencrypt/live/ Ns Ar host Ns Pa /fullchain.pem -where -.Ar host -is set by -.Fl H . -. -.It Fl H Ar host -Bind to local -.Ar host . -The default host is localhost. -. -.It Fl K Ar priv -Load TLS private key from -.Ar priv . -The default path is -.Pa /usr/local/etc/letsencrypt/live/ Ns Ar host Ns Pa /privkey.pem -where -.Ar host -is set by -.Fl H . -. -.It Fl P Ar port -Bind to local -.Ar port . -The default port is 6697. -. -.It Fl W Ar pass -Require the password -.Ar pass -to connect. -. -.It Fl a Ar auth -Authenticate with SASL PLAIN. -.Ar auth -is a colon-separated username and password. -. -.It Fl h Ar host -Connect to -.Ar host . -. -.It Fl j Ar chan -Join the comma-separated list of -.Ar chan . -. -.It Fl n Ar nick -Set nickname to -.Ar nick . -The default nickname is the user's name. -. -.It Fl p Ar port -Connect to -.Ar port . -The default port is 6697. -. -.It Fl r Ar real -Set realname to -.Ar real . -The default realname is the same as the nickname. -. -.It Fl u Ar user -Set the username to -.Ar user . -The default username is the same as the nickname. -. -.It Fl v -Write IRC messages to standard error -in red to the server, -green from the server, -yellow from clients -and blue to clients. -. -.It Fl w Ar pass -Log in with the password -.Ar pass . -.El -. -.Sh STANDARDS -The -.Nm linger -daemon implements the following: -. -.Bl -item -.It -.Rs -.%A C. Kalt -.%T Internet Relay Chat: Client Protocol -.%I IETF -.%N RFC 2812 -.%D April 2000 -.%U https://tools.ietf.org/html/rfc2812 -.Re -. -.It -.Rs -.%A L. Hardy -.%A E. Brocklesby -.%A K. Mitchell -.%T IRC RPL_ISUPPORT Numeric Definition -.%I IETF -.%D January 2005 -.%U https://tools.ietf.org/html/draft-hardy-irc-isupport-00 -.Re -. -.It -.Rs -.%A Kevin L. Mitchell -.%A Perry Lorier -.%A Lee Hardy -.%A William Pitcock -.%T IRCv3.1 Client Capability Negotiation -.%I IRCv3 Working Group -.%U https://ircv3.net/specs/core/capability-negotiation-3.1.html -.Re -. -.It -.Rs -.%A St\('ephan Kochen -.%A Alexey Sokolov -.%A Kyle Fuller -.%A James Wheare -.%T IRCv3.2 server-time Extension -.%I IRCv3 Working Group -.%U https://ircv3.net/specs/extensions/server-time-3.2 -.Re -. -.It -.Rs -.%A Jilles Tjoelker -.%A William Pitcock -.%T IRCv3.1 SASL Authentication -.%I IRCv3 Working Group -.%U https://ircv3.net/specs/extensions/sasl-3.1.html -.Re -. -.It -.Rs -.%A K. Zeilenga, Ed. -.%Q OpenLDAP Foundation -.%T The PLAIN Simple Authentication and Security Layer (SASL) Mechanism -.%I IETF -.%N RFC 4616 -.%D August 2006 -.%U https://tools.ietf.org/html/rfc4616 -.Re -. -.It -.Rs -.%A S. Josefsson -.%Q SJD -.%T The Base16, Base32, and Base64 Data Encodings -.%I IETF -.%N RFC 4648 -.%D October 2006 -.%U https://tools.ietf.org/html/rfc4648 -.Re -.El diff --git a/pounce.1 b/pounce.1 new file mode 100644 index 0000000..08a5a85 --- /dev/null +++ b/pounce.1 @@ -0,0 +1,201 @@ +.Dd October 25, 2019 +.Dt POUNCE 1 +.Os +. +.Sh NAME +.Nm pounce +.Nd IRC bouncer +. +.Sh SYNOPSIS +.Nm +.Op Fl v +.Op Fl C Ar cert +.Op Fl H Ar host +.Op Fl K Ar priv +.Op Fl P Ar port +.Op Fl W Ar pass +.Op Fl a Ar auth +.Op Fl h Ar host +.Op Fl j Ar chan +.Op Fl n Ar nick +.Op Fl p Ar port +.Op Fl r Ar real +.Op Fl u Ar user +.Op Fl w Ar pass +. +.Sh DESCRIPTION +The +.Nm +daemon +is a multi-client, TLS-only IRC bouncer. +It maintains a persistent connection to an IRC server +while allowing clients to connect and disconnect, +receiving messages that were missed upon reconnection. +Clients should use the IRCv3.2 server-time extension +to know when missed messages were received +and uniquely identify themselves by username. +. +.Pp +The arguments are as follows: +. +.Bl -tag -width "-C cert" +.It Fl C Ar cert +Load TLS certificate from +.Ar cert . +The default path is +.Pa /usr/local/etc/letsencrypt/live/ Ns Ar host Ns Pa /fullchain.pem +where +.Ar host +is set by +.Fl H . +. +.It Fl H Ar host +Bind to local +.Ar host . +The default host is localhost. +. +.It Fl K Ar priv +Load TLS private key from +.Ar priv . +The default path is +.Pa /usr/local/etc/letsencrypt/live/ Ns Ar host Ns Pa /privkey.pem +where +.Ar host +is set by +.Fl H . +. +.It Fl P Ar port +Bind to local +.Ar port . +The default port is 6697. +. +.It Fl W Ar pass +Require the password +.Ar pass +to connect. +. +.It Fl a Ar auth +Authenticate with SASL PLAIN. +.Ar auth +is a colon-separated username and password. +. +.It Fl h Ar host +Connect to +.Ar host . +. +.It Fl j Ar chan +Join the comma-separated list of +.Ar chan . +. +.It Fl n Ar nick +Set nickname to +.Ar nick . +The default nickname is the user's name. +. +.It Fl p Ar port +Connect to +.Ar port . +The default port is 6697. +. +.It Fl r Ar real +Set realname to +.Ar real . +The default realname is the same as the nickname. +. +.It Fl u Ar user +Set the username to +.Ar user . +The default username is the same as the nickname. +. +.It Fl v +Write IRC messages to standard error +in red to the server, +green from the server, +yellow from clients +and blue to clients. +. +.It Fl w Ar pass +Log in with the password +.Ar pass . +.El +. +.Sh STANDARDS +The +.Nm +daemon implements the following: +. +.Bl -item +.It +.Rs +.%A C. Kalt +.%T Internet Relay Chat: Client Protocol +.%I IETF +.%N RFC 2812 +.%D April 2000 +.%U https://tools.ietf.org/html/rfc2812 +.Re +. +.It +.Rs +.%A L. Hardy +.%A E. Brocklesby +.%A K. Mitchell +.%T IRC RPL_ISUPPORT Numeric Definition +.%I IETF +.%D January 2005 +.%U https://tools.ietf.org/html/draft-hardy-irc-isupport-00 +.Re +. +.It +.Rs +.%A Kevin L. Mitchell +.%A Perry Lorier +.%A Lee Hardy +.%A William Pitcock +.%T IRCv3.1 Client Capability Negotiation +.%I IRCv3 Working Group +.%U https://ircv3.net/specs/core/capability-negotiation-3.1.html +.Re +. +.It +.Rs +.%A St\('ephan Kochen +.%A Alexey Sokolov +.%A Kyle Fuller +.%A James Wheare +.%T IRCv3.2 server-time Extension +.%I IRCv3 Working Group +.%U https://ircv3.net/specs/extensions/server-time-3.2 +.Re +. +.It +.Rs +.%A Jilles Tjoelker +.%A William Pitcock +.%T IRCv3.1 SASL Authentication +.%I IRCv3 Working Group +.%U https://ircv3.net/specs/extensions/sasl-3.1.html +.Re +. +.It +.Rs +.%A K. Zeilenga, Ed. +.%Q OpenLDAP Foundation +.%T The PLAIN Simple Authentication and Security Layer (SASL) Mechanism +.%I IETF +.%N RFC 4616 +.%D August 2006 +.%U https://tools.ietf.org/html/rfc4616 +.Re +. +.It +.Rs +.%A S. Josefsson +.%Q SJD +.%T The Base16, Base32, and Base64 Data Encodings +.%I IETF +.%N RFC 4648 +.%D October 2006 +.%U https://tools.ietf.org/html/rfc4648 +.Re +.El -- cgit 1.4.1