Debian Codegraph @

upstream/debian-unstable/man1/recsel.1

raw
1 .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3.
2 .TH RECSEL "1" "April 2026" "GNU recutils 1.9" "User Commands"
3 .SH NAME
4 recsel \- print records from a recfile
5 .SH SYNOPSIS
6 .B recsel
7 [\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]...
8 .SH DESCRIPTION
9 Select and print rec data.
10 .TP
11 \fB\-d\fR, \fB\-\-include\-descriptors\fR
12 print record descriptors along with the matched
13 records.
14 .TP
15 \fB\-C\fR, \fB\-\-collapse\fR
16 do not section the result in records with newlines.
17 .TP
18 \fB\-S\fR, \fB\-\-sort\fR=\fI\,FIELD\/\fR,...
19 sort the output by the specified fields.
20 .TP
21 \fB\-G\fR, \fB\-\-group\-by\fR=\fI\,FIELD\/\fR,...
22 group records by the specified fields.
23 .TP
24 \fB\-U\fR, \fB\-\-uniq\fR
25 remove duplicated fields in the output records.
26 .TP
27 \fB\-s\fR, \fB\-\-password\fR=\fI\,STR\/\fR
28 decrypt confidential fields with the given password.
29 .TP
30 \fB\-\-help\fR
31 print a help message and exit.
32 .TP
33 \fB\-\-version\fR
34 show version and exit.
35 .SS "Record selection options:"
36 .TP
37 \fB\-i\fR, \fB\-\-case\-insensitive\fR
38 make strings case\-insensitive in selection
39 expressions.
40 .TP
41 \fB\-t\fR, \fB\-\-type\fR=\fI\,TYPE\/\fR
42 operate on records of the specified type only.
43 .TP
44 \fB\-e\fR, \fB\-\-expression\fR=\fI\,RECORD_EXPR\/\fR
45 selection expression.
46 .TP
47 \fB\-q\fR, \fB\-\-quick\fR=\fI\,STR\/\fR
48 select records with fields containing a string.
49 .TP
50 \fB\-n\fR, \fB\-\-number\fR=\fI\,NUM\/\fR,...
51 select specific records by position, with ranges.
52 .TP
53 \fB\-m\fR, \fB\-\-random\fR=\fI\,NUM\/\fR
54 select a given number of random records.
55 .TP
56 \fB\-j\fR, \fB\-\-join\fR=\fI\,FIELD\/\fR
57 perform an inner join using the specified field.
58 .SS "Output options:"
59 .TP
60 \fB\-p\fR, \fB\-\-print\fR=\fI\,FIELDS\/\fR
61 comma\-separated list of fields to print for each
62 matching record.
63 .TP
64 \fB\-P\fR, \fB\-\-print\-values\fR=\fI\,FIELDS\/\fR
65 as \fB\-p\fR, but print only the values of the selected
66 fields.
67 .TP
68 \fB\-R\fR, \fB\-\-print\-row\fR=\fI\,FIELDS\/\fR
69 as \fB\-P\fR, but separate the values with spaces instead
70 of newlines.
71 .TP
72 \fB\-c\fR, \fB\-\-count\fR
73 print a count of the matching records instead of
74 the records themselves.
75 .SS "Special options:"
76 .TP
77 \fB\-\-print\-sexps\fR
78 print the data in sexps instead of rec format.
79 .SH AUTHOR
80 Written by Jose E. Marchesi.
81 .SH "REPORTING BUGS"
82 Report bugs to: bug\[email protected]
83 .br
84 GNU recutils home page: <https://www.gnu.org/software/recutils/>
85 .br
86 General help using GNU software: <http://www.gnu.org/gethelp/>
87 .SH COPYRIGHT
88 Copyright \(co 2010\-2020 Jose E. Marchesi.
89 License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
90 .br
91 This is free software: you are free to change and redistribute it.
92 There is NO WARRANTY, to the extent permitted by law.
93 .SH "SEE ALSO"
94 The full documentation for
95 .B recsel
96 is maintained as a Texinfo manual. If the
97 .B info
98 and
99 .B recsel
100 programs are properly installed at your site, the command
101 .IP
102 .B info recutils
103 .PP
104 should give you access to the complete manual.