.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.3.
.TH RECINS "1" "March 2024" "GNU recutils 1.9" "User Commands"
.SH NAME
recins \- insert records in a recfile
.SH SYNOPSIS
.B recins
[\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]
.SH DESCRIPTION
Insert new records in a rec database.
.TP
\fB\-f\fR, \fB\-\-field\fR=\fI\,STR\/\fR
field name; should be followed by a \fB\-v\fR.
.TP
\fB\-v\fR, \fB\-\-value\fR=\fI\,STR\/\fR
field value; should be preceded by an \fB\-f\fR.
.TP
\fB\-r\fR, \fB\-\-record\fR=\fI\,STR\/\fR
record that will be inserted in the file.
.TP
\fB\-\-force\fR
insert the record even if it is violating
record restrictions.
.TP
\fB\-\-no\-external\fR
don't use external descriptors.
.TP
\fB\-\-no\-auto\fR
don't insert auto generated fields.
.TP
\fB\-\-verbose\fR
give a detailed report if the integrity check
fails.
.TP
\fB\-s\fR, \fB\-\-password\fR=\fI\,STR\/\fR
encrypt 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.
.PP
If no FILE is specified then the command acts like a filter, getting
the data from standard input and writing the result to standard output.
.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 recins
is maintained as a Texinfo manual.  If the
.B info
and
.B recins
programs are properly installed at your site, the command
.IP
.B info recutils
.PP
should give you access to the complete manual.