NAME

       recins - insert records in a recfile

SYNOPSIS

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

DESCRIPTION

       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.

       --force
              insert the record even if it is violating record restrictions.

       --no-external
              don't use external descriptors.

       --no-auto
              don't insert auto generated fields.

       --verbose
              give a detailed report if the integrity check fails.

       -s, --password=STR
              encrypt confidential fields with the given password.

       --help print a help message and exit.

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

AUTHOR

       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/>

COPYRIGHT

       Copyright   ©   2010-2020   Jose   E.   Marchesi.    License   GPLv3+:   GNU   GPL  version  3  or  later
       <http://gnu.org/licenses/gpl.html>.
       This is free software: you are free to change and redistribute it.  There is NO WARRANTY, to  the  extent
       permitted by law.

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.

GNU recutils 1.9                                   April 2024                                          RECINS(1)