GID(1)

💖 GID 💖

okay so bestie, welcome to gid — that's the gid command from the User Commands corner of your manual, and she is so much more useful than she looks. let's get into it 🫶

---

✨ NAME ✨

gid — Query ID database and report results.

like. that's the whole job. she queries the ID database and reports what she finds. main character energy, honestly 💅

---

🌸 SYNOPSIS 🌸

gid [OPTION]... PATTERN...

so it's gid, then however many options you want, then however many PATTERNs you want. go off 👑

---

🦋 DESCRIPTION 🦋

Query ID database and report results. By default, output consists of multiple lines, each line containing the matched identifier followed by the list of file names in which it occurs.

translation bestie: every line is like "here's the thing you matched, and here's every file where it lives". iconic format, no notes ✨

---

🎀 the flags (read them, they're the whole vibe) 🎀

• -f, --file=FILE — the file name of the ID database. that's the file she's gonna go dig around in 🗂️
• -i, --ignore-case — match PATTERN case insensitively. Hello and hello and HELLO all count, we don't discriminate here 💖
• -l, --literal — match PATTERN as a literal string. take it exactly as written, no fancy business ✏️
• -r, --regexp — match PATTERN as a regular expression. now we're cooking 🔥
• -w, --word — match PATTERN as a delimited word. whole word only, boundaries respected, she has standards 🎀
• -s, --substring — match PATTERN as a substring. anywhere inside, doesn't matter where, she'll find it 🦋

Note: If PATTERN contains extended regular expression metacharacters, it is interpreted as a regular expression substring. Otherwise, PATTERN is interpreted as a literal word.

so yeah — regex characters in there? she switches to regex substring mode automatically. no regex chars? she treats it as a literal word. she's smart like that 😌

• -k, --key=STYLE — STYLE is one of token, pattern or none
• -R, --result=STYLE — STYLE is one of filenames, grep, edit or none
• -S, --separator=STYLE — STYLE is one of braces, space or newline and only applies to file names when --result=filenames

The above STYLE options control how query results are presented. Defaults are --key=token --result=filenames --separator=space

okay so these three STYLE options are literally the aesthetic settings for your output 💅 --key picks what the key looks like, --result picks how results show up, --separator picks how filenames get separated (and heads up, it only kicks in for filenames when you're on --result=filenames). and if you don't say anything, the defaults are --key=token, --result=filenames, --separator=space. set and forget, periodt ✨

• -F, --frequency=FREQ — find tokens that occur FREQ times, where FREQ is a range expressed as N..M. If N is omitted, it defaults to 1, if M is omitted it defaults to MAX_USHRT

so it's a range thing, written like N..M. skip N? she assumes 1. skip M? she assumes MAX_USHRT. easy 🍓

• -a, --ambiguous=LEN — find tokens whose names are ambiguous for LEN chars. like, confusing little guys. she'll track 'em down for you 🙈
• -x, --hex — only find numbers expressed as hexadecimal
• -d, --decimal — only find numbers expressed as decimal
• -o, --octal — only find numbers expressed as octal

By default, searches match numbers of any radix.

so if you don't pick one of -x, -d or -o, she matches numbers of any radix. pick one and she locks in 🔒

• --help — display this help and exit. the classic. she tells you how she works and dips 👋
• --version — output version information and exit. she tells you who she is and dips 💜

---

💀 REPORTING BUGS 💀

Report bugs to bug-idutils@gnu.org

found a bug? don't suffer in silence bestie, tell the idutils people at that email up there. they wanna know, fr fr 😭

---

🌈 SEE ALSO 🌈

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

info gid

should give you access to the complete manual.

so if you want the full lore, not just the highlight reel, run that and she'll give you everything 👑

---

and that's the whole page bestie!! 🎀 gid — version 4.6.28-15da, dated May 2020 — the little ID database gremlin who always comes through. go query something and slay 💖✨🦋