TWPRINT(8)

💅 TWPRINT(8) — the Tripwire database & report printer, bestie edition ✨

okay so real quick — this is twprint, from the System Manager's Manual, and it's literally the glow-up tool that takes your Tripwire database and report files and prints them in clear text so you can actually read them. no cap. 🎀

---

✨ NAME ✨

twprint — Tripwire database and report printer 🦋

---

🌸 SYNOPSIS 🌸

twprint { -m r | --print-report } [ options... ]
      [ object1 [ object2... ]]
twprint { -m d | --print-dbfile } [ options... ]
      [ object1 [ object2... ]]

two whole moods, pick one 💅

---

🌈 DESCRIPTION 🌈

It prints Tripwire database and report files in clear text format. that's the whole vibe. ✨

🎀 Report Printing mode 🎀

In Report Printing mode, twprint verifies and displays the contents of a Tripwire report file (.twr). If no report is specified on the command line, the report specified in the REPORTFILE variable in the configuration file will be used.

⚠️ okay bestie pay attention: by default, this value includes the date and time to the nearest second. Because this value is constantly changing, twprint may not be able to find the correct report file. literally the icon of being too specific 😭 For this reason, the (-r or --twrfile) flag should be used with the desired report name to print a specific report.

🦋 Database Printing mode 🦋

This option is used to print a Tripwire database file in human-readable (clear text) form. In Database Printing mode, twprint verifies and prints the contents of a specified database to stdout. If no database file is specified on the command line, the default database specified by the DBFILE variable in the configuration file is used.

---

💖 OPTIONS 💖

👑 Report printing mode:

-m r               --print-report
-v                 --verbose
-s                 --silent, --quiet
-h                 --hexadecimal
-c cfgfile         --cfgfile cfgfile
-r report          --twrfile report
-L localkey        --local-keyfile localkey
-t { 0|1|2|3|4 }   --report-level { 0|1|2|3|4 }
[ object1 [ object2... ]]

• -m r, --print-report — Mode selector. just picking your lane, per periodt. 🫶
• -v, --verbose — Verbose output mode. Mutually exclusive with (-s). she says a LOT, so you can't run her with the quiet one.
• -s, --silent, --quiet — Silent output mode. Mutually exclusive with (-v). the introvert setting 🤫
• -h, --hexadecimal — Display hash values as hexadecimal. hex girlies rise 🔥
• -c cfgfile, --cfgfile cfgfile — Use the specified configuration file.
• -r report, --twrfile report — Print the specified report file. this is the one that saves you from the changing-filename situation above, iykyk 💀
• -L localkey, --local-keyfile localkey — Use the specified local key file to perform verification with reports which are signed.
• -t level, --report-level level — Specifies the detail level of the printed report, overriding the REPORTLEVEL variable in the configuration file. level must be a number from 0 to 4.
• [ object1 [ object2... ]] — List of filesystem objects in the report to print. If no objects are specified, every object in the report will be printed. all of them. the whole squad. 🌈

🍓 Database printing mode:

-m d           --print-dbfile
-v             --verbose
-s             --silent, --quiet
-h             --hexadecimal
-c cfgfile     --cfgfile cfgfile
-d database    --dbfile database
-L localkey    --local-keyfile localkey
-t { 0|1|2 }   --output-level { 0|1|2 }
[ object1 [ object2... ]]

• -m d, --print-dbfile — Mode selector. the other lane 💅
• -v, --verbose — Verbose output mode. Mutually exclusive with (-s).
• -s, --silent, --quiet — Silent output mode. Mutually exclusive with (-v).
• -h, --hexadecimal — Display hash values as hexadecimal. ✨
• -c cfgfile, --cfgfile cfgfile — Use the specified configuration file.
• -d database, --dbfile database — Print the specified database file.
• -L localkey, --local-keyfile localkey — Use the specified local key file to read the database.
• -t level, --output-level level — Specifies the detail level of the printed database, overriding the DBPRINTLEVEL variable in the configuration file. level must be a number from 0 to 2. (yes, only 0–2 here — different mode, different rules, don't come for me 🙈)
• [ object1 [ object2... ]] — List of filesystem objects in the database to print. If no objects are specified, every object in the database will be printed. The format for a list of objects is: section: objname objname... section: objname... — literally just write it like that, bestie 🎀

---

⭐ EXIT STATUS ⭐

twprint exits 0 on success, 1 on error.

zero means slay, one means something went sideways 😭

---

🦋 VERSION INFORMATION 🦋

This man page describes twprint version 2.4.

---

💜 AUTHORS 💜

Tripwire, Inc.

---

🌸 COPYING PERMISSIONS 🌸

Permission is granted to make and distribute verbatim copies of this man page provided the copyright notice and this permission notice are preserved on all copies.

Permission is granted to copy and distribute modified versions of this man page under the conditions for verbatim copying, provided that the entire resulting derived work is distributed under the terms of a permission notice identical to this one.

Permission is granted to copy and distribute translations of this man page into another language, under the above conditions for modified versions, except that this permission notice may be stated in a translation approved by Tripwire, Inc.

Copyright 2000-2018 Tripwire, Inc. Tripwire is a registered trademark of Tripwire, Inc. in the United States and other countries. All rights reserved.

---

🧚 SEE ALSO 🧚

twintro(8), tripwire(8), twadmin(8), siggen(8), twconfig(4), twpolicy(4), twfiles(5)

---

and that's the whole page, bestie 🫶 this was brought to you by Open Source Tripwire 2.4, dated 04 Jan 2018 — go forth and print your databases, mwah 💋💖