PAMVALIDATE(1)
π PAMVALIDATE(1) β the Pamvalidate User Manual, bestie edition π
okay so this is the manual page for pamvalidate, and it lives in section 1 of the Pamvalidate User Manual. pull up a chair, we're validating image formats and it's lowkey iconic β¨
πΈ NAME πΈ
pamvalidate β validate Netpbm image format π
π SYNOPSIS π
pamvalidate
that's it. no args. she's a solo act, no cap π«Ά
β¨ DESCRIPTION β¨
so this program is part of Netpbm(1), and here's the tea: pamvalidate copies a Netpbm image from Standard Input to Standard Output β except that if there are certain violations of the image format in the input, pamvalidate fails without producing any output. not even a crumb. nothing. π
this is most useful in a pipeline, right before a stage where you do not want to start working on Netpbm input until it knows it can get all the way through it. like bestie, imagine this: you're converting PPM images to PNG and you don't want to produce a partial PNG file under any circumstance. π«
if you just use pnmtopng, and the PPM input is truncated halfway through the raster, pnmtopng fails β but also produces about half of a PNG file. not the half-finished slay, just a mess π
to prevent that, pass your PPM input through pamvalidate on its way to pnmtopng. then pamvalidate will fail, and consequently the pipeline will fail, before pnmtopng has seen any input and therefore before pnmtopng has produced any output. gatekeeping the input like a true main character π
these are the kinds of format violations pamvalidate detects:
- a purported sample value exceeds the declared
maxval. - the stream ends prematurely.
this program works on multi-image streams, producing a corresponding output stream. so many images, so much validation, we love to see it π
also: check out pamfix for a way to salvage an invalid Netpbm image stream. she's the rescue squad π
π OPTIONS π
there are no command line options defined specifically for pamvalidate, but it recognizes the options common to all programs based on libnetpbm (see Common Options). so, no special toppings, just the standard menu π
π¦ SEE ALSO π¦
pam(1) pnm(1) pamfix(1)
β HISTORY β
pamvalidate was new in Netpbm 10.66 (March 2014). a lil legacy queen π
π DOCUMENT SOURCE π
this manual page was generated by the Netpbm tool 'makeman' from HTML source. the master documentation is at
http://netpbm.sourceforge.net/doc/pamvalidate.html
okay that's the whole page bestie, go forth and validate, your pipeline will thank you π«Ά
netpbm documentation Β· 22 March 2014 β mwah, that's a wrap, stay validated β¨π
π¦ where this page comes from
- debian bookworm: netpbm 2:11.01.00-2 Β· MIT
- debian trixie: netpbm 2:11.10.02-1 Β· MIT
- ubuntu noble: netpbm 2:11.05.02-1.1build1 Β· MIT
- ubuntu resolute: netpbm 2:11.10.02-1build1 Β· MIT
- ubuntu stonking: netpbm 2:11.13.03+ds-2 Β· MIT
- π girlified by deepseek-ai/DeepSeek-V4.1-Flash on : a language model's rewrite of the original, under its terms