Command Line Arguments
Pine and PC-Pine can accept quite a few command-line arguments. Many of
these arguments overlap with variables in the Pine configuration file. If
there is a difference, then a flag set in the command line takes
precedence. Both Pine and PC-Pine expect command line arguments to be
preceded by the "-" (dash) as normally used by UNIX programs.
- [address]
- Send-to: If you put an unqualified string (or strings) in the
command line, Pine reads them as email addresses. Pine will startup in
the composer with a message started to the person/people specified. Once
the message is sent, the Pine session closes.
- -a
- Special anonymous mode for UWIN*.
- -conf
- Configuration: Prints a sample system configuration file to the
screen or standard output.
- -create_lu addrbook sort-order
- Create auxiliary index (LookUp) file for addrbook and sort
addrbook in sort-order, which may be dont-sort,
nickname, fullname, nickname-with-lists-last,
or fullname-with-lists-last. Only useful when creating global or
shared address books.
- -d debug-level
- Debug Level: Sets the level of debugging information written by
Pine. debug-level can be set to any integer 0-9. A debug level
of 0 turns off debugging for the session. (Actually there are some levels
higher than 9, now, but you probably don't want to see them.)
- -f folder
- Startup folder: Pine will open this folder in place of the standard
INBOX.
- -F file
- Open named text file and view with Pine's browser.
- -h
- Help: Prints the list of available command-line arguments to the
screen.
- -i
- Pine will start up in the FOLDER INDEX screen instead of the MAIN
MENU. Configuration equivalent: initial-keystroke-list=i
- -I a,b,c,...
- Initial Keystrokes: Pine will execute this comma-separated sequence
of commands upon startup. This allows users to get Pine to start in any
of its menus/screens. You cannot include any input to the composer in the
initial keystrokes. The key <Return> is represented by a ``CR'' in
the keystroke list; the spacebar is designated by the letters ``SPACE''.
Control keys are two character sequences beginning with ``^'', such as
``^I''. A tab character is ``TAB''. Function keys are ``F1'' - ``F12'' and
the arrow keys are ``UP'', ``DOWN'', ``LEFT'', and ``RIGHT''.
Configuration equivalent: initial-keystroke-list
- -k
- Function-Key Mode: When invoked in this way, Pine expects the input
of commands to be function-keys. Otherwise, commands are linked to the
regular character keys. Configuration equivalent:
use-function-keys included in feature-list.
- -l
- Folder-List: With "-l" set, Pine will default to an expanded folder
list. This means that the FOLDER LIST screen will always show all folders
in all collections. Default is to show the folders in the current
collection only. Configuration equivalent:
expanded-view-of-folders in feature-list.
- -n n
- Message-Number: When specified, Pine starts up in the FOLDER INDEX
screen with the current message being the designated message number.
- -nr
- Special mode for UWIN*.
- -o folder
- Opens the INBOX (or a folder specified via the -f argument) ReadOnly.
- -p file
- Uses the named file as the personal configuration file instead of
~/pinerc or the default PINERC search sequence PC-Pine uses.
- -P file
- Uses the named file as the system wide configuration file instead of
/usr/local/lib/pine.conf. UNIX Pine only.
- -pinerc file
- Output fresh pinerc configuration to file, preserving the
settings of variables that the user has made. Use file set to
``-'' to make output go to standard out.
- -r
- Restricted Mode: For UNIX Pine only. Pine in restricted mode can
only send email to itself. Save and export are limited.
- -sort key
- Sort-Key: Specifies the order messages will be displayed in for the
FOLDER INDEX screen. Key can have the following values:
subject, arrival, date, from, size, subject/reverse, arrival/reverse,
date/reverse, from/reverse, size/reverse. The default value is "arrival".
The key value reverse is equivalent to arrival/reverse. This
option will be expanded in the future to allow sorting on "to" and "cc".
Configuration equivalent: sort-key.
- -z
- Enable Suspend: When run with this flag, the key sequence ctrl-z
will suspend the Pine session. Configuration equivalent:
enable-suspend included in feature-list.
- -option=value
- Assign value to the config option option. For
example, -signature-file=sig1 or
-feature-list=signature-at-bottom (Note: feature-list values are
additive).
* UWIN = University of Washington Information Navigator