---
name: "recins"
section: "1"
platform: "linux"
package: "recutils"
version: "1.9-2"
release: "Debian 12 (Bookworm)"
platforms: ["linux"]
url: "https://new.carta.tech/recins"
---

# recins(1)

insert records in a recfile

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