finga
12b117db7e
To supporte more than a single log level `log` and `env_logger` crates are used. For the application to support the different type of argument, the verbose argument definition was adapted.
193 lines
3.4 KiB
Groff
193 lines
3.4 KiB
Groff
.\" Manpage for mqrs
|
|
.TH man 1 "27 June 2021" "0.1.1" "mqrs man page"
|
|
.SH NAME
|
|
mqrs \- Handle POSIX message queues
|
|
.SH SYNOPSIS
|
|
.B mqrs [\-h] [\-\-help] [\-v] [\-\-verbose] [\-V] [\-\-version] [SUBCOMMAND]
|
|
.SH DESCRIPTION
|
|
.B mqrs
|
|
is a small cli program to handle POSIX message queues. Supported commands are
|
|
.B create\
|
|
,
|
|
.B info\
|
|
,
|
|
.B unlink\
|
|
,
|
|
.B send
|
|
and
|
|
.B recv
|
|
.
|
|
All commands do not have to be specified fully. If the command is
|
|
clearly distinguishable from all the others, it does not have to be
|
|
completed further.
|
|
.SH OPTIONS
|
|
.TP 8
|
|
.B \-h, \-\-help
|
|
Prints help information
|
|
.TP 8
|
|
.B \-v, \-\-verbose
|
|
Produce verbose output, multiple -v options increase the verbosity
|
|
(max. 3)
|
|
.TP 8
|
|
.B \-V, \-\-version
|
|
Prints version information
|
|
.SH SUBCOMMANDS
|
|
.SS create [FLAGS] [OPTIONS] \fI<QUEUE>\fP
|
|
Create a new POSIX message queue.
|
|
.TP 8
|
|
.SS ARGS
|
|
.RS
|
|
.TP 8
|
|
.B \fI<QUEUE>\fP
|
|
Name of the new queue
|
|
.RE
|
|
.TP 8
|
|
.SS FLAGS
|
|
.RS
|
|
.TP 8
|
|
.B \-h, \-\-help
|
|
Prints help information
|
|
.TP 8
|
|
.B \-v, \-\-verbose
|
|
Produce verbose output
|
|
.TP 8
|
|
.SS OPTIONS
|
|
.RS
|
|
.B \-c, \-\-capacity \fI<capacity>\fP
|
|
Maximum number of messages in the queue
|
|
.TP 8
|
|
.B \-s, \-\-msgsize \fI<msgsize>\fP
|
|
Message size in bytes
|
|
.TP 8
|
|
.B \-p, \-\-permissions \fI<permissions>\fP
|
|
Permissions (octal) to create the queue with
|
|
.RE
|
|
.SS help [SUBCOMMAND]
|
|
Prints this message or the help of the given subcommand.
|
|
.TP 8
|
|
.SS ARGS
|
|
.RS
|
|
.TP 8
|
|
.B \fI<SUBCOMMAND>\fP
|
|
Show help for \fISUBCOMMAND\fP
|
|
.RE
|
|
.SS info [FLAGS] \fI<QUEUE>\fP
|
|
Print further information about an existing message queue.
|
|
.TP 8
|
|
.SS ARGS
|
|
.RS
|
|
.TP 8
|
|
.B \fI<QUEUE>\fP
|
|
Name of the queue
|
|
.RE
|
|
.TP 8
|
|
.SS FLAGS
|
|
.RS
|
|
.TP 8
|
|
.B \-h, \-\-help
|
|
Prints help information
|
|
.TP 8
|
|
.B \-v, \-\-verbose
|
|
Produce verbose output
|
|
.RE
|
|
.SS recv [FLAGS] [OPTIONS] \fI<QUEUE>\fP
|
|
Receive and print one or more messages message from a message queue.
|
|
.TP 8
|
|
.SS ARGS
|
|
.RS
|
|
.TP 8
|
|
.B \fI<QUEUE>\fP
|
|
Name of the queue
|
|
.RE
|
|
.TP 8
|
|
.SS FLAGS
|
|
.RS
|
|
.TP 8
|
|
.B \-f, \-\-follow
|
|
Print messages as they are received
|
|
.TP 8
|
|
.B \-h, \-\-help
|
|
Prints help information
|
|
.TP 8
|
|
.B \-n, \-\-non\-blocking
|
|
Do not block
|
|
.TP 8
|
|
.B \-t, \-\-timestamp
|
|
Print a timestamp before each message
|
|
.TP 8
|
|
.B \-v, \-\-verbose
|
|
Produce verbose output
|
|
.RE
|
|
.TP 8
|
|
.SS OPTIONS
|
|
.RS
|
|
.TP 8
|
|
.B \-d, \-\-deadline \fI<deadline>\fP
|
|
Deadline until messages are received (format: "%Y-%m-%d %H:%M:%S")
|
|
.TP 8
|
|
.B \-o, \-\-timeout \fI<timeout>\fP
|
|
Timeout as for example in "5h 23min 42ms"
|
|
.RE
|
|
.SS send [FLAGS] [OPTIONS] \fI<QUEUE>\fP \fI<MESSAGE>\fP
|
|
Send a message to a message queue.
|
|
.TP 8
|
|
.SS ARGS
|
|
.RS
|
|
.TP 8
|
|
.B \fI<QUEUE>\fP
|
|
Name of the queue
|
|
.TP 8
|
|
.B \fI<MESSAGE>\fP
|
|
Message to be sent to the queue
|
|
.RE
|
|
.TP 8
|
|
.SS FLAGS
|
|
.RS
|
|
.TP 8
|
|
.B \-h, \-\-help
|
|
Prints help information
|
|
.TP 8
|
|
.B \-n, \-\-non\-blocking
|
|
Do not block
|
|
.TP 8
|
|
.B \-v, \-\-verbose
|
|
Produce verbose output
|
|
.RE
|
|
.TP 8
|
|
.SS OPTIONS
|
|
.RS
|
|
.TP 8
|
|
.B \-d, \-\-deadline \fI<deadline>\fP
|
|
Deadline until messages are received (format: "%Y-%m-%d %H:%M:%S")
|
|
.TP 8
|
|
.B \-p, \-\-priority \fI<priority>\fP
|
|
Set a different priority than default, priority >= 0 [default: 0]
|
|
.TP 8
|
|
.B \-o, \-\-timeout \fI<timeout>\fP
|
|
Timeout as for example in "5h 23min 42ms"
|
|
.RE
|
|
.SS unlink [FLAGS] \fI<QUEUE>\fP
|
|
Deletes an existing POSIX message queue.
|
|
.TP 8
|
|
.SS ARGS
|
|
.RS
|
|
.TP 8
|
|
.B \fI<QUEUE>\fP
|
|
Name of the queue
|
|
.RE
|
|
.TP 8
|
|
.SS FLAGS
|
|
.RS
|
|
.TP 8
|
|
.B \-h, \-\-help
|
|
Prints help information
|
|
.TP 8
|
|
.B \-v, \-\-verbose
|
|
Produce verbose output
|
|
.RE
|
|
.SH SEE ALSO
|
|
mq_overview(7)
|
|
.SH BUGS
|
|
No known bugs.
|
|
.SH AUTHOR
|
|
finga (mqrs@onders.org)
|