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

NAME

6       pamfile - describe a Netpbm (PAM or PNM) file
7
8

SYNOPSIS

10       pamfile
11
12       [-allimages] [-count] [-comments]
13
14       [file ...]
15
16       Minimum  unique  abbreviations  of options are acceptable.  You may use
17       double hyphens instead of single hyphen to denote options.  You may use
18       white space in place of the equals sign to separate an option name from
19       its value.
20
21

DESCRIPTION

23       This program is part of Netpbm(1).
24
25       pamfile reads one or more Netpbm files as input and  writes  out  short
26       descriptions  of  the image type, size, etc.  This is partly for use in
27       shell scripts, so the format is not particularly pretty.
28
29       By default, pamfile reads only the header of the input file.   If  that
30       file is a pipe, that might cause problems for the process that is feed‐
31       ing the pipe.  In that case, see the -allimages option.
32
33

OPTIONS

35       -allimages
36              This option causes pamfile to describe every image in each input
37              file.   Without  this  option,  pamfile describes only the first
38              image in each input file.
39
40              This option also causes pamfile to read all the images from  the
41              input  stream, whereas without it, pamfile reads only the header
42              of the first one.  If the input  stream  is  from  a  pipe,  the
43              process that is feeding the pipe might require the entire stream
44              to be consumed.  In that case,  use  this  option  even  if  the
45              stream contains only one image.
46
47              This option has no effect if you also specify -count.
48
49              Note  that  before July 2000, a file could not contain more than
50              one image and many programs ignore all but the first.
51
52              This option was new in Netpbm 9.5 (July 2000).
53
54
55       -comments
56              This option causes pamfile to  include  for  each  PAM  image  a
57              report of the comments from the header of the image.
58
59              For  a PBM, PGM, or PPM image, pamfile reports there are no com‐
60              ments, even if there are.
61
62              This option was new in Netpbm 10.35 (August 2006).
63
64
65       -count This option causes pamfile to display only a count of  how  many
66              images are in each input file.
67
68              As with -allimages, this causes pamfile to read all the images.
69
70              This option was new with Netpbm 10.31 (December 2005).
71
72
73
74

SEE ALSO

76       pam(1), ppmhist(1), file
77
78

AUTHOR

80       Copyright (C) 1991 by Jef Poskanzer.
81
82
83
84netpbm documentation             11 July 2006;          Pamfile User Manual(0)