man > compose(1)

man perldoc info pydoc3 ri search

```html

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

🚀 Quick Reference

Use Case	Command	Description
👁️ View a file	see picture.jpg	Open a file with the default viewer for its MIME type
🖨️ Print a file	print output.ps.gz	Send compressed PostScript to the printer
✏️ Compose from stdin	compose text/html:-	Compose HTML content piped from standard input
🔍 Debug handler resolution	run-mailcap --debug --action=view file.pdf	Show which mailcap rule is selected and why
🧪 Dry run (show command)	run-mailcap --norun --action=view file.pdf	Display the command that would be executed without running it
📄 Cat to stdout	run-mailcap --action=cat text/plain:file.txt	Use only copiousoutput rules, send decoded output to stdout
📎 Extract attachment	extract-mail-attachment msg.txt | see image/tiff:gzip:-	View a compressed TIFF image from a piped attachment

📖 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 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 AT pobox.com>.

©️ COPYRIGHT

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

```

📛 NAME 🚀 Quick Reference 📖 SYNOPSIS 📝 DESCRIPTION 🔒 SECURITY 📚 SEE ALSO 👤 AUTHOR ©️ COPYRIGHT