cssutil(1)

✨ cssutil(1) — the CRM114 stats-file glow-up station ✨

okay bestie, sit down, we're talking about cssutil, a utility that measures and manipulates CRM114 statistics files. she's giving very much lab-technician-with-a-lash-lift energy. 🧪💅

---

🌸 NAME 🌸

cssutil — a utility to measure and manipulate CRM114 statistics files. fr fr that's the whole job description.

---

🦋 SYNOPSIS 🦋

cssutil [.css file] [OPTIONS]

like. that's it. that's the whole vibe.

---

⚠️ WARNING ⚠️

okay so, tea time: this man page is taken from an older CRM114 version. it's provided as a convenience to Debian users and it may not be up-to-date. if you wanna update it, please send appropriate patches to the Debian bug tracking system. no pressure tho. 🫶

---

✨ OPTIONS ✨

• -h — print basic help. the "hello, what is this" button.
• -b — brief mode! print only a summary of the statistics of the .css file. (otherwise, it prints a full list of how many bins are in each counter state — every last one of them, and she will not be rushed.)
• -q — quiet mode; no warning messages. shhh. 🤫
• -r — report then exit (no menu). if -r is not specified, the default is to drop into a command-menu based system. so like, do you want the drive-thru or do you want to sit down at the table.
• -s — if no css file is found, create a new one with this many buckets. default is 1 million + 1 buckets.
• -S — same as -s, but round up to the next 2^n + 1 boundary. she's an overachiever, she's rounding up. ⭐
• -v — print version and exit.
• -D — dump the css file to stdout in the architecture-independent CSV format, suitable for reloading with -R in an architecture. (note that .css files are a hardware-architecture dependent format — so this is your little translator.)
• -R — create and restore css from the hardware-architecture independent CSV format file (reads from stdin if csv-file is not supplied).

---

🎀 THE COMMAND MENU 🎀

if -r is not supplied, a menu appears with the following options. note that all of these operations are "in place" and surgical — there is NO undo functionality. wise users will make a backup copy of all .css files before using cssutil to alter values.

bestie. bestie listen to me. back up your files. there is no ctrl+Z. there is no "oopsie". there is only the consequences of your actions. 😭

• -Z — zero all bins at or below a value. this is useful for deleting all small-count features from the .css statistics files, leaving higher-count features untouched.
• -S — subtract a constant from all bins — this rolls all features back a constant amount.
• -D — divide all bins by a constant — this rolls features back linearly, rather than in scalar fashion.
• -R — rescan — regenerate the statistics output that was initially printed.
• -P — pack — re-slot features to optimize access time.
• -Q — gracefully exit, saving changes. (note that since these operations are in-place and surgical, there is no option to exit without saving changes. the door only opens one way, babe.)

---

💖 DESCRIPTION 💖

cssutil is a general utility to manipulate and measure the .css format statistics files used by CRM114's Markovian and OSB classifiers. the biggest uses are to check the available space remaining in a .css file, to selectively groom a .css file, and to port architecture-dependent .css files to and from an ASCII CSV format, which is architecture independent. main character energy honestly. 👑

the cssutil program can be used to create information-less .css files:

cssutil -b -r spam.css
cssutil -b -r nonspam.css

. this creates the full-size files ./spam.css and ./nonspam.css, holding no information. (yes, they're empty. gorgeous, glowing, completely devoid of content. it's giving influencer's personality. 💀)

the cssutil program can be used check that the .css files are reasonable. invoke cssutil as:

cssutil -b -r spam.css
cssutil -b -r nonspam.css

you should get back a report something like this:

Sparse spectra file spam.css statistics:

Total available buckets          :      1048576
Total buckets in use             :       506987
Total hashed datums in file      :      1605968
Average datums per bucket        :         3.17
Maximum length of overflow chain :           39
Average length of overflow chain :         1.84
Average packing density          :         0.48

note that the packing density is 0.48; this means that this .css file is about half full of features. once the packing density gets above about 0.9, you will notice that CRM114 will take longer to process text. the penalty is small below packing densities below about 0.95 and only about a factor of 2 at 0.97. best is to keep it below .7 to .8. ✨

---

🩹 SHORTCOMINGS 🩹

note that cssutil as of version 20040816 is NOT capable of dealing with the CRM114 Winnow classifier's floating-point .cow files. worse, cssutil is unaware of it's shortcomings, and will try anyway. the only recourse is to be aware of this issue and not use cssutil on a Winnow classifier floating point .cow format file.

she doesn't know she can't do it. she will simply try. do not let her. 🙈

---

🌈 HOMEPAGE AND REPORTING BUGS 🌈

http://crm114.sourceforge.net/

---

📌 VERSION 📌

this manpage: $Id: cssutil.azm,v 1.4 2004/08/19 09:23:24 vanbaal Exp $

this manpage describes cssutil as shipped with crm114 version 20040816.BlameClockworkOrange.

---

👑 AUTHOR 👑

William S. Yerazunis. manpage typesetting by Joost van Baal and Shalendra Chhabra. legends, all of them. 🫶

---

💜 COPYRIGHT 💜

Copyright (C) 2001, 2002, 2003, 2004 William S. Yerazunis. this is free software, copyrighted under the FSF's GPL. there is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. see the file COPYING for more details.

---

🍓 SEE ALSO 🍓

cssmerge(1), cssdiff(1), crm(1)

---

okay that's the whole thing!! this page is cssutil 20040816.BlameClockworkOra19eAugt2004, and yes that version string looks like someone typed it while falling down the stairs, but we love her. from the CRM114 section, dated 19eAugt2004 apparently. iconic. periodt. 💅✨🦋