Go to the previous, next, section, table of contents.

1.3 Options

The Napsaterm can be given either command line options or icon tool types.

1.3.1 General Options

-V
Displays the current version number and copyright notice. There is no corresponding tool type.
-l file
LOGFILE=filename
Logs the terminal output into specified file.
-w
WAITTOEND
Wait for a keypress before closing the emulation window after the input stream has finished.
WAITTOEND=NOT
Negative form of previous tool type.

1.3.2 Device Options

-d device
DEVICE=name
Uses specified device. The device may be any device compatible with serial.device (normal Exec device name) or one of the following:
-u unit
UNIT=number
causes Napsaterm to use the specified unit of the device. It has no effect when using TCP/IP or DNet.
-N network
Uses the specified DNet network. This option is not currently implemented. There is no corresponding tool type.
-B linespeed
LINESPEED=number
Starts the Napsaterm with specified line speed (as bits per second). This parameter is used with `serial.device' and section 1.7.1 Rlogin protocol.
--shared
SHARED
If this option is specified, Napsaterm will open the device specified in shared mode. This allows Napsaterm to share the serial port with other applications which also can open the serial port in shared mode (including another Napsaterm). You can also prevent Napsaterm from reading characters from serial device, see Unlisten menu command.
--stdio
Causes Napsaterm to display whatever comes from standard input, and send all keystrokes to standard output. For example: 
Napsaterm --stdio < filein > fileout
would display file in a Napsaterm window. There is no corresponding tool type.
-r login name
REMOTENAME=login name
This option or tool type is used to specify user name in the remote system when using the section 1.7.1 Rlogin protocol.
REMOTETYPE=terminal type
This tool type specifies the terminal type used in the remote system when using the section 1.7.1 Rlogin protocol.
-s service
SERVICE=service
causes Napsaterm to use the specified TCP service or port number. You can either give a service name from `AmiTCP:db/services' or the directly the port port number. This option or tool type is valid only with telnet protocol.

1.3.3 Emulation Options

EMULATION=terminal type
Select the emulation type to use. The emulation type can be chosen with following options from the command line.
--vt102
Emulate a vt102 terminal.
--vt52
Emulate a vt52 terminal.
--h19
Emulates a ht19 terminal.
NATIONAL=mode
Determines the national mode used. National modes are (valid abbreviation for each mode in parenthesis):
* `None' (`No')
* `Multinational' (`Mu')
* `National' (`Na')
National modes.
NATION=Nation name
Specifies the used nation. Valid nations are as follows (valid abbrevations for each nation in parenthesis):
* `US ASCII', (`US')
* `Danish', (`Da')
* `Finnish', (`Fi')
* `French', (`Fr')
* `German', (`Ge')
* `Norwegian', (`No')
* `Swedish', (`Sw')
* `UK ASCII', (`UK')
Default nation is `US'.
KEYMAP=[nation/]mapname
KEYBOARD=[nation/]mapname
These tool types are synonymous. They specify the keymap the Napsaterm will use. It is possible to change also a specific national keymap, for instance the tool type KEYMAP=Finnish/sf7 will change the Finnish national keymap to `sf7'. For default national keymaps, see section 1.6.1 National Keymaps.
KEYPAD=[numeric/application]
--numeric
--application
These options and tool type control the behauvior of keypad. If the option --numeric is specified or the tool type `KEYPAD' has value NUMERIC, the keypad is in normal mode. If the option --application is specified or the tool type `KEYPAD' has value APPLICATION, the keypad is in the application mode. In application mode, the vt100 control sequencies will be sent to remote host instead of normal characters. This is handy for text editors and the like that use the keypad as a function keypad.
--slow
Starts in slow mode. This mode is useful only watching some vt102 animations with --stdio option. There is no corresponding tool type.
MOUSE=events
This tool type controls which kind of mouse events are sent to the remote end.
OFF
Don't send mouse clicks
DOWN
Send an event only when user presses the select button
UP
Send a mouse event only when user releases the select button
BOTH
Send both up- and downward clicks
When mouse events are enabled Napsaterm sends the following sequence when the user presses the left (selection) button on the Amiga mouse: 
ESC M quals column line
where column and line are bytes that represent the x, y coordinates of the mouse click (offset by 32; a click on (0, 0) results in sending two space characters), and quals is like so:
bit 0
Control key
bit 1
Shift key
bit 2
Meta (alt) key
bit 3
Caps lock
bit 4
Mouse down event
bit 5
Mouse up event
bit 6
Always on (making qual a printable value)
For example, clicking on column 1, row 1 results in the escape sequence 
ESC M P SPC SPC
BACKSPACE2DELETE
This switch tool type causes the backspace key mapped to Delete.
DELETE2BACKSPACE
This switch tool type causes the Delete key mapped to Backspace.
CURSORBLINK
By default, Napsaterm has a solid cursor. Setting this tool type will cause cursor to blink at the rate of once per second.
CURSOR=type
Available cursor types are `Invisible', `Underlined' and `Block'.
--ic
This option causes Napsaterm to start up with an invisible cursor.
BELL=type
Available bell types are `Visual', `Audio', `Both', `None' and `Display'. The visual bell flashes the Napsaterm window, audio bell plays a simple beep with `audio.device'. Both of them can be used at the same time. The display bell uses Intuition function DisplayBeep().
PASS8
Prevents Napsaterm from stripping off the 8th bit of the input stream character. This is the default mode.
-7
PASS8=NOT
Causes Napsaterm to strip off the 8th bit of the incoming characters. This is useful, if the input may contain 7 bit characters with parity enabled.
CTRL8BIT
Prevents Napsaterm from converting the 8-bit control codes to escape sequences. Normally, Napsaterm converts any 8-bit control character (ie. ASCII codes from 128 to 159) to a two character escape sequence. The escape sequences consist of a ESC code and original control character code minus 64. For example, CSI (ASCII code 155) will be converted to escape sequence ESC [, the ASCII code of [ is 91, 155 - 64.
CTRL8BIT=NOT
Causes Napsaterm to convert the 8bit control codes to escape sequences.
-v
INVERSE
Starts up with an inverted window. This may be controlled by terminal codes when emulating a VT102 terminal. See also section 1.4.3 Setup Menu.
ALTISMETA
If this tool type is given, the left alt key on the keyboard will act as a meta key. If the left alt key is pressed down, all single character key sequences will be prefixed by ESC character. This is particularly useful for emacs.

1.3.4 Display Options

These preferences or tool types affect the Napsaterm window, its size, placement and title.

-g geometry
GEOMETRY=specification
Sets up the window geometry. The format for geometry is /left/top/width/height. A value of -1 for the width or height makes the window stretch to the right edge or bottom of the screen. A value of -1 for the top makes the window's top edge appear just below the screen title bar. The left and top are specified in pixels. The width and height are specified in characters.
-S screen
PUBSCREENNAME=name
Opens the Napsaterm window on the specified public screen. If the screen don't exist, open the window on the default public screen (which is normally the Workbench Screen).
-f fontname
BASEFONT=font/size
Sets the font for the Napsaterm window. By default the font `napsa 11' or, if `napsa 11' cannot be found, `topaz 8' is used. If you wish to use a different font such as courier 11, simply specify font as courier/11. If the font you choose is not fixed width, strange and unusual things will happen. For more information of Napsaterm fonts see section 1.5 How Napsaterm Uses Fonts.
-p programtitle
TITLE=string
Draws the program title with given text. The actual window title is concatenated with display size indicator (width × height). Normal title is the remote host name when using rlogin, otherwise Napsaterm.
SIZEGADGET=type
This tool type controls which border of the window the window's sizing gadget will appear in. If you have a sizing gadget on a window, you must lose some of the window space for the border to contain it. This preference controls whether you lose rows, columns, or nothing. If you choose none, the window will not have a size gadget, and will therefore not be resizeable. It is useful if you want an 80x24 window to take up the smallest possible screen space. If you choose column, the sizing gadget will be on the right border, and if row, the sizing gadget will be on the bottom border.
--80
FIXEDCOLUMNS
If this option or tool type is given Napsaterm won't use no more than 80 columns of text. This is useful for running programs written for terminals that assume the terminal has 80 columns.

1.3.5 Host Names

HOST=name[|name2...]

The tool type HOST is used to specify remote host name(s). The host names should be given in standard internet format.

When Napsaterm is started from command line, command line arguments which do not start with hyphen are regarded as host names. If you need to use host name which begins with hyphen `-', give a single hyphen as an argument after all options and before the host name. 

Napsaterm -d net - -weird.host.name.in.net

If Napsaterm is given multiple host names, it will randomly connect to one of them.

The following command causes Napsaterm connect to either `punkku' or `vinkku': 

run Napsaterm -g 0/-1/80/30 punkku vinkku

1.3.6 Preference File

The preference file `AmiTCP:db/NapsaPrefs' contains default preferences when you invoke Napsaterm from CLI.

The preference file contains tool-type-like options given in a X-resource-look-a-like format. The preference file format is compatible with NiftyTerm and older Napsaterm versions. Each row in the preference file has format as follows: 

[command name`.']preference name`:' value

Preference name is the part of the line before the `:' character, preference value is the part after it.

Unless otherwise specified, preference name and value are case-insensitive. Unregocnized preference names are ignored, unrecognized values revert to default.

If the corresponding tool type is a switch, the preference value should be `1', `true' or `yes', or the preference is silently ignored.

Tool type Host has no corresponding preference.

See section 1.3.6.1 Using Alternative Command Names, if you need many different default preference sets.

For compatibility reasons, if the file `AmiTCP:db/NapsaPrefs' does not exist, also the files `S:NapsaPrefs' and `S:NiftyPrefs' are searched for preferences.

1.3.6.1 Using Alternative Command Names

If the preference name is prefixed with command name, it is valid only when Napsaterm is invoked with that name. You can invoke Napsaterm with a different name, if you rename the Napsaterm program file or make a new link to it. For example, you could make following links 

makelink AmiTCP:bin/NapsatermUS AmiTCP:bin/Napsaterm
makelink AmiTCP:bin/NapsatermUK AmiTCP:bin/Napsaterm

and you have added following preferences 

Nation: Finnish
Napsaterm.Nation: US
NapsatermUK.Nation: UK

If you started Napsaterm with the command `Napsaterm', you could use Finnish keyboard (`s') and character set (ISO 646 SF-2). If you gave command `NapsatermUK', you would get the British keyboard (`uk') and character set (UK-ASCII).

Go to the previous, next, section, table of contents.