commit ec35ef67414eac54d21490e02bf3d2c7cbf09bcf from: Omar Polo date: Sun Aug 20 08:58:40 2023 UTC update the usage in the manpage commit - 3849bf04dfaff38e3a29b70d8864e17c3feced01 commit + ec35ef67414eac54d21490e02bf3d2c7cbf09bcf blob - c15206e9daee68712d5b2ce327e1318815597e97 blob + 909333d6d163881158348690a7232d74d2ae4bd5 --- icbirc.8 +++ icbirc.8 @@ -1,3 +1,4 @@ +.\" Copyright (c) 2023-2004 Omar Polo .\" Copyright (c) 2003-2004 Daniel Hartmeier. All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without @@ -20,7 +21,7 @@ .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" -.Dd Aug 6, 2003 +.Dd August 20, 2023 .Dt ICBIRC 8 .Os .Sh NAME @@ -28,44 +29,24 @@ .Nd proxy IRC client and ICB server .Sh SYNOPSIS .Nm icbirc -.Op Fl d -.Op Fl l Ar listen-address -.Op Fl p Ar listen-port -.Op Fl s Ar server-name -.Op Fl P Ar server-port +.Ar host Ns Oo : Ns Ar port Oc Ns Oo / Ns Ar room Oc .Sh DESCRIPTION .Nm is a proxy that allows to connect an IRC client to an ICB server. -The proxy accepts client connections, connects to the server, and forwards -data between those two connections. +The proxy talks IRC via standard input and standard output, +so it's suitable to be run with +.Xr inetd 8 , +and connects to the ICB server specified in the command line, optionally +joining automatically a room. .Pp Commands from the IRC client are translated to ICB commands and forwarded to the ICB server. Messages from the ICB server are translated to IRC messages and forwarded to the IRC client. .Pp -The options are as follows: -.Pp -.Bl -tag -width xlxlistenxaddress -.It Fl d -Do not daemonize (detach from controlling terminal) and produce debugging -output on stdout/stderr. -.It Fl l Ar listen-address -Bind to the specified address when listening for client connections. -If not specified, connections to any address are accepted. -.It Fl p Ar listen-port -Bind to the specified port when listening for client connections. -Defaults to 6667 when not specified. -.It Fl s Ar server-name -Hostname or numerical address of the ICB server to connect to. -.It Fl P Ar server-port -Port of the ICB server to connect to. -Defaults to 7326 when not specified. -.El -.Pp Example: .Bd -literal -offset indent -$ icbirc -s default.icb.net +$ icbirc default.icb.net/slackers .Ed .Pp IRC (Internet Relay Chat) and ICB (Internet Citizen's Band) are two separate