SSMKN(8) BSD System Manager's Manual SSMKN(8)NAMEssmkn - Equinox SuperSerial Technology device configuration utility
SYNOPSIS
/usr/sbin/ssmkn
DESCRIPTION
In a system with more than one adapter card installed, a logical adapter
card number must be mapped to each physical adapter card. These logical
adapter card numbers are assigned sequentially in ascending order start-
ing with the lowest slot (for PCI, EISA, or Micro Channel systems) number
followed by I/O address sequence (for ISA) adapter cards. A problem ex-
ists in a two adapter card system if the first logical adapter card is
removed, the ports that were 2a0, 2a1, 2a2 etc. would become 1a0, 1a1,
1a2 etc. This presents a potential security problem as well as a configu-
ration issue because any modems or printers defined on adapter card two
would no longer function. More adapter cards magnify the problem. To
overcome this problem, Equinox installs a program (/usr/sbin/ssmkn) that
maintains a database mapping of logical adapter card numbers to physical
adapter cards.
The following section lists the rules that are used to maintain this map.
Messages are generated when an adapter card is added to, relocated within
or removed from the system.
Every time the system is booted, the program ssmkn checks to see if any
adapter cards were added to, relocated within or removed from the system.
The program decides if map changes are required. The rules for mapping
logical adapter card numbers to physical adapter cards are applied in the
order numbered below. If two or more rules apply, the lowest numbered
rule takes effect.
1. Adapter card type, bus type and location match.
If the adapter card type, bus type and location (slot or I/O
address) match, it is assumed that the same adapter card is
present that was previously installed. No changes are made to the
stored (logical adapter card number to physical adapter card)
map. This occurs normally each time the system is booted if no
SST adapter cards were added, removed or moved to a different
slot.
2. Adapter card type and bus type match. Location does not match.
If the adapter card type and bus type match but the location
(EISA slot or ISA I/O address) of the adapter card changes, the
adapter card maintains the same logical number previously
assigned (e.g., an EISA adapter card is relocated into a
different slot)
3. Location matches, adapter card type and/or bus type do no match.
Any adapter card now appearing in a previously occupied PCI,
EISA,
or Micro Channel slot (or ISA I/O address) is considered a
replacement. This adapter card is given the logical adapter card
number of the previous adapter card. For example, this would
occur if you replaced a SST-4 adapter card with a SST-8
adapter card.
4. Nothing matches.
a. When the same number of adapter cards expected to be found
(logically) are found (physically), but the bus type or
"location" is different, each adapter card is considered to be
a replacement. The adapter cards are mapped in "location" order.
This would occur if you replaced two SST ISA adapter cards with
two SST EISA adapter cards.
b. If the physical number of adapter cards found is less than the
number of adapter cards expected, and the bus type or "location"
is different, the adapter cards are mapped as in 4.a. above.
The program reports any remaining adapter cards as missing. For
example, this could happen if you replaced three ISA adapter
cards with two EISA adapter cards.
c. If the physical number of adapter cards found is greater than the
number of adapter cards expected, and the bus type or "location"
is different, the adapter cards are mapped as in 4.a. above.
The program reports any additional adapter cards as new.
This may occur if you replaced two ISA adapter cards with three
EISA adapter cards.
CONFIG
Port names are of the general form /dev/tty<adapter card><module><port>
<adapter card> - is a single number between 1 and 8.
The adapter card numbers are assigned in slot order
for PCI and EISA systems. They are assigned in I/O ad-
dress
sequence for ISA systems.
<module> - is a lowercase letter from a through h, representing the
first module (PM-8, PM-16 or MIM-1) through the eighth
module of a SST subsystem.
<port> - is a hexadecimal number from 0 to f. The <port> number is the
actual port number on a SST-64 or SST-128 port module, or SST-4
or SST-8 fan-out cable.
CONFIGURATION
The following example is added to the file /etc/rc.local
/usr/sbin/ssmkn
FILES
/dev/eqnx
/etc/rc.local
/var/db/equinox/logfile configuration file
/var/db/equinox/database configuration database
SEE ALSOeqnx(4), sstty(8), tty(4)AUTHORS
Equinox Systems, Inc.
BUGS
NONE
BSDI BSD/OS June 3, 2001 2