RECINS(1)							   User Commands							 RECINS(1)

NAME

       recins - insert records in a recfile

SYNOPSIS

       recins [OPTION]... [t TYPE] [-n NUM | -e EXPR | -q STR | -m NUM] [(-f STR -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=EXPR
	      selection expression.

       -q, --quick=STR
	      select records with fields containing a string.

       -n, --number=NUM,...
	      select specific records by position, with ranges.

       -R, --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 out-
       put.

AUTHOR

       Written by Jose E. Marchesi.

REPORTING BUGS

       Report bugs to: bug-recutils@gnu.org
       GNU recutils home page: <http://www.gnu.org/software/recutils/>
       General help using GNU software: <http://www.gnu.org/gethelp/>

COPYRIGHT

       Copyright (C) 2010, 2011, 2012 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 recins

       should give you access to the complete manual.

recins 1.4.93							   January 2012 							 RECINS(1)