query - Query messages¶
halonctl query [HQL query]
The query module queries mail, either from the queue (default) or history, and optionally performs actions on them. For more information about HQL query syntax, see this wiki page.
- -r --history¶
Query the message history, rather than queued messages.
- -n --limit n¶
Show a maximum of n results.
The shorthand form is -n rather than -l to mimic the tail command.
- -o --offset n¶
Skip n results. Useful in conjunction with --limit.
- -c --count¶
Show total number of results (not restricted by --limit).
Aside from taking times as UTC UNIX Timestamps, halonctl offers a simpler way to specify timestamps:
Note that for safety reasons, you must specify which timezone you’re referring to when using this format - it’d be pretty bad if you ended up targeting the wrong set of data, because the server and your computer are in different timezones.
- -t --timezone¶
Any placeholders in the query are in this timezone, specified as a UTC offset.
Example: -t 1 would mean the timestamp is in UTC+1/GMT+1 (Sweden, Germany, ...)
- -u --utc¶
Alias for -t 0.
You can specify an action to be taken on the matched messages, instead of just displaying a list of them. Only one action can be used at a time.
Delete all matched messages on the spot.
There is no way to un-delete a deleted message, so use this with caution.
Attempt to deliver all matched messages immediately.
Attempt to deliver all matched messages immediately, but keep a copy in the queue.
Useful for certain kinds of quarantine or backup/archive setups.
- -y --yes¶
Don’t ask for confirmation before performing actions on all messages.
Only use this if you’re absolutely sure what you’re doing.
- -f --fields f1,f2,f3,...¶
Display the given fields (columns), separated by comma (,).
The special value - will display ALL available fields, including ones hidden by default.