NapsaTerm

VT100 Terminal Emulator

Version 3.8

13 May 1994

by Pekka Pessi, <Pekka.Pessi@hut.fi>

Copyright © 1993 AmiTCP/IP Group, <amitcp-group@hut.fi>, Helsinki University of Technology, Finland.

Napsaterm is based on Niftyterm terminal emulator by Christopher Newman and Todd Williamson.

Niftyterm is Copyright © 1989, 1990 Christopher J. Newman and Todd Williamson All Rights Reserved.


\input texinfo

[ < ] [ > ]   [Contents] [Index] [ ? ]

NapsaTerm 3

NapsaTerm is a VT100 terminal emulator and rlogin client for AmiTCP/IP.

This is edition 1.3.1 of the NapsaTerm documentation, 13 May 1994, for Napsaterm version 3.8.


[ << ] [ < ] [ Up ] [ > ] [ >> ]         [Top] [Contents] [Index] [ ? ]

1 About Authors

NapsaTerm is © copyright 1991, 1993, 1994 Pekka Pessi and AmiTCP/IP Group. Our e-mail address is <AmiTCP-Group@hut.fi>. You can reach us by mail with address

AmiTCP/IP Group
c/o Pekka Pessi
Jämeräntaival 11E122
FI-02150  Espoo
Finland, Europe

Members of the AmiTCP/IP Group and their e-mail addresses are

Tomi Ollila, <Tomi.Ollila@cs.hut.fi>
Pekka Pessi, <Pekka.Pessi@hut.fi>
Markus Peuhkuri, <Markus.Peuhkuri@hut.fi>
Jarno Rajahalme, <Jarno.Rajahalme@hut.fi>

We are interested to continuously develop NapsaTerm and AmiTCP/IP. If you improve NapsaTerm or fix bugs, please send the changes to us.

The Tektronix emulation is written by Robert A. Knop, <rknop@cco.caltech.edu>. He has also written some new features and bug fixes to VT100 emulation.


[ << ] [ < ] [ Up ] [ > ] [ >> ]         [Top] [Contents] [Index] [ ? ]

Copying NapsaTerm

NapsaTerm is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2, or (at your option) any later version.

NapsaTerm is distributed in the hope that it will be useful, but without any warranty; without even the implied warranty of merchantability or fitness for a particular purpose.

You should have received a copy of the GNU General Public License along with NapsaTerm or with AmiTCP/IP; see the file COPYING. If not, please contact the authors.


[ << ] [ < ] [ Up ] [ > ] [ >> ]         [Top] [Contents] [Index] [ ? ]

1.1 Niftyterm Licence

Niftyterm is © copyright 1989, 1990 Christopher J. Newman and Todd Williamson
All Rights Reserved.

Permission to use, copy, modify, distribute, and sell this software and its documentation for any purpose is hereby granted without fee, provided that the above copyright notices appear in all copies and that both that copyright notices and this permission notice appear in supporting documentation, and that the names of Christopher J. Newman and Todd Williamson not be used in advertising or publicity pertaining to distribution of the software without specific, written prior permission. Christopher J. Newman and Todd Williamson make no representations about the suitability of this software for any purpose. It is provided "as is" without express or implied warranty.

CHRISTOPHER J. NEWMAN AND TODD WILLIAMSON DISCLAIM ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL CHRISTOPHER J. NEWMAN OR TODD WILLIAMSON BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

Authors: Christopher J. Newman and Todd Williamson
Niftyterm source code is available upon request. Send a disk and a self-addressed mailer to the address below, and I’ll send you a copy.

If you find this program useful, Chris and I would certainly appreciate a donation to support further development:

Todd Williamson
5440 Fifth Avenue Apt. 59
Pittsburgh, Pa.  15232-2243

[ << ] [ < ] [ Up ] [ > ] [ >> ]         [Top] [Contents] [Index] [ ? ]

2 Invoking NapsaTerm from Shell

You can start NapsaTerm with following command line options and parameters:

NapsaTerm [-V] [--vt102] [--vt52] [--h19] [-7] [-l file] [--slow]
          [-g geometry] [--80] [-f fontname] [-p programtitle] [-S screen]
          [--ic] [-v] [--application] [--numeric] [-w] 
          [-d device] [-u unit] [-B linespeed] [--shared] [--stdio] 
          [-N net] [-s service] [-r remotename] [host]

Command line options can be entered in any order and any combination (except those that override each other). Single character options begin with single hyphen and can have optional arguments, multicharacter options begin with double hyphen. The rest of the command line arguments are interpreted as host names. With Preference File you can change the default preferences of ‘NapsaTerm’.


[ << ] [ < ] [ Up ] [ > ] [ >> ]         [Top] [Contents] [Index] [ ? ]

3 Invoking NapsaTerm from Workbench

You can start NapsaTerm from Workbench with various tool types to accommodate your personal preferences.

If you are using a project icon with NapsaTerm as tool, the tooltypes of the project icon will override the tool types of the tool icon.

LOGFILE=filename
WAITTOEND

See section General Options.

DEVICE=name
UNIT=number
LINESPEED=number
SHARED
REMOTENAME=login name
REMOTETYPE=terminal type
SERVICE=service type

See section Device Options.

EMULATION=terminal type
NATIONAL=mode
NATION=Nation name
KEYMAP=[nation/]mapname
KEYBOARD=[nation/]mapname
KEYPAD=[numeric/application]
MOUSE=events
BACKSPACE2DELETE
DELETE2BACKSPACE
CURSORBLINK
CURSOR=type
BELL=type
PASS8
CTRL8BIT
INVERSE
ALTISMETA

See section Emulation Options.

GEOMETRY=specification
PUBSCREENNAME=name
BASEFONT=font/size
TITLE=string
SIZEGADGET=type
FIXEDCOLUMNS

See section Display Options.

HOST

See section Host Names.


[ << ] [ < ] [ Up ] [ > ] [ >> ]         [Top] [Contents] [Index] [ ? ]

4 Options

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


[ << ] [ < ] [ Up ] [ > ] [ >> ]         [Top] [Contents] [Index] [ ? ]

4.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.


[ << ] [ < ] [ Up ] [ > ] [ >> ]         [Top] [Contents] [Index] [ ? ]

4.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.

There is no corresponding tool type.

-N network

Uses the specified DNet network. This option is not currently implemented.

-B linespeed
LINESPEED=number

Starts the NapsaTerm with specified line speed (as bits per second). This parameter is used with ‘serial.device’ and 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 section 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.

REMOTENAME=login name

This tool type is used to specify user name in the remote system when using the Rlogin protocol.

REMOTETYPE=terminal type

This tool type specifies the terminal type used in the remote system when using the Rlogin protocol.

REMOTETYPE=terminal type

Napsaterm connects to the service or server port which is specified by this tool type or option when using Serial devices.


[ << ] [ < ] [ Up ] [ > ] [ >> ]         [Top] [Contents] [Index] [ ? ]

4.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’)

See section 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 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 DEL.

BACKSPACE2DELETE=NOT

Negative form of previous tool type.

DELETE2BACKSPACE

This switch tool type causes the Delete key mapped to Backspace.

DELETE2BACKSPACE=NOT

Negative form of previous tool type.

CURSORBLINK

By default, NapsaTerm has a solid cursor. Setting this tool type will cause cursor to blink at the rate of once per second.

CURSORBLINK=NOT

Negative form of previous tool type.

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 Setup Menu.

INVERSE=NOT

Negative form of previous tool type.

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.

ALTISMETA=NOT

Negative form of previous tool type.


[ << ] [ < ] [ Up ] [ > ] [ >> ]         [Top] [Contents] [Index] [ ? ]

4.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 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.

FIXEDCOLUMNS=NOT

Negative form of previous tool type.


[ << ] [ < ] [ Up ] [ > ] [ >> ]         [Top] [Contents] [Index] [ ? ]

4.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

[ << ] [ < ] [ Up ] [ > ] [ >> ]         [Top] [Contents] [Index] [ ? ]

4.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 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.


[ << ] [ < ] [ Up ] [ > ] [ >> ]         [Top] [Contents] [Index] [ ? ]

4.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).


[ << ] [ < ] [ Up ] [ > ] [ >> ]         [Top] [Contents] [Index] [ ? ]

5 Using Menus

NapsaTerm have three menus, ‘Command’, ‘Edit’ and ‘Setup’. The ‘Command’ menu contains terminal control commands. The ‘Edit’ menu handles the clipboard. The ‘Setup’ menu allows the user to adjust the way ‘NapsaTerm’ functions.


[ << ] [ < ] [ Up ] [ > ] [ >> ]         [Top] [Contents] [Index] [ ? ]

5.1 Command Menu

The ‘Command’ menu contains terminal control commands.

Clear Screen Amiga-S

Moves the current NapsaTerm prompt to the top of the NapsaTerm window and clears the screen.

To Tek4010 Amiga-G

Selects the Tek4010 emulation and activates the Tek4010 window.

To VT102 Amiga-T

Selects the VT102 emulation and activates the VT102 window.

Soft Reset Amiga-R

Resets all terminal styles, scroll regions, and invert mode.

Flush Amiga-F

Flushes the buffers for the current device. Useful if you did something that will cause a lot of output, and you want to tell NapsaTerm not to display it all.

Break Amiga-B

Sends a break signal to the current device.

Break’ is enabled only when NapsaTerm is connected to a serial device.

Unlisten Amiga-U

NapsaTerm will cease to talk to whatever device it is connected to, so that another program can use it exclusively. Note that all keyboard input is flushed as well until you select ‘Listen’ menu option.

Unlisten’ is enabled only when NapsaTerm is started in ‘Shared’ mode.

Listen Amiga-L

NapsaTerm restarts talking and listening to device it is connected to.

Listen’ is enabled after ‘Unlisten’ is selected.

An example of usage for ‘UnListen’ and ‘Listen’: you’re logged in and you want to save something to a log file. You had foresight and started NapsaTerm in shared mode. You select ‘Unlisten’ and start another NapsaTerm writing to a log file. When you have everything in the log file, you quit the second NapsaTerm and select ‘listen’ the original. This option might be useful if someone wants to write some stand-alone file transfer utilities.

Quit Amiga-Q

Exits NapsaTerm and closes the window.


[ << ] [ < ] [ Up ] [ > ] [ >> ]         [Top] [Contents] [Index] [ ? ]

5.2 Edit Menu

The ‘Edit’ menu handles the clipboard.

Copy Amiga-C

Copies the selected text into the clipboard. You can put the text you copied most recently back into any document by choosing ‘Paste’.

Paste Amiga-P

Copies the most recently copied text to the current cursor position.

Move Amiga-M

If a previous command or some text is selected in the NapsaTerm window, ‘Move’ inserts the text as if it had been typed.

Execute Amiga-E

The same as ‘Move’, only it follows the text with a LF character.


[ << ] [ < ] [ Up ] [ > ] [ >> ]         [Top] [Contents] [Index] [ ? ]

5.3 Setup Menu

The ‘Setup’ menu allows the user to adjust the way ‘NapsaTerm’ functions.

National Mode

See section Tool type NATIONAL.

Nation

See section Tool type NATION.

Terminal Type

See section Tool type EMULATION.

Backspace is sent as

See section Tool type BACKSPACE2DELETE.

Del is sent as

See section Tool type DELETE2BACKSPACE.

Left Alt key is

See section Tool type ALTISMETA.

Keypad

See section Tool type KEYPAD.

Mouse Events

See section Tool type MOUSE.

Control Codes

See section Tool type CTRL8BIT.

Cursor

See section Tool type CURSOR.

Display Width

See section Tool type FIXEDCOLUMNS.

Display Speed

See section Option --slow.

Bell Type

See section Tool type BELL.

Reverse

See section Tool type INVERSE.

Ansi_LNM

Controls whether <RETURN> should be sent as CR-LF sequence.


[ << ] [ < ] [ Up ] [ > ] [ >> ]         [Top] [Contents] [Index] [ ? ]

6 How NapsaTerm Uses Fonts

NapsaTerm should be able to use any fixed-width font. However, standard Amiga fonts do not represent the VT100’s character set very well. Included with this NapsaTerm is a set of fonts with names starting with ‘Napsa’. Some explanation of these fonts is in order.

NapsaTerm starts out with a base font name, something like ‘topaz’ or ‘Napsa’. If NapsaTerm needs an italic or bold font, it first looks in the fonts: directory to see if there is a version of the current font which was designed to be italic or bold. If not, it uses the Amiga’s internal functions to construct one. When it needs one of the special VT100 character sets, it appends an extension to the font name and looks for a font of the same size as the current font with the new name. The extensions are as follows:

v

alternate character set

w

double-width font

t

top half of double-width double-height font

b

bottom half of double-width double-height font

vw’, ‘vt’, and ‘vb’ are also extensions, meaning the alternate character set version of the different-sized font. So, for example, if NapsaTerm was using the font ‘Napsa/11’, and it needed a double-width font, it would look for the font ‘Napsaw/11’.

The fonts that come with the distribution are designed to be used on screens where the pixels are roughly as wide as they are tall. Any of the 640×400 graphics modes fall into this category. In the 640×200 modes, the fonts will seem too tall.

If anyone creates any fonts for use with NapsaTerm or Niftyterm, I’d like to get a copy of them.


[ << ] [ < ] [ Up ] [ > ] [ >> ]         [Top] [Contents] [Index] [ ? ]

7 National Modes

The national mode is set with tool type ‘NATIONAL’ There are three different national modes in NapsaTerm.

None

By default, when no national mode in not in use, (None, abbreviated as NO), NapsaTerm uses the ISO-8857 Latin 1 character set, the standard character set used in Amiga. By default, NapsaTerm uses either the default system keymap or the keymap specified with tool type KEYMAP, if any.

Multinational

In the Multinational mode (abbreviated as MU) NapsaTerm uses the Latin 1 character set and the appropriate national keymap. See National Keymaps for a list of default national keymap names. A specific national keymap can also be specified with tool type KEYMAP or KEYBOARD.

National

In the National mode (abbreviated as NA) NapsaTerm uses the appropriate national 7 bit character set and the national keymap. See National Character Tables for tables of national character sets.


[ << ] [ < ] [ Up ] [ > ] [ >> ]         [Top] [Contents] [Index] [ ? ]

7.1 National Keymaps

Default national keymaps are as follows:

• ‘US ASCII’ uses (‘usa1’)
• ‘Danish’, (‘dk’)
• ‘Finnish’, (‘s’)
• ‘French’, (‘f’)
• ‘German’, (‘d’)
• ‘Norwegian’, (‘n’)
• ‘Swedish’, (‘s’)
• ‘UK ASCII’, (‘gb’)

You can change national keymap with tool type ‘KEYMAP’=nation/keymapname, for example

KEYMAP=Finnish/s-term

changes the Finnish keymap to ‘s-term’. You can abbreviate the nation name, See section tool type NATION.


[ << ] [ < ] [ Up ] [ > ] [ >> ]         [Top] [Contents] [Index] [ ? ]

7.2 National Character Tables

NapsaTerm uses ISO 646 national character codes as follows:

DEC        35  36  64  91  92  93  94  96 123 124 125 126
=========================================================
US-ASCII   #   $   @   [   \   ]   ^   `   {   |   }   ~  
             
Danish     #   $   @   Æ   Ø   Å   ^   `   æ   ø   å   ~  
             
Finnish    #   $   @   Ä   Ö   Å   ^   `   ä   ö   å   ~  
             
French     #   $   à   °   ç   §   ^   `   é   ù   è   ¨  
             
German     #   $   §   Ä   Ö   Ü   ^   `   ä   ö   ü   ß  
             
Norwegian  #   ¤   É   Æ   Ø   Å   Ü   é   æ   ø   å   ü  
             
Swedish    #   ¤   É   Ä   Ö   Å   Ü   é   ä   ö   å   ü  
             
UK-ASCII   £   $   @   [   \   ]   ^   `   {   |   }   ~  
=========================================================
HEX        23  24  40  5B  5C  5D  5E  60  7B  7C  7D  7E  


[ << ] [ < ] [ Up ] [ > ] [ >> ]         [Top] [Contents] [Index] [ ? ]

8 Using Different IO Modes

NapsaTerm provides four different ways to do the terminal IO.


[ << ] [ < ] [ Up ] [ > ] [ >> ]         [Top] [Contents] [Index] [ ? ]

8.1 Rlogin protocol

The rlogin protocol is described in the RFC 1282. It is a Unix-specific remote terminal session protocol, somewhat like Serial devices but with different features. The remote rlogin session get your the user name, terminal type and line speed from the rlogin client.

Rlogin protocol uses your local hostname (domain name of the computer you are logging from), your local user name and user name at the rlogin server for authentication. If there is a matching entry in the ‘rhosts’ files, the rlogin server let you log in without asking the password. If no match is found, rlogin server asks you for the password for the remote user. If it is not correct, it reverts to normal login procedure.

NapsaTerm is used as a rlogin client for AmiTCP/IP. Currently NapsaTerm gets the local user name from environment variable ‘USER’. The remote user name is same as your local user name unless you specify tool type ‘RemoteName’.

For example, your local user name is ‘ppessi’, but remote user name is ‘t35082k’. If not told otherwise, NapsaTerm will introduce your as ‘ppessi’ to the remote machine. As the rlogin server regards it as the password of account of ‘ppessi’, you can not give your password at the first ‘Password:’ prompt. You should use tool type ‘RemoteName’:

RemoteName=t35082k

Now you can enter password for ‘t35082k’’s account without typing the user name each time.

You should add an entry to your ‘.rhosts’ file in a Unix machine only if your Amiga is trustworthy — that is, nobody else but you can use it and it is in secure network. A ‘.rhosts’ entry consists of a host name and a user name in that host. The host name is the canonic host name of machine you are logging from. For example, if you have account ‘t35082k’ in machine called ‘kaira.hut.fi’, you could add following line to your ‘.rhosts’ file:

kaira.hut.fi t35082k

The line speed has additional meaning when using rlogin protocol. Some Unix programs and terminal drivers use the nominal terminal speed to determine the throughput of your connection. There may be a problem if the speed is 300 b/s (or even 9600 b/s) while you are using Ethernet. Likewise the nominal speed of 38400 b/s over a 2400 b/s slip connection is likely to cause trouble. You can determine your nominal speed in the Unix systems with the ‘stty’ command.


[ << ] [ < ] [ Up ] [ > ] [ >> ]         [Top] [Contents] [Index] [ ? ]

8.2 Serial devices

The Telnet protocol is described in various RFC documents. It is a generic remote session protocol with rich features and more general use than Rlogin protocol.

Currently the Napsaterm supports terminal type and size negotation. It does not pass your user name to telnet server.


[ << ] [ < ] [ Up ] [ > ] [ >> ]         [Top] [Contents] [Index] [ ? ]

8.3 Serial devices

NapsaTerm can use any ‘serial.device’-compatible Exec device. You can specify the device name and unit number with tool types or command line options. See section Device Options.

You can start NapsaTerm in shared mode, See section --shared. In shared mode other programs (like another NapsaTerm) can open serial device in the same time. The actual input data is is not shared, but all programs will read the data from device in their turn. NapsaTerm can stop reading data from serial device, see See section Unlisten.


[ << ] [ < ] [ Up ] [ > ] [ >> ]         [Top] [Contents] [Index] [ ? ]

8.4 DNet

DNet is a serial line multiplexing protocol with priorities and provisions for server/client architecture. It works between Amigas and Unix machines running 4BSD or SunOS. There are ports for different 4BSD variants and Linux. There exists many network-type applications for DNet.

If you are using DNet, you can use NapsaTerm instead of ‘FTerm’.


[ << ] [ < ] [ Up ] [ > ] [ >> ]         [Top] [Contents] [Index] [ ? ]

8.5 DOS IO

The input and output of NapsaTerm can be read from and written to standard input and standard output DOS IO streams. For example, if you want to view a VT100 animation with NapsaTerm, you can give command

NapsaTerm --slow --stdio < vt100-animation-file

[ << ] [ < ] [ Up ] [ > ] [ >> ]         [Top] [Contents] [Index] [ ? ]

9 Tektronix emulation

There are two versions of Napsaterm binaries in distribution archive, one with Tektronix emulation and one without. The tektronix emulation is implemented in separate window, the VT100 window works as usually.

Two menu items have been added to Tektronix emulation version. They are ‘To VT102’ and ‘To Tek4010’. When a emulation window (tek or vt) is selected, it may be brought to the front and activated (depending on settings of the config menus on the Tek4010 window). However, if you click in a window, or bring it to the front, it does not necessarily make it the one receiving data from the host. The ‘To Tek4010’ and ‘To VT102’ menu items in each screen switch that, as can certain escape sequences from the host.


[ << ] [ < ] [ Up ] [ > ] [ >> ]         [Top] [Contents] [Index] [ ? ]

10 NapsaTerm History

NapsaTerm is derived originally from Niftyterm 1.2. It is called NapsaTerm because original authors wanted to keep distinction clear between it and their versions of Niftyterm. See section Niftyterm Licence.

There are some features in NapsaTerm 3 which are incompatible with earlier versions or with NiftyTerm 1.2.


[ << ] [ < ] [ Up ] [ > ] [ >> ]         [Top] [Contents] [Index] [ ? ]

10.1 Changed in Version 3.8


[ << ] [ < ] [ Up ] [ > ] [ >> ]         [Top] [Contents] [Index] [ ? ]

10.2 Changed in Version 3.7


[ << ] [ < ] [ Up ] [ > ] [ >> ]         [Top] [Contents] [Index] [ ? ]

10.3 Changed in Versions 3.4 and 3.5

Robert Knop, <rknop@cco.caltech.edu>, released these versions. The major new feature in these releases is the Tektronix emulation. Any bug reports on the tek4010 emulation should be sent to Rob Knop.


[ << ] [ < ] [ Up ] [ > ] [ >> ]         [Top] [Contents] [Index] [ ? ]

10.4 Changed in Version 3.3


[ << ] [ < ] [ Up ] [ > ] [ >> ]         [Top] [Contents] [Index] [ ? ]

10.5 Changes in Version 3.2 (3beta)


[ << ] [ < ] [ Up ] [ > ] [ >> ]         [Top] [Contents] [Index] [ ? ]

10.6 Changes in Version 2.2


[ << ] [ < ] [ Up ] [ > ] [ >> ]         [Top] [Contents] [Index] [ ? ]

10.7 Changes in Version 2.1


[ << ] [ < ] [ Up ] [ > ] [ >> ]         [Top] [Contents] [Index] [ ? ]

10.8 Changes in Version 2.0

The AmiTCP/IP BSD socket interface was added to NapsaTerm after the porting of real rlogin program seemed to take too much effort and time. The Rlogin protocol is a very simple. However asynchronous, interactive IO with AmigaDOS is quite ineffective and quite complex to implement. Fortunately Niftyterm IO implementation was extremely flexible and it was easy to add new IO methods for rlogin.


[ << ] [ < ] [ Up ] [ > ] [ >> ]         [Top] [Contents] [Index] [ ? ]

10.9 NapsaTerm 1.3 Compared to Niftyterm 1.2


[ << ] [ < ] [ Up ] [ > ] [ >> ]         [Top] [Contents] [Index] [ ? ]

Glossary


[ << ] [ < ] [ Up ] [ > ] [ >> ]         [Top] [Contents] [Index] [ ? ]

Index

Jump to:   -   .   ~  
A   B   C   D   E   F   G   H   I   K   L   M   N   O   P   R   S   T   U   V   W  
Index Entry  Section

-
---80 option 4.4 Display Options
---application option 4.3 Emulation Options
---h19 option 4.3 Emulation Options
---ic option 4.3 Emulation Options
---numeric option 4.3 Emulation Options
---shared option 4.2 Device Options
---slow option 4.3 Emulation Options
---stdio option 4.2 Device Options
---vt102 option 4.3 Emulation Options
---vt52 option 4.3 Emulation Options
-7 option 4.3 Emulation Options
-B option 4.2 Device Options
-d option 4.2 Device Options
-f option 4.4 Display Options
-g option 4.4 Display Options
-l option 4.1 General Options
-N option 4.2 Device Options
-p option 4.4 Display Options
-r option 4.2 Device Options
-s option 4.2 Device Options
-S option 4.4 Display Options
-u option 4.2 Device Options
-V option 4.1 General Options
-v option 4.3 Emulation Options
-w option 4.1 General Options

.
.rhosts file 8.1 Rlogin protocol

~
~/.rhosts file 8.1 Rlogin protocol

A
Alternate character set 6 How NapsaTerm Uses Fonts
Alternative command names 4.6.1 Using Alternative Command Names
ALTISMETA tool type 4.3 Emulation Options
AmiTCP/IP Group 1 About Authors

B
BACKSPACE2DELETE tool type 4.3 Emulation Options
BASEFONT tool type 4.4 Display Options
BELL tool type 4.3 Emulation Options
Break menu item 5.1 Command Menu

C
Changing command name 4.6.1 Using Alternative Command Names
Clear Screen menu item 5.1 Command Menu
Command line interface 2 Invoking NapsaTerm from Shell
Command menu 5.1 Command Menu
Copying Copying NapsaTerm
CTRL8BIT tool type 4.3 Emulation Options
CURSOR tool type 4.3 Emulation Options
CURSORBLINK tool type 4.3 Emulation Options

D
Default national keymaps 7.1 National Keymaps
DELETE2BACKSPACE tool type 4.3 Emulation Options
detaching 10.9 NapsaTerm 1.3 Compared to Niftyterm 1.2
Device options 4.2 Device Options
DEVICE tool type 4.2 Device Options
Display options 4.4 Display Options
DNet 8.4 DNet
DOS IO 8.5 DOS IO
Double-height font 6 How NapsaTerm Uses Fonts
Double-width font 6 How NapsaTerm Uses Fonts

E
Edit menu 5.2 Edit Menu
Emulation options 4.3 Emulation Options
EMULATION tool type 4.3 Emulation Options
Environment variable USER 8.1 Rlogin protocol

F
FIXEDCOLUMNS tool type 4.4 Display Options
Flush menu item 5.1 Command Menu
Fonts 6 How NapsaTerm Uses Fonts
FTerm 8.4 DNet

G
General options 4.1 General Options
GEOMETRY tool type 4.4 Display Options

H
Host names 4.5 Host Names
HOST tool type 4.5 Host Names

I
Icon interface 3 Invoking NapsaTerm from Workbench
Interlace screen 6 How NapsaTerm Uses Fonts
Intuition menus 5 Using Menus
INVERSE tool type 4.3 Emulation Options
Invoking from CLI 2 Invoking NapsaTerm from Shell
Invoking from workbench 3 Invoking NapsaTerm from Workbench
IO modes 8 Using Different IO Modes
ISO 646 7.2 National Character Tables
ISO 8857-Latin-1 10.9 NapsaTerm 1.3 Compared to Niftyterm 1.2

K
KEYBOARD tool type 4.3 Emulation Options
KEYMAP tool type 4.3 Emulation Options
Keymaps 7.1 National Keymaps
KEYPAD tool type 4.3 Emulation Options
Knop, Robert 1 About Authors

L
Latin 1 10.9 NapsaTerm 1.3 Compared to Niftyterm 1.2
Licence Copying NapsaTerm
Licence, Niftyterm 1.1 Niftyterm Licence
Line speed 8.1 Rlogin protocol
LINESPEED tool type 4.2 Device Options
LOGFILE tool type 4.1 General Options

M
Menus, Intuition 5 Using Menus
Mononational mode 7 National Modes
MOUSE tool type 4.3 Emulation Options
Multinational mode 7 National Modes

N
Napsa, font 6 How NapsaTerm Uses Fonts
NapsaPrefs 4.6 Preference File
NapsaTermUK 4.6.1 Using Alternative Command Names
NapsaTermUS 4.6.1 Using Alternative Command Names
NATION tool type 4.3 Emulation Options
National character tables 7.2 National Character Tables
National keymaps 7.1 National Keymaps
National mode 7 National Modes
National modes 7 National Modes
NATIONAL tool type 4.3 Emulation Options
Nations, available 4.3 Emulation Options
Newman, Christopher J. 1.1 Niftyterm Licence
Niftyterm licence 1.1 Niftyterm Licence
Non-Interlace screen 6 How NapsaTerm Uses Fonts

O
Ollila, Tomi 1 About Authors
Option ---80 4.4 Display Options
Option ---application 4.3 Emulation Options
Option ---h19 4.3 Emulation Options
Option ---ic 4.3 Emulation Options
Option ---numeric 4.3 Emulation Options
Option ---shared 4.2 Device Options
Option ---slow 4.3 Emulation Options
Option ---stdio 4.2 Device Options
Option ---vt102 4.3 Emulation Options
Option ---vt52 4.3 Emulation Options
Option -7 4.3 Emulation Options
Option -B 4.2 Device Options
Option -d 4.2 Device Options
Option -f 4.4 Display Options
Option -g 4.4 Display Options
Option -l 4.1 General Options
Option -N 4.2 Device Options
Option -p 4.4 Display Options
Option -r 4.2 Device Options
Option -s 4.2 Device Options
Option -S 4.4 Display Options
Option -u 4.2 Device Options
Option -V 4.1 General Options
Option -v 4.3 Emulation Options
Option -w 4.1 General Options
Options 4 Options
Options, Device 4.2 Device Options
Options, Display 4.4 Display Options
Options, Emulation 4.3 Emulation Options
Options, General 4.1 General Options
Options, Overview of CLI 2 Invoking NapsaTerm from Shell

P
PASS8 tool type 4.3 Emulation Options
Password 8.1 Rlogin protocol
Pessi, Pekka 1 About Authors
Peuhkuri, Markus 1 About Authors
Preference file 4.6 Preference File
Preferences 4.6 Preference File
PUBSCREENNAME tool type 4.4 Display Options

R
Rajahalme, Jarno 1 About Authors
Remote user name 8.1 Rlogin protocol
REMOTENAME tool type 4.2 Device Options
REMOTETYPE tool type 4.2 Device Options
RFC 1282 8.1 Rlogin protocol
Rlogin client 8.1 Rlogin protocol
Rlogin protocol 8.1 Rlogin protocol
Rlogin server 8.1 Rlogin protocol

S
Serial devices 8.3 Serial devices
serial.device 8.3 Serial devices
SERVICE tool type 4.2 Device Options
Setup menu 5.3 Setup Menu
Shared mode 8.3 Serial devices
SHARED tool type 4.2 Device Options
SIZEGADGET tool type 4.4 Display Options
Soft Reset menu item 5.1 Command Menu
Standard input/output 8.5 DOS IO
Starting from CLI 2 Invoking NapsaTerm from Shell
Starting from Workbench 3 Invoking NapsaTerm from Workbench
stdio 8.5 DOS IO
stty 8.1 Rlogin protocol

T
Telnet 8.1 Rlogin protocol
Telnet Protocol 8.2 Serial devices
Terminal type 8.1 Rlogin protocol
TITLE tool type 4.4 Display Options
To Tek4010 menu item 5.1 Command Menu
To VT102 menu item 5.1 Command Menu
Tool type ALTISMETA 4.3 Emulation Options
Tool type BACKSPACE2DELETE 4.3 Emulation Options
Tool type BASEFONT 4.4 Display Options
Tool type BELL 4.3 Emulation Options
Tool type CTRL8BIT 4.3 Emulation Options
Tool type CURSOR 4.3 Emulation Options
Tool type CURSORBLINK 4.3 Emulation Options
Tool type DELETE2BACKSPACE 4.3 Emulation Options
Tool type DEVICE 4.2 Device Options
Tool type EMULATION 4.3 Emulation Options
Tool type FIXEDCOLUMNS 4.4 Display Options
Tool type GEOMETRY 4.4 Display Options
Tool type HOST 4.5 Host Names
Tool type INVERSE 4.3 Emulation Options
Tool type KEYBOARD 4.3 Emulation Options
Tool type KEYMAP 4.3 Emulation Options
Tool type KEYPAD 4.3 Emulation Options
Tool type LINESPEED 4.2 Device Options
Tool type LOGFILE 4.1 General Options
Tool type MOUSE 4.3 Emulation Options
Tool type NATION 4.3 Emulation Options
Tool type NATIONAL 4.3 Emulation Options
Tool type PASS8 4.3 Emulation Options
Tool type PUBSCREENNAME 4.4 Display Options
Tool type REMOTENAME 4.2 Device Options
Tool type REMOTETYPE 4.2 Device Options
Tool type SERVICE 4.2 Device Options
Tool type SHARED 4.2 Device Options
Tool type SIZEGADGET 4.4 Display Options
Tool type TITLE 4.4 Display Options
Tool type UNIT 4.2 Device Options
Tool type WAITTOEND 4.1 General Options
Tool types 3 Invoking NapsaTerm from Workbench
Tool types 4 Options

U
UNIT tool type 4.2 Device Options
Usage 2 Invoking NapsaTerm from Shell
USER environment variable 8.1 Rlogin protocol

V
VT100 animations 4.2 Device Options
VT100 animations 4.3 Emulation Options
VT100 animations 8.5 DOS IO

W
WAITTOEND tool type 4.1 General Options
Warranty 1.1 Niftyterm Licence
Williamson, Todd 1.1 Niftyterm Licence

Jump to:   -   .   ~  
A   B   C   D   E   F   G   H   I   K   L   M   N   O   P   R   S   T   U   V   W  

[Top] [Contents] [Index] [ ? ]

Table of Contents


[Top] [Contents] [Index] [ ? ]

About This Document

This document was generated on August 30, 2024 using texi2html 5.0.

The buttons in the navigation panels have the following meaning:

Button Name Go to From 1.2.3 go to
[ << ] FastBack Beginning of this chapter or previous chapter 1
[ < ] Back Previous section in reading order 1.2.2
[ Up ] Up Up section 1.2
[ > ] Forward Next section in reading order 1.2.4
[ >> ] FastForward Next chapter 2
[Top] Top Cover (top) of document  
[Contents] Contents Table of contents  
[Index] Index Index  
[ ? ] About About (help)  

where the Example assumes that the current position is at Subsubsection One-Two-Three of a document of the following structure:


This document was generated on August 30, 2024 using texi2html 5.0.