cmstag(1)

NAME
     cmstag - associate an ICC device profile with one or more image files

SYNOPSIS
     cmstag [ -f | -n]  [ -s source_profile ]
            [ -o out_file ] image_files

DESCRIPTION
     cmstag associates an International Color Consortium (ICC) profile with
     one or more image files.  The image files need not all be in the same
     format.  There are two possible ways to associate the profile with the
     image(s).  By default, or if the -f flag is set, the full ICC profile
     will be embedded as a tag in the image file(s).  If the -n flag is set,
     then only the name of the file will be embedded.  This approach is only
     useful if the image file and profile are guaranteed to always reside on
     the same machine.  All files specified will be tagged with the same
     profile.

Command Line Options
     cmstag supports the following command line options:

     -s source_profile
               Specifies the (source) profile to associate with the image(s).
               If a path name is provided, that is where the profile will be
               looked for. Otherwise, the profile will be looked for in the
               default profile directory:  /usr/share/cms/profiles.  If this
               option is not set, the user's CMS_SETTING_RGB profile will be
               used. If that is not set, an error will result.

     -f        Requires that the full ICC profile be embedded in the image
               file(s).  This option is mutually exclusive with the -n option.

     -n        Requires that only the name of the ICC profile be embedded in
               the image file(s).  This option is mutually exclusive with the
               -s option.

     -o out_file
               If only one file is being tagged, an output file may be
               specied. The tagged image will be stored in out_file.  If more
               than one image is being tagged, an error results.

     image_files
               One or more files to be "tagged" with the ICC profile. All
               image files will be tagged with the same profile in the same
               way.

ERRORS
     cmstag tags each image file separately.  An error in processing one file
     ususally does not prevent the processing of other files.
     The following are error conditions:

     o    the specified image file can not be opened for reading;

     o    the specified image file can not be opened for writing;

     o    the specified image file is not in a supported image file format.
          Supported formats are: SGI image file, TIFF, JPEG/JFIF, and GIF.

     o    the specified source profile can not be found, or is not an ICC
          profile.

FILES
     /usr/share/cms/profiles    directory in which system device profiles are
                                stored