run-mailcap

RUN-MAILCAP(1)               Run Mailcap Programs               RUN-MAILCAP(1)

NAME
       run-mailcap, view, see, edit, compose, print - execute programs via en-
       tries in the mailcap file

SYNOPSIS
       run-mailcap   --action=ACTION   [--option[=value]]   [MIME-TYPE:[ENCOD-
       ING:]]FILE [...]

       The see, edit, compose and print versions are just aliases that default
       to the view, edit, compose, and print actions (respectively).

DESCRIPTION
       run-mailcap (or any of its  aliases)  will  use  the  given  action  to
       process  each  mime-type/file  in  turn.  Each file is specified as its
       mime-type, its encoding (e.g. compression), and filename together, sep-
       arated by colons.  If the mime-type is omitted, an attempt to determine
       the type is made by trying to match the file's extension with those  in
       the mime.types files.  If no mime-type is found, a last attempt will be
       done by running the file command, if available.   If  the  encoding  is
       omitted,  it  will also be determined from the file's extensions.  Cur-
       rently supported encodings are gzip (.gz), bzip2 (.bz2), xz (.xz),  and
       compress (.Z).  A filename of "-" can be used to mean "standard input",
       but then a mime-type must be specified.

       Both the user's files (~/.mailcap; ~/.mime.types) and the system  files
       (/etc/mailcap; /etc/mime.types) are searched in turn for information.

   EXAMPLES
         see picture.jpg
         print output.ps.gz
         compose text/html:index.htm
         extract-mail-attachment msg.txt | see image/tiff:gzip:-

   OPTIONS
       All options are in the form --<opt>=<value>.

       --action=<action>
              Performs  the  specified action on the files.  Valid actions are
              view, cat (uses only "copiousoutput" rules and sends  output  to
              STDOUT)  ,  compose, composetyped, edit and print.  If no action
              is specified, the action will be determined by how  the  program
              was called.

       --debug
              Turns on extra information to find out what is happening.

       --nopager
              Ignores  any  "copiousoutput" directive and sends output to STD-
              OUT.

       --norun
              Displays the found command without actually executing it.

SECURITY
       A temporary copy of the file is opened if the  file  name  matches  the
       Perl  regular expression "[^[:alnum:],.:/@%^+=_-]", in order to protect
       from the injection of shell commands, and to make sure  that  the  name
       can  always  be displayed in the current locale.  In addition, the file
       is opened using its absolute path to prevent the injection of  command-
       line arguments, for instance using file names starting with dashes.

SEE ALSO
       file(1) mailcap(5) mailcap.order(5) update-mime(8)

AUTHOR
       run-mailcap   (and   its   aliases)   was   written   by   Brian  White
       <bcwhite@pobox.com>.

COPYRIGHT
       run-mailcap (and its aliases) is in the public domain  (the  only  true
       "free").

Debian Project                   1st Jan 2008                   RUN-MAILCAP(1)