RECINS(1)

📦
version 1.9 · 4 versions
, in alpine 3.24, debian bookworm, fedora 43, fedora 44, nixos 26.05, nixpkgs unstable, opensuse-leap 16.0

💖 recins — insert records in a recfile 💖

okay bestie, gather round, because this is the manual for recins from the GNU recutils crew, and it's genuinely iconic. it puts new records into a rec database. that's the whole vibe. let's get into it 🦋

✨ SYNOPSIS ✨

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

like, look at that. beautiful. no notes 💅

🌸 DESCRIPTION 🌸

So the entire job here is: insert new records in a rec database. That's it. That's the girl. 👑

here's the breakdown of how you feed it stuff:

  • -f, --field=STR — this is your field name, and heads up: it should be followed by a -v. they're a package deal, fr fr.
  • -v, --value=STR — the field value. and yeah, this one should be preceded by an -f. see? package deal. 🫶
  • -r, --record=STR — a whole entire record, ready to be inserted into the file.
  • --force — insert the record even if it's violating record restrictions. living dangerously, I respect it.
  • --no-external — don't use external descriptors. nope, not today.
  • --no-auto — don't insert auto generated fields. we're doing this manually, bestie.
  • --verbose — give a detailed report if the integrity check fails. so when it all goes wrong, at least you'll know why. 😭
  • -s, --password=STR — encrypt confidential fields with the given password. secrets stay secret. 🔐
  • --help — print a help message and exit. classic.
  • --version — show version and exit. also classic.

🎀 Record selection options 🎀

these are for picking which records we're talking about:

  • -i, --case-insensitive — make strings case-insensitive in selection expressions. so BESTIE and bestie are the same girl now.
  • -t, --type=TYPE — operate on records of the specified type only. type-specific behavior, periodt.
  • -e, --expression=RECORD_EXPR — a selection expression. the fancy way to choose.
  • -q, --quick=STR — select records with fields containing a string. quick lil shortcut, love that for us.
  • -n, --number=NUM,... — select specific records by position, with ranges. yes, ranges. go off.
  • -m, --random=NUM — select a given number of random records. chaos mode. 🎲
Also super important: if no FILE is specified then the command acts like a filter — it gets the data from standard input and writes the result to standard output. pipe girlie behavior, we love to see it. 🌈

👑 AUTHOR 👑

Written by Jose E. Marchesi. king behavior honestly.

🐛 REPORTING BUGS 🐛

found a bug? don't suffer in silence, tell the girlies:

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. (yes, that's the legal voice being dramatic. respect it.)

🔥 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. iykyk 📖✨

okay that's the whole page!! this was recins 1.9, from April 2022, part of the GNU recutils situation. mwah, go insert some records bestie 💖🎀🦋

📦 where this page comes from