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

NAME

       run-mailcap, view, see, edit, compose, print - execute programs via entries in the mailcap file

SYNOPSIS

       run-mailcap --action=ACTION [--option[=value]] [MIME-TYPE:[ENCODING:]]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, separated 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.
       Currently  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  informa-
       tion.

   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 STD-
              OUT) , 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 STDOUT.

       --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 expresssion "[^[: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)