highlight: keep C1 controls intact

this pretty obviously broke utf8.

add license (gplv3)

tune connect and setup timeouts

it seems some servers have their 'Checking Ident'/'No Ident response'
timeout also at roughly 15 seconds, so this can cause a race. giving
sockets ten seconds for connect to succeed felt too generous.

add examples, split out caveats, and other readme improvements

implement 'display version' command line switch

intentionally undocumented.

make highlight strip control characters

excluding \r \n, of course. this could easily have been a seperate
output filter (something like `tr -d '[:cntrl:]'` modulo CR/LF).

Provide the beginnings of some proper documentation

this replaces spec.txt, which was just a loose collection of thoughts.

clean up makefile

Revert "allow building without libtls"

this is extremely ugly. by keeping in the revision history, it should be
cherry-pickable when so desired.

This reverts commit 15803f20b91e3dc483fa35c58c2d4267e5f19488.

allow building without libtls

implement setup timeout

our current handling of only a specific set of error numerics makes us
vulnerable to hangs, when an unexpected code was received. we should
really respect a response timeout here (which must be quite large due to
ident!)

note that connect timeout is not handled by this (but by setsockopt);
it's a bit unfortunate that when that triggers, errno is EINPROGRESS
("Operation now in progress"), as that's a bit confusing.

Revert "send all initialization commands at once"

nope, causes hangs.

This reverts commit c92baa7c54cfc57df2bbd9ca2df9e79bddb9cc3a.

send all initialization commands at once

there should be no need to wait for RPL_WELCOME before sending a JOIN
message.

move todos from spec file to todon'ts

clean up some todos

the thing regarding tls_default_ca_cert_file was wrong and is never
needed. EPIPE et al are already "handled" that way. i (foolishly?) don't
expect EINTR or EAGAIN, given that we call poll immediately before.
the sasl todo isn't that important, as we only support plain password
auth with sasl and we don't expect passphrases longer than 300 chars (if
this were violated, the server would just fail our auth attempt with
ERR_SASLTOOLONG/905 (at which point we'd hang, until we implement proper
timeouts during setup. too bad.)).

params cannot be empty

... because we always append a final argument, even if it's the empty
string. there actually is a slight bug with empty line or ones with
only a prefix here (command becomes b""), but these are broken anyways.

highlight: make sure own nick is delimetered properly

simplify nick highlighting logic

it's sufficient to highlight the first occurence per line to draw
attention to it.

provide a tool to highlight irc protocol messages

this can be used as a bare-bones irc client like so:
  IRC_PASSWD=... ./ircpipe -n $NICK -p -s $BOUNCER_HOST | ./highlight | ts
('ts' being the timestamping tool from moreutils)

the code for this looks a bit wonky, but that's kind of on purpose:
while we first parse the message, we then not use this for actual output
and instead slice the raw line and splice in control sequences, as to
not accidentally modify the input; copy-pasting from it should yield the
same bytes as it processed (modulo mIRC style color control chars).
using bytes instead of native strings is necessary as to not break on
non-utf8-encoded messages, something that regularly happens in practise.

deduplicate blocking for irc response during setup

fix segfault on D-line

when connecting to irc.efnet.nl we get banned after RPL_WELCOME. the
whole (looong) MOTD loads, then we get ERR_YOUREBANNEDCREEP and a fatal
ERROR and the server closes the connection.
this bug manifested, when setting '-j', that poll (ircpipe.c:246)
returns revents == POLLHUP|POLLIN (while we expected only POLLIN). when
read(2)ing from the now-closed socket, we then read 0 bytes. in
irc_answer (ircpipe.c:260), strtok_r then returns NULL on the first
invocation (which again we did not expect, as we did not expect an empty
buffer to get passed). then we tried to look at the first character of
the string, dereferencing NULL and causing a SIGSEGV.

the solution is of course to check that return value of read(2) is > 0.
this is equivalent to aborting on POLLHUP; the comment in irc_poll() has
been adjusted to reflect this as well.

add LF to error message

document non-filtering of escape sequences

free TLS context after closing

as per libretls docs.

update ircpipe spec document

note that joining multiple channels doesn't need special handling; c.f.
     Command: JOIN
  Parameters: <channel>{,<channel>} [<key>{,<key>}]
  Alt Params: 0
one can just say `-j '#chan1,#chan2`. even protected channels work:
  -j '#chan1,#chan2 key1,key2'

improve PONG sending

this gets rid of the double-send(2) (which in theory allows us to enable
Nagle's TCP_NODELAY). we need to restore the line terminator that strtok
removed. while the spec says we should send \r\n, it would probably
suffice to non-compliantly just do line[n] = '\n' (and rely on postel's
law to save us). but strtok only overwrites the first delimeter;
transforming "...\n..." into "...\0..." and "...\r\n..." into
"...\0\n...". so by looking ahead one byte we can determine which
terminator(s) were sent by the server and send back the same one(s). of
course, this doesn't hold for \n\r, just \r or \n\n (neither of which we
expect), but it would fall back to a sensible form regardless.

simplify error messages for non-syscalls

makes no sense to simulate perror for that kind of error.

implement socket timeout on connect

before this, we could have hung connecting to unavailable servers for
essentially ever. we only set SO_SNDTIMEO (not SO_RCVTIMEO) as we only
care when packets we send don't get ACKed in time (more specifically, we
only care about the server ACKing our initial SYN), not when the server
stops sending data for a while (the latter we handle using PING/PONG
ourselves).

c.f. https://stackoverflow.com/a/4182564. should cause EINPROGRESS for
connect(2), EAGAIN or EWOULDBLOCK otherwise.

implement handler for the usual terminating signals

right now, we just send /QUIT and cleanly shut down the socket. in the
future, this allows us to do something to the socket on SIGUSR{1,2}, for
example.

initiate PING if socket idles for too long

note that we only start tracking the monotonic timestamp of last
incoming socket activity in irc_poll(). because of that, we must
initialize recv_ts or we risk never sending the first PING when the
server doesn't send anything after the 001 numeric (e.g. znc with no
joined channels).

there isn't really a reason to configure ping interval/pong timeout, so
we just pick some values.

simplify sasl handling

note that we still don't support multiple SASL chunks; the error
handling was just removed from irc_base64() (OR_DIE is incompatible with
assignment). we should probably verify this constraint in main().

directly exit from irc_answer() on error, improve error handling

e.g. ERR_YOUREBANNEDCREEP (465) is sent after 001 but before JOIN.

NULL-terminate read() calls

we reuse the samme buffer for all network and local read(2)s. irc_answer
(or more specifically, strtok(3)) expects NULL-terminated strings. this
caused us to re-parse older strings when the buffer shrank between two
consecutive read(2) calls.

rework irc_answer to catch specific error replies and exit when encountered

we still need to pass the error line to the OR_DIE_irc macro, so it's
displayed on stderr (stdout is likely redirected).

rename PORT_PLAIN to PORT_TCP

partially revert IRCv3 USER

tilde prefixing to disable ident lookup seems to not be supported by
libera, so don't bother.

use IRCv3 USER command

* mode must be '0'
* if the client's host does not expose an ident server, the username
  should be prefixed by '~'

living standard document: https://modern.ircdocs.horse/#user-message

switch to RFC2812 style USER command

we don't (yet?) allow setting user mode, though.

implement TLS_WANT_POLL{IN,OUT}

we always listen for POLLIN events, so we don't need to explicitly check
for it. not sure if this implementation is correct. modeled after
https://github.com/openbsd/src/blob/master/usr.bin/nc/netcat.c

defend against malformed messages

if a message consists of only the prefix, we'd overrun the buffer.

document password and tls related flags

implement TLS support using libtls or libretls

also fixes some c90 related pedantic warnings and improves error
messages for bad or missing cli parameters.

remove debug printfs

use getaddrinfo() for transparent ipv4/6 support

introduces a malloc :(

fix polling standard input

support server password (PASS message)

initial commit