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), bzip	(.bz),	bzip2  (.bz2),
       and compress (.Z).  A filename of "-" can be used to mean "standard in-
       put", 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 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)

NAME | SYNOPSIS | DESCRIPTION | SECURITY | SEE ALSO | AUTHOR | COPYRIGHT

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

home | help