Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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 deter-
     mined 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 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 STDOUT.

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

SECURITY
     A temporary symbolic link to 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)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=run-mailcap&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help