Skip to content

Latest commit

 

History

History
175 lines (175 loc) · 6.02 KB

justgrep.1.md

File metadata and controls

175 lines (175 loc) · 6.02 KB
JUSTGREP(1) justgrep IRC tools JUSTGREP(1)
justgrep - Tool for scanning justlog logs justgrep [options] -channel channel name -url https://example.com -regex regular expression -start 2021-01-01T00:00:00Z [-end 2021-02-01T00:00:00Z]
 
justgrep [options] -r -url https://example.com -regex regular expression -start 2021-01-01T00:00:00Z [ -end 2021-02-01T00:00:00Z]
This tool searches the desired justlog instance for a regular expression or username regular expression in a set time range.
-channel channel name
Pick desired channel to search.
-r
Run search on all channels available on the desired justlog instance. Overrides -channel.
-max count
Choose how many messages should be returned by justgrep.
-start, -end TIME
Allow you to specify the time range to search. -end should be the later part of the range. -end defaults to the current date/time if not given. -start is required. Accepted formats are:
1 2006-01-02 15:04:05
2 2006-01-02 15:04:05-07:00
3 2006-01-02T15:04:05Z07:00 (RFC3339)
-user name
Search logs for a single user. If -uregex is used in combination, name is treated as a regular expression. It's worth noting that search a single user's logs is much faster than a whole channel.
-notuser name
Ignores user identified by name from log searches. If -uregex is used in combination, name is treated as a regular expression. It's worth noting that search a single user's logs is much faster than a whole channel. If the name isn't a regex and begins with #, it will be treated as a user id.
-uregex
Switches -user and -notuser to be treated as a regular expression instead of literally.
-regex regular expression
Searches messages for the pattern. This option is required.
-url justlog instance url
Selects your desired justlog instance. By default it's http://localhost:8025, the default listen address for justlog.
-v
Shows you progress info on stderr. Not allowed with -progress-json.
-progress-json
Returns the same information as -v but in JSON format for machine processing. Also uses stderr. Not allowed with -v.
-msg-only
Deprecated: use -msg-types PRIVMSG instead.
Makes justgrep return only user chat messages, PRIVMSGs.
-msg-types
Makes justgrep return only certain messages based on the IRC command/action. Putting the most command types first might speed up your search slightly.
Fetch all messages matching pajaS from 2021-12-01 to 2021-12-07 (inclusive) from channel pajlada from justlog instance:

justgrep -channel pajlada -regex "pajaS" -start 2021-12-01T00:00:00Z -end 2021-12-07T23:59:59Z -url [justlog instance]

Fetch all messages matching pajaS from 2021-12-01 until now from channel pajlada from justlog instance:

justgrep -channel pajlada -regex "pajaS" -start 2021-12-01T00:00:00Z -url [justlog instance]

Fetch all timeouts matching from 2021-12-01 to 2021-12-07 (inclusive) from channel pajlada from justlog instance:

justgrep -channel pajlada -msg-types CLEARCHAT -start 2021-12-01T00:00:00Z -end 2021-12-07T23:59:59Z -url [justlog instance]

irc2json(1)
2021-12-23 Mm2PL