about summary refs log tree commit diff
SCOOP(1) FreeBSD General Commands Manual SCOOP(1)

query IRC logs

scoop [-Lgpqsv] [-D date] [-F format] [-N network] [-T target] [-a time] [-b time] [-c context] [-d path] [-f format] [-h host] [-l limit] [-m regexp] [-n nick] [-t type] [-u user] [-w expr] [search]

scoop -S

The scoop utility queries the litterbox(1) IRC log database, matching events on the intersection of the criteria specified in arguments.

If standard output is a terminal, colored output is piped to PAGER with LESS=FRX if it is not already set.

The arguments are as follows:

Match events which occurred on date, of the format YYYY-MM-DD or the keyword now.
Format timestamps using the format string, similar to strftime(3), see ⟨https://www.sqlite.org/lang_datefunc.html⟩. The default format is ISO 8601.
Output timestamps in local time.
Match events from network.
Instead of performing a query, launch the sqlite3(1) shell for the database.
Match events (of type kick, nick or ban) with the target nickname or mask target.
Match events which occurred after time, of the format YYYY-MM-DD HH:MM:SS.
Match events which occurred before time, of the format YYYY-MM-DD HH:MM:SS.
Match events from context, either a channel or query name.
Set the database path. The default path is as in litterbox(1).
Set the output format to one of plain, color, irc. The irc format outputs events as IRC protocol with server-time tags. The default format is color if standard output is a terminal, plain otherwise.
Group events by network and channel or query name. Implies -s.
Match events from users with the hostname host.
Limit the number of events matched, ordered by most recent. Implies -s.
Match events with messages matching the modern regular expression regexp. See re_format(7).
Match events from users with the nickname nick.
Match only events from channels.
Match only events from queries.
Sort the results from oldest to newest. By default events are output in the order they appear in the database.
Match events of type. The types are privmsg, notice, action, join, part, quit, kick, nick, topic, ban, unban.
Match events from users with the username user.
Print the expanded SQL query being used to standard error.
Add the SQL expression expr to the WHERE clause of the query.
Match events using full-text search. The searchable columns are network, channel, query, nick, user, target, message. For search query syntax, see ⟨https://www.sqlite.org/fts5.html#full_text_query_syntax⟩.

The command to pipe terminal output to. The default is PAGER=less.
The shell used to run PAGER. The default is /bin/sh.


June Bug <june@causal.agency>

Send mail to <list+litterbox@causal.agency> or join #ascii.town on chat.freenode.net.
May 20, 2020 FreeBSD 12.2-RELEASE-p1