xbload(1M) xbload(1M)
NAME
xbload, load - load a workstation program onto a BA80 or TC20-V105
workstation
SYNOPSIS
xbload [-adl] [-u] [-p file] [-f file] terminalpath [ttydefslabel]
xbload -?
DESCRIPTION
xbload checks the load state of the specified terminal. The terminal
is set up if it has not been already set up, or if the -l option is
used. If the TC20-V105 can be loaded, the variant and version of the
firmware are checked, and reloaded as required. There are different
variants of the TC20-V105 firmware (with varying functionality). There
are also different versions (development status) of each variant.
xbload first sets the line parameters for the terminal being set up.
The basic and default setting for the physical line parameters is
9600, cs8, cread. The argument ttydefslabel can be used to change
this setting by placing a tag in /etc/ttydefs.
The following specifications are recognized and supported:
- Baud rate
- Character length (CS8, CS7 etc.)
- Parity
- Stop bits.
A request is then made to the terminal to identify itself. If neces-
sary, this request is repeated 5 times. If the program does not need
to be loaded, it is terminated with the return value 0. Otherwise, the
workstation program is loaded. The load state of the terminal is then
checked again, and the loading procedure is repeated up to 5 times, if
required.
OPTIONS
-a The software is transferred in ASCII format (INTELHEX).
Note: In this case, DATA FORMAT INTEL must be entered in the
BA80 load menu. Otherwise, the data is transferred in
binary format, which requires the setting DATA FORMAT
HEX. This is of no significance for TC20-V105.
-d This option activates debug mode for outputting trace infor-
mation (usually to stderr). -d sets the debug level to 1, -dd
to 2 and so on.
Page 1 Reliant UNIX 5.44 Printed 11/98
xbload(1M) xbload(1M)
-l Unconditional setup. Before the terminal is identified/set
up, it is requested by means of an ESC sequence to go to the
load Prom. This option can also be used to set up terminals
that have already been set up.
-p file A terminal that has not been set up (or if the -l option was
used) is set up with the specified software. The firmware for
a TC20-V105 is compared with the firmware under this file
name, and if necessary the TC20-V105 is reloaded (see -u
option).
If the option is not specified:
Where a BA80 has not been set up, then when there is a load
request, a file name is taken from /opt/xb so that it can be
set up. In the case of a TC20, the file name under which a
firmware is expected on the host side, is determined from the
variant VAR of the terminal: /etc/tc20/VAR.default.
-f file All output (error messages, debug output) is normally sent to
stderr. With this option, the output is rerouted to the
specified file.
-u Weak update: In the case of a TC20-V105 that has been set up,
a comparison is made of the version of firmware loaded and
the firmware on the host side. (The firmware on the host is
specified either with -p file or is taken from
/etc/tc20/VAR.default, where VAR is the variant of the TC20-
V105 set up.) If this comparison establishes that with both
variants the firmware on the host is a more recent version
(higher version), the TC20-V105 is reloaded with the more
recent version (otherwise, it is not). If it is established
that both the loaded firmware and that on the host are dif-
ferent in the variant, an error message is output.
-uu Strong update (see -u option): The TC20-V105 is set up again
if the loaded firmware and that on the host differ in variant
or version. This option must be used if, in conjunction with
the -p file option, a TC20-V105 is to be reloaded with
another variant.
terminalpath
The device name of the terminal to be loaded in the file sys-
tem. A TTY interface is expected.
ttydefslabel
With this option, the /etc/ttydefs file is tagged in order to
define the TTY specification. The physical line parameters
are set in accordance with the specifications of this tag. If
this option is not specified, 9600, cs8, cread is used. If
the pseudo tag none is specified instead of a tag, the physi-
cal parameters remain unchanged.
Page 2 Reliant UNIX 5.44 Printed 11/98
xbload(1M) xbload(1M)
-? The command syntax is displayed on stderr.
NOTE
Two different xb workstation program formats are supported: In addi-
tion to the conventional workstation programs with the format ID 01,
which contain the entire load software in one file, there are also
programs with the format ID 02 (extended format). These contain the
names of the files, specified in the order in which they are to be
loaded, and have the following format:
02;filename1[;filename2] ... # Comment
HDLC-BA80 can only be loaded in binary format, i.e. without the -a
option.
DIAGNOSTICS
The program ends with the return value 0, if the terminal was already
set up or has been set up successfully. If any errors occur, the
return values have the following meaning:
1 = Syntax error. A command syntax is displayed.
2 = Signal (SIGTERM, SIGHUP, SIGINT) received.
3 = Error in input/output operations such as open, read, write,
ioctl and fcntl.
4 = Program aborted after several of unsuccessful load attempts.
5 = Unknown or no response from the TTY during identification. This
may be the result of inconsistencies in the line parameters, or
the fact that the terminal is not a BA80/9766 or TC20.
6 = The desired workstation program was not found. This error code
also appears if the workstation program has an unknown format ID
or (in the case of extended format) a specified file from this
program could not be opened.
10 = A TC20 has loaded old or unsuitable firmware, but the options
(-u/-uu) do not permit a reload. The TC20-V105 could not be put
in load mode and loading was terminated by the TC20.
Error messages and trace information (provided the -d option is set)
are output to stderr; they can be rerouted using the -f option. Suc-
cessful loading and errors which occur when loading TC20-V105 are
logged in /var/tc20/loadlog and also in Logging 3.0 under the com-
ponent number 1080011.
Page 3 Reliant UNIX 5.44 Printed 11/98
xbload(1M) xbload(1M)
FILES
/etc/ttydefs
/opt/xb
/etc/tc20
/var/tc20/loadlog
Page 4 Reliant UNIX 5.44 Printed 11/98