Debian Codegraph @

upstream/debian-unstable/man1/recins.1

raw
1 .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3.
2 .TH RECINS "1" "April 2026" "GNU recutils 1.9" "User Commands"
3 .SH NAME
4 recins \- insert records in a recfile
5 .SH SYNOPSIS
6 .B recins
7 [\fI\,OPTION\/\fR]... [\fI\,-t TYPE\/\fR] [\fI\,-n NUM | -e RECORD_EXPR | -q STR | -m NUM\/\fR] [\fI\,(-f NAME -v STR) | -r RECDATA\/\fR]... [\fI\,FILE\/\fR]
8 .SH DESCRIPTION
9 Insert new records in a rec database.
10 .TP
11 \fB\-f\fR, \fB\-\-field\fR=\fI\,STR\/\fR
12 field name; should be followed by a \fB\-v\fR.
13 .TP
14 \fB\-v\fR, \fB\-\-value\fR=\fI\,STR\/\fR
15 field value; should be preceded by an \fB\-f\fR.
16 .TP
17 \fB\-r\fR, \fB\-\-record\fR=\fI\,STR\/\fR
18 record that will be inserted in the file.
19 .TP
20 \fB\-\-force\fR
21 insert the record even if it is violating
22 record restrictions.
23 .TP
24 \fB\-\-no\-external\fR
25 don't use external descriptors.
26 .TP
27 \fB\-\-no\-auto\fR
28 don't insert auto generated fields.
29 .TP
30 \fB\-\-verbose\fR
31 give a detailed report if the integrity check
32 fails.
33 .TP
34 \fB\-s\fR, \fB\-\-password\fR=\fI\,STR\/\fR
35 encrypt confidential fields with the given password.
36 .TP
37 \fB\-\-help\fR
38 print a help message and exit.
39 .TP
40 \fB\-\-version\fR
41 show version and exit.
42 .SS "Record selection options:"
43 .TP
44 \fB\-i\fR, \fB\-\-case\-insensitive\fR
45 make strings case\-insensitive in selection
46 expressions.
47 .TP
48 \fB\-t\fR, \fB\-\-type\fR=\fI\,TYPE\/\fR
49 operate on records of the specified type only.
50 .TP
51 \fB\-e\fR, \fB\-\-expression\fR=\fI\,RECORD_EXPR\/\fR
52 selection expression.
53 .TP
54 \fB\-q\fR, \fB\-\-quick\fR=\fI\,STR\/\fR
55 select records with fields containing a string.
56 .TP
57 \fB\-n\fR, \fB\-\-number\fR=\fI\,NUM\/\fR,...
58 select specific records by position, with ranges.
59 .TP
60 \fB\-m\fR, \fB\-\-random\fR=\fI\,NUM\/\fR
61 select a given number of random records.
62 .PP
63 If no FILE is specified then the command acts like a filter, getting
64 the data from standard input and writing the result to standard output.
65 .SH AUTHOR
66 Written by Jose E. Marchesi.
67 .SH "REPORTING BUGS"
68 Report bugs to: bug\[email protected]
69 .br
70 GNU recutils home page: <https://www.gnu.org/software/recutils/>
71 .br
72 General help using GNU software: <http://www.gnu.org/gethelp/>
73 .SH COPYRIGHT
74 Copyright \(co 2010\-2020 Jose E. Marchesi.
75 License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
76 .br
77 This is free software: you are free to change and redistribute it.
78 There is NO WARRANTY, to the extent permitted by law.
79 .SH "SEE ALSO"
80 The full documentation for
81 .B recins
82 is maintained as a Texinfo manual. If the
83 .B info
84 and
85 .B recins
86 programs are properly installed at your site, the command
87 .IP
88 .B info recutils
89 .PP
90 should give you access to the complete manual.