Name of IRAF image header file or FITS file. At least one of these
must be present for any values to be printed. If it is stdin
or STDIN, a FITS file is expected as standard input, such as
in example 5. Individual parts of
multiextension FITS images may be accessed by appending a comma and
the extension number (0=primary) or name. Brackets may be used
instead of a comma, but they must be escaped with a backslash on the
Unix command line.
@filename
Name of a file listing image file names (IRAF image header files
and/or FITS files) or keyword names. The program tests the first line
to see whether it is a FITS or IRAf image file. If it is, any other
file names on the command line will be ignored. If it is not an image
file, this list file is assumed to contain keywords, one per line.
Two arguments, one of each type, files or keywords, are allowed on
a single gethead command line.
See example 4.
keyword
Name of keywords in FITS or IRAF header for which values are to be printed.
At least one of these must be present for any values to be printed.
All command line arguments which do not start with - and are not
image files are assumed to be keywords.
-a
List file name even if keywords are not found.
(Added in WCSTools 2.6)
-ddirectory pathname
Root directory for input files. Default is the current working directory,
but a full pathname or a path relative to the current working directory may
be specified.
(Added in WCSTools 2.6)
-e
Output keyword values as keyword=value on one line per file.
Output from a single file can used as input to
sethead,
for example.
(Added in WCSTools 2.7.2)
-f
Never print filenames. The default is to print if more than one file is
being read.
(Added in WCSTools 2.6.9)
-h
Print column headings, in order, but not necessarily aligned.
See example 3.
-m
Reset the maximum number of keyword names which can be read from the
command line. This is useful if the MAXKWD parameter in sethead.c is set
to a small number and the values of more keyword need to be listed.
(Added in version 2.6, dropped in version 2.6.4)
-nnumber
Set number of decimal places to be used in all numeric output
(Added in WCSTools 2.4)
-p
Print the full pathnames of the input files at the start of each output
line.
(Added in WCSTools 2.3)
-t
Print output in tab-separated table format, with column headers.
See example 4.
-u
Always print ___ if a keyword is not found or if the keyword's
value is a null string.
(Added in WCSTools 2.6.9, null string in WCSTOols 3.3.1)
