Your company here — click to reach over 10,000 unique daily visitors

recsel - Man Page

print records from a recfile

Examples (TL;DR)


recsel [OPTION]... [-t TYPE] [-j FIELD] [-n INDEXES | -e RECORD_EXPR | -q STR | -m NUM] [-c | (-p|-P) FIELD_EXPR] [FILE]...


Select and print rec data.

-d,  --include-descriptors

print record descriptors along with the matched records.

-C,  --collapse

do not section the result in records with newlines.

-S,  --sort=FIELD,...

sort the output by the specified fields.

-G,  --group-by=FIELD,...

group records by the specified fields.

-U,  --uniq

remove duplicated fields in the output records.

-s,  --password=STR

decrypt confidential fields with the given password.


print a help message and exit.


show version and exit.

Record selection options

-i,  --case-insensitive

make strings case-insensitive in selection expressions.

-t,  --type=TYPE

operate on records of the specified type only.

-e,  --expression=RECORD_EXPR

selection expression.

-q,  --quick=STR

select records with fields containing a string.

-n,  --number=NUM,...

select specific records by position, with ranges.

-m,  --random=NUM

select a given number of random records.

-j,  --join=FIELD

perform an inner join using the specified field.

Output options

-p,  --print=FIELDS

comma-separated list of fields to print for each matching record.

-P,  --print-values=FIELDS

as -p, but print only the values of the selected fields.

-R,  --print-row=FIELDS

as -P, but separate the values with spaces instead of newlines.

-c,  --count

print a count of the matching records instead of the records themselves.

Special options


print the data in sexps instead of rec format.


Written by Jose E. Marchesi.

Reporting Bugs

Report bugs to: bug-recutils@gnu.org
GNU recutils home page: <https://www.gnu.org/software/recutils/>
General help using GNU software: <http://www.gnu.org/gethelp/>

See Also

The full documentation for recsel is maintained as a Texinfo manual.  If the info and recsel programs are properly installed at your site, the command

info recutils

should give you access to the complete manual.


April 2022 recsel 1.9