recins - Man Page

insert records in a recfile


recins [OPTION]... [-t TYPE] [-n NUM | -e RECORD_EXPR | -q STR | -m NUM] [(-f NAME -v STR) | -r RECDATA]... [FILE]


Insert new records in a rec database.

-f,  --field=STR

field name; should be followed by a -v.

-v,  --value=STR

field value; should be preceded by an -f.

-r,  --record=STR

record that will be inserted in the file.


insert the record even if it is violating record restrictions.


don't use external descriptors.


don't insert auto generated fields.


give a detailed report if the integrity check fails.

-s,  --password=STR

encrypt 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.

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.


Written by Jose E. Marchesi.

Reporting Bugs

Report bugs to:
GNU recutils home page: <>
General help using GNU software: <>

See Also

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

info recutils

should give you access to the complete manual.


April 2022 recins 1.9