105 lines
3.0 KiB
Groff
105 lines
3.0 KiB
Groff
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.4.
|
|
.TH RECSEL "1" "April 2022" "recsel 1.9" "User Commands"
|
|
.SH NAME
|
|
recsel \- print records from a recfile
|
|
.SH SYNOPSIS
|
|
.B recsel
|
|
[\fI\,OPTION\/\fR]... [\fI\,-t TYPE\/\fR] [\fI\,-j FIELD\/\fR] [\fI\,-n INDEXES | -e RECORD_EXPR | -q STR | -m NUM\/\fR] [\fI\,-c | (-p|-P) FIELD_EXPR\/\fR] [\fI\,FILE\/\fR]...
|
|
.SH DESCRIPTION
|
|
Select and print rec data.
|
|
.TP
|
|
\fB\-d\fR, \fB\-\-include\-descriptors\fR
|
|
print record descriptors along with the matched
|
|
records.
|
|
.TP
|
|
\fB\-C\fR, \fB\-\-collapse\fR
|
|
do not section the result in records with newlines.
|
|
.TP
|
|
\fB\-S\fR, \fB\-\-sort\fR=\fI\,FIELD\/\fR,...
|
|
sort the output by the specified fields.
|
|
.TP
|
|
\fB\-G\fR, \fB\-\-group\-by\fR=\fI\,FIELD\/\fR,...
|
|
group records by the specified fields.
|
|
.TP
|
|
\fB\-U\fR, \fB\-\-uniq\fR
|
|
remove duplicated fields in the output records.
|
|
.TP
|
|
\fB\-s\fR, \fB\-\-password\fR=\fI\,STR\/\fR
|
|
decrypt confidential fields with the given password.
|
|
.TP
|
|
\fB\-\-help\fR
|
|
print a help message and exit.
|
|
.TP
|
|
\fB\-\-version\fR
|
|
show version and exit.
|
|
.SS "Record selection options:"
|
|
.TP
|
|
\fB\-i\fR, \fB\-\-case\-insensitive\fR
|
|
make strings case\-insensitive in selection
|
|
expressions.
|
|
.TP
|
|
\fB\-t\fR, \fB\-\-type\fR=\fI\,TYPE\/\fR
|
|
operate on records of the specified type only.
|
|
.TP
|
|
\fB\-e\fR, \fB\-\-expression\fR=\fI\,RECORD_EXPR\/\fR
|
|
selection expression.
|
|
.TP
|
|
\fB\-q\fR, \fB\-\-quick\fR=\fI\,STR\/\fR
|
|
select records with fields containing a string.
|
|
.TP
|
|
\fB\-n\fR, \fB\-\-number\fR=\fI\,NUM\/\fR,...
|
|
select specific records by position, with ranges.
|
|
.TP
|
|
\fB\-m\fR, \fB\-\-random\fR=\fI\,NUM\/\fR
|
|
select a given number of random records.
|
|
.TP
|
|
\fB\-j\fR, \fB\-\-join\fR=\fI\,FIELD\/\fR
|
|
perform an inner join using the specified field.
|
|
.SS "Output options:"
|
|
.TP
|
|
\fB\-p\fR, \fB\-\-print\fR=\fI\,FIELDS\/\fR
|
|
comma\-separated list of fields to print for each
|
|
matching record.
|
|
.TP
|
|
\fB\-P\fR, \fB\-\-print\-values\fR=\fI\,FIELDS\/\fR
|
|
as \fB\-p\fR, but print only the values of the selected
|
|
fields.
|
|
.TP
|
|
\fB\-R\fR, \fB\-\-print\-row\fR=\fI\,FIELDS\/\fR
|
|
as \fB\-P\fR, but separate the values with spaces instead
|
|
of newlines.
|
|
.TP
|
|
\fB\-c\fR, \fB\-\-count\fR
|
|
print a count of the matching records instead of
|
|
the records themselves.
|
|
.SS "Special options:"
|
|
.TP
|
|
\fB\-\-print\-sexps\fR
|
|
print the data in sexps instead of rec format.
|
|
.SH AUTHOR
|
|
Written by Jose E. Marchesi.
|
|
.SH "REPORTING BUGS"
|
|
Report bugs to: bug\-recutils@gnu.org
|
|
.br
|
|
GNU recutils home page: <https://www.gnu.org/software/recutils/>
|
|
.br
|
|
General help using GNU software: <http://www.gnu.org/gethelp/>
|
|
.SH COPYRIGHT
|
|
Copyright \(co 2010\-2020 Jose E. Marchesi.
|
|
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
|
|
.br
|
|
This is free software: you are free to change and redistribute it.
|
|
There is NO WARRANTY, to the extent permitted by law.
|
|
.SH "SEE ALSO"
|
|
The full documentation for
|
|
.B recsel
|
|
is maintained as a Texinfo manual. If the
|
|
.B info
|
|
and
|
|
.B recsel
|
|
programs are properly installed at your site, the command
|
|
.IP
|
|
.B info recutils
|
|
.PP
|
|
should give you access to the complete manual.
|