(Version 3.96)

pine(1)


pine -- a Program for Internet News and Email

Synopsis

pine [options] [address, address]

pinef [options] [address, address]

Description

pine is a screen-oriented message-handling tool. In its default configuration, pine offers an intentionally limited set of functions geared toward the novice user, but it also has a growing list of optional ``power-user'' and personal-preference features. pinef is a variant of pine that uses function keys rather than mnemonic single-letter commands. The basic feature set of pine includes: Full details of using the pine system are given in The Pine MUA in The Pine MUA.

pine supports MIME (Multipurpose Internet Mail Extensions), an Internet standard for representing multipart and multimedia data in email. pine allows you to save MIME objects to files. In some cases, pine can also initiate the correct program for viewing the object. pine uses the system's mailcap configuration file to determine which program can process a particular MIME object type. pine's message composer does not have integral multimedia capability, but any type of data file, including multimedia, can be attached to a text message and sent using MIME encoding rules. This allows any group or individual with MIME-capable mail software (such as pine, PC-Pine, or many other programs) to exchange formatted documents, spreadsheets, and image files using Internet email.

pine uses the C client messaging API to access local and remote mail folders. This library provides multiple low-level message-handling functions, including drivers for a variety of different mail file formats. It also includes routines to access remote mail and news servers using IMAP (Internet Message Access Protocol) and NNTP (Network News Transport Protocol). Outgoing mail is usually handed off to the sendmail(1M) program, but it can optionally be posted directly using SMTP (Simple Mail Transfer Protocol).

Options

The command line options are:

address
Send mail to address. This causes pine to enter the message composer.

-a
Special anonymous mode for UWIN (University of Washington Information Navigator).

-c context-number
context-number is the number corresponding to the folder collection to which the -f command-line argument should be applied. By default, the -f argument is applied to the first defined folder collection.

-d debug-level
Output diagnostic information at debug-level (0-9) to the current .pine-debug[1-4] file. A value of 0 turns debugging off and suppresses the .pine-debug file.

-f folder
Open folder (in the first defined folder collection) instead of INBOX.

-F file
Open named text file and view with pine browser.

-h
List valid command-line options.

-i
Start up in the FOLDER INDEX screen.

-I keystrokes
Initial (comma separated list of) keystrokes that pine should execute on startup.

-k
Use function keys for commands. This is the same as running the command pinef.

-l
Expand all collections in the FOLDER LIST display.

-n number
Start up with current message-number set to number.

-nr
Special mode for UWIN.

-o
Open the first folder read-only.

-p config-file
Use config-file as the personal configuration file instead of the default .pinerc.

-P config-file
Use config-file as the configuration file instead of the default system-wide configuration file pine.conf.

-r
Use restricted/demo mode. pine sends mail only to itself and functions as if Save and Export are restricted.

-z
Enable <Ctrl>Z and SIGTSTP so pine can be suspended.

-conf
Produce a sample/fresh copy of the system-wide configuration file pine.conf on the standard output. This is distinct from the per-user .pinerc file.

-create_lu addrbook sort-order
Creates auxiliary index (lookup) file for addrbook and sorts addrbook in sort-order, which can be any of the following: don't-sort, nickname, fullname, nickname-with-lists-last, or fullname-with-lists-last. This is useful for creating global or shared address books.

-pinerc file
Output a fresh pinerc configuration to file.

-sort order
Sort the FOLDER INDEX to display in one of the following orders: arrival, subject, from, date, size, orderedsubj, or reverse. Arrival order is the default. The orderedsubj choice simulates a threaded sort. Any sort can be reversed by adding /reverse to it. reverse by itself is the same as arrival/reverse.

-option = value
Assign value to the configuration option. For example:
-signature-file=sig1
-feature-list=signature-at-bottom


NOTE: feature-list values are additive.

There are several levels of pine configuration. Configuration values at a given level override corresponding values at lower levels. In order of increasing precedence, the configuration values are: There is one exception to the rule that configuration values are replaced by the value of the same option in a higher-precedence file. The feature-list variable has values that are additive, but they can be negated by prepending ``no-'' to an individual feature name.

UNIX pine also uses the following environment variables:

Files


/usr/spool/mail/xxxx
Default folder for incoming mail.

~/mail
Default directory for mail folders.

~/.addressbook
Default address book file.

~/.addressbook.lu
Default address book index file.

~/.pine-debug[1-4]
Diagnostic log for debugging.

~/.pinerc
Personal pine configuration file.

~/.newsrc
News subscription and state file.

~/.signature
Default signature file.

~/.mailcap
Personal mail capabilities file.

~/.mime.types
Personal file extension to MIME-type mapping.

/etc/mailcap
System-wide mail capabilities file.

/etc/mime.types
System-wide file extension to MIME-type mapping.

/usr/local/lib/pine.info
Local pointer to system administrator.

/usr/local/lib/pine.conf
System-wide configuration file.

/usr/local/lib/pine.conf.fixed
Non-overridable configuration file.

/tmp/usr/spool/mail/xxxx
Per-folder mailbox lock files.

~/.pine-interrupted-mail
Interrupted message.

~/mail/postponed-msgs
Postponed messages.

~/mail/sent-mail
Outgoing message archive (FCC).

~/mail/saved-messages
Default destination for saving messages.

References

aliases(4), sendmail(1M), spell(1)

The Pine MUA in The Pine MUA


© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004