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 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 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+14.3.quarterly>

home | help