1Pamvalidate User Manual(0)                          Pamvalidate User Manual(0)
2
3
4

NAME

6       pamvalidate - validate Netpbm image format
7
8

SYNOPSIS

10       pamvalidate
11
12
13

DESCRIPTION

15       This program is part of Netpbm(1).
16
17       pamvalidate  copies a Netpbm image from Standard Input to Standard Out‐
18       put, except that if there are certain violations of the image format in
19       the input, pamvalidate fails without producing any output.
20
21       This  is  most  useful  in a pipeline, before a stage you don't want to
22       start working on Netpbm input until it knows it can  get  all  the  way
23       through  it.   For example, assume you are converting PPM images to PNG
24       and you don't want to produce a partial  PNG  file  under  any  circum‐
25       stance.  If you just use pnmtopng, and the PPM input is truncated half‐
26       way through the raster, pnmtopng fails, but also produces about half of
27       a  PNG  file.  To prevent that, pass your PPM input through pamvalidate
28       on its way to pnmtopng.  Then, pamvalidate will fail, and  consequently
29       the  pipeline  will fail, before pnmtopng has seen any input and there‐
30       fore before pnmtopng has produced any output.
31
32       These are the kinds of format violations pamvalidate detects:
33
34
35
36       ·      A purported sample value exceeds the declared maxval.
37
38       ·      The stream ends prematurely.
39
40
41       This program works on multi-image streams,  producing  a  corresponding
42       output stream.
43
44       See pamfix for a way to salvage an invalid Netpbm image stream.
45
46
47

OPTIONS

49       There are no command line options defined specifically for pamvalidate,
50       but it recognizes the options common to all programs based on libnetpbm
51       (See
52        Common Options ⟨index.html#commonoptions⟩ .)
53
54

SEE ALSO

56       pam(1) pnm(1) pamfix(1)
57
58
59

HISTORY

61       pamvalidate was new in Netpbm 10.66 (March 2014).
62

DOCUMENT SOURCE

64       This  manual  page was generated by the Netpbm tool 'makeman' from HTML
65       source.  The master documentation is at
66
67              http://netpbm.sourceforge.net/doc/pamvalidate.html
68
69netpbm documentation             22 March 2014      Pamvalidate User Manual(0)