.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.3.
.TH RECSEL "1" "February 2024" "GNU recutils 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.