TORRUS_NODEID(8)

💖 NAME 💖

nodeid — a Torrus utility, bestie. That's the whole name, she's simple and she serves.

---

✨ SYNOPSIS ✨

torrus nodeid --tree=TREENAME --cmd=CMD options...

---

🌸 DESCRIPTION 🌸

okay so listen. this command is literally the glow-up that lets Torrus talk to external OSS systems — like, it's the bridge, the connector, the main character that makes two whole worlds hold hands 🫶.

It works with nodeid, which is a unique identifier for Torrus datasource subtrees and leaves. yes, subtrees AND leaves, both of them, no crumbs left behind.

And when it's done? It prints the data on standard output in JSON data format. JSON. iconic. machine-readable. the OSS systems are gonna eat it up fr fr 💅

---

👑 OPTIONS 👑

• --tree=TREE — [Mandatory] this one defines the datasouerce tree. yes it's required, no you cannot skip it, she's not optional bestie.
• --cmd=CMD — [Mandatory] defines the action command. The following commands are supported:
  • info — prints information about the nodeid. Requires --nodeid. 🔍
  • search — performs a prefix or substring search on node IDs and prints the results. Requires --prefix or --substring. 🕵️
  • render — renders a specified datasource node and prints the resulting MIME type and the file name. Requires --nodeid and --view. Optional --out defines a file name to copy the output to. 🎨
• --nodeid=NODEID — specifies the Node ID string, for the commands info and render. that's her whole job and she does it well.
• --details — toggles verbose output for the commands info and search. more words, more detail, more to obsess over.
• --prefix=STR — specifies the prefix search string, for the command search.
• --substring=STR — specifies the search substring, for the command search.
• --view=VIEW — specifies the view name, for the command render. The following views are defined by standard Torrus XML files and render a PNG graph: "short", "last24h-small", "last24h", "lastweek", "lastmonth", "lastyear". And the following views are printing the datasource value in a text format: "rrd-print-daily", "rrd-print-last". pick your fighter 💖
• --out=FILE — if defined, instructs the utility to copy the rendered data into a specified file. Otherwise the file is created in the standard renderer's cache directory. no file? she'll find a home for it herself, she's resourceful like that 🏠
• --help — displays a help message. when in doubt, ask for help, it's giving self-care 💅

---

🔥 SEE ALSO 🔥

torrus(8)

---

🌈 NOTES 🌈

See more documentation at Torrus home page: http://torrus.org — go read it, it's giving lore, iykyk 📚

---

🎀 AUTHOR 🎀

Stanislav Sinyagin <ssinyagin@k-open.com> — thank you for your service, king 👑

---

ok that's the whole page bestie, you're officially a torrus nodeid expert, no cap 🧚

torrus 3.00 · 2023-05-02 — and that's the version and the date, stamped with love, bye bestie! 💖✨🦋