syacdb(1M) DG/UX R4.11MU05 syacdb(1M)
NAME
syacdb - Debugger for Systech VMEbus/PCI bus asynchronous controllers
SYNOPSIS
syacdb [-d] filename
where:
filename If [-d] option is used, the filename corresponds to the
memory dump of a Systech asynchronous controller (e.g.
hpscore). Otherwise, filename corresponds to the full
device node pathname of a Systech asynchronous controller.
DESCRIPTION
The syacdb command provides access to a set of utilities that can be
used to obtain information about the hardware, software, and
configuration of Systech asynchronous controllers.
EXAMPLES
syacdb '/dev/async/ctrl/syac(vme(0),0)'
This example starts the debugger utility program for the specified
Systech VMEbus asynchronous controller.
syacdb '/dev/async/ctrl/spac(pci(0),F,0)'
This example starts the debugger utility program for the specified
Systech PCI bus asynchronous controller.
Commands
!
The ! command can be used to issue commands to the parent shell.
?
The ? command is the same as the help command. This command will
print out a list of valid commands.
cch [channel-id]
The cch command is used to look at the cluster channel data
structure. Two pages of output provide information on the receive
structure, the transmit structure, and general channel statistics.
If a channel id is specified, then the system attempts to gain
information about that channel. Otherwise, the program uses the
current channel id.
cdump [ channel_id ] [ starting_addr ]
The cdump command is used to dump memory from a cluster controller.
The channel id and starting addresses are mandatory parameters the
first time the command is used. Once the user has specified a
channel id, the program will continue to use the same channel until
a new channel is specified. The command will dump out channel
memory in 128 byte blocks. If the address is not given then the
program will use the current memory location +1 as the starting
address. Sample output is shown below.
100080: 00 10 03 c0 00 20 04 04 00 10 04 0a 00 00 0f da ................
100090: 00 00 0f da 00 00 15 b0 00 10 43 90 00 10 66 98 ..........C...f.
1000a0: 00 00 0f da 00 00 0f da 00 00 0f da 00 00 0f da ................
1000b0: 00 00 0f da 00 00 0f da 00 00 0f da 00 00 0f da ................
1000c0: 00 00 0f da 00 00 0f da 00 00 0f da 00 00 0f da ................
1000d0: 00 00 0f da 00 00 0f da 00 00 0f da 00 00 0f da ................
1000e0: 00 00 0f da 00 00 0f da 00 00 0f da 00 00 0f da ................
clog [ cluster_id ] [ device ]
The clog command is used to get general logging information about
the cluster controller. Once the user has specified a cluster id,
the command will use the id given in its last invocation.
Therefore, the cluster id is a mandatory parameter the first time
the command is invoked. If the device name is not provided, the
command uses the device specified when it was last invoked. Sample
output is shown below.
Model HPS-7082-030
Firmware 90-070371-7-01A
Running 90-070434-7-01C+SEQ
Device type 69
Station ID 01
Real-time clock ticks 120049
Idle task counter 120049
Out of memory errors 0
Miscellaneous errors 0
Network packets send 2208
Network packets received 2224
No response errors 0
Bad response errors 0
Offline errors 0
Network reconfigurations 1
ROM size 65536
ROM checksum 0x0714
End of RAM 1179648
Failed ports none
dloop [cdlnrstq] [device] [limit] [bcount] [bsize] [time]
The dloop command performs DMA loopback testing between the host
computer and the Systech host adapter. A block of data is sent to
the board, read back into the host and verified.
options
One or more of the options must be selected.
c This option will disable the verification part of the test.
The blocks will be transmitted and received but no check will be
made to ensure whether the data is the same.
d This option allows the user to override the default device,
which is the device that was specified on the syacdb command
line. If this option is used, the user must specify a device
name on the command line.
l This option allows the user to set a limit on the number of
characters sent per second by the test. If this option is used
the user must specify a limit on the command line.
n This option allows the user to set a maximum block count. If
this option is used, the user must specify a block count on the
command line. The default is to send an unlimited number of
blocks with the test bounded by time.
r This option enables sending random size blocks from 1 to 512
bytes in length. The default is to send fixed size blocks.
s This option specifies the size of fixed blocks to be used by
the test. The maximum block size allowed is 512 bytes. If this
option is used, then the user must specify a block size on the
command line.
t This option sets the running time for the test. The default
time is 30 seconds. If this option is used, then the user must
specify the time in seconds on the command line.
q This option tells the program not to send results to standard
output unless there is an error.
If two or more conflicting options are specified, then the first
option on the command line takes effect. Sample output is shown
below.
Run the loopback test on the Systech asynchronous controller
that was specified on the syacdb command line for 60 seconds
using random size blocks.
dloop rt 60
Run the loopback test on a Systech PCI bus asynchronous
controller, sending 200 blocks that are 256 bytes long.
dloop dns /dev/async/ctrl/spac(pci(0),F,0) 200 256
dump [ starting_addr ] [ dump_size ]
The dump command allows the user to display portions of the Systech
asynchronous controller memory. If no starting address is
specified and memory has not been previously dumped, then the dump
will be viewed at the beginning of controller memory. Otherwise,
the dump will be viewed at the last location dumped. The default
dump size is 128 bytes. The maximum size of memory to be dumped at
one time is 512 bytes. The format of the dump is the same as for
the cdump command.
exit
The exit command terminates the program.
help
The help command prints a list of valid commands for the syacdb
program.
log
The log command is used to get general logging information about
the host adapter. Sample output is shown below.
Model HPS-6945
Firmware 90-070154-6-05B Board assy XX-XXXXXX-X-XXX
Device type 4
Station ID ff Option switches 0xfc
Real-time clock ticks 370819 Idle task counter 411888196
Bytes DMAed to HPS 128822 Bytes DMAed from HPS 1097777
DMA XACK timeouts 0 IOCB processed 2872
DMA bus req. timeouts 0 Response queue full 0
No memory errors 0 Response queue full 0
Network queue full 0 Miscellaneous errors 0
Packets sent 6502 Packets received 6410
No response errors 0 Bad response errors 0
Offline errors 0 Reconfigurations 8
reserved 0 ROM size 32768
ROM checksum 0x6d87 End of RAM 0x180000
Real time clock (HZ) 20 reserved 0
Set ram start to 0x100000 and ram_end to 0x17ffff
netc
The netc command prints out the configuration of Systech
asynchronous controllers and cluster controllers that exist on the
network (if applicable). The debugger will show the device type,
network address, and state of lines if appropriate. Sample output
is shown below.
NET ADDR STATE DEV TYPE FW RE HOST ID
________ _________ ________ _____ _______
1 Normal Online HPS 7082-030 01A n/a
ff Normal Online HPS 6945 05B 0
partitions
The partitions command prints a table showing the division of on-
board memory into different sized blocks. The debugger will show
the number of pieces, their size, and their current location in
memory. Sample output is shown below.
# Curr
Part Size Name Max Entries Start End
____ ____ ____ ___ _______ __________ __________
1 512 MEM_512 506 328 0x00140b94 0x0017ff94
3 32 MEM_32 183 172 0x0012f834 0x00130f14
4 16 MEM_16 60 10 0x0012f474 0x0012f834
2 32 MEM_32 183 172 0x0012f834 0x00130f14
16 16 0x001005ec 0x001009ec
queues
The queues command provides information about the state of the on-
board queues. Information such as number of entries and number of
tasks waiting are provided. Sample output is shown below.
# Cur # Tasks
Queue Entries Waiting Name Max Entries
_____ _______ _______ ____ ___________
244 0 1 DIAG NET Q 16
243 0 1 DIAG IOCB Q 16
54 175 - MEM 512 Q 175
41 0 1 ASYNC IOCB Q 26
rloop a[cdlnrstq] addr [device][limit][bcount][bsize][time]
The rloop command performs DMA loopback testing between the host
computer and the remote cluster controller. A block of data is
sent to the controller, read back into the host, and verified.
options
One or more of the options must be selected.
a This option is used to tell the program which cluster
controller to run the loopback test through.
c This option will disable the verification part of the test.
The blocks will be transmitted and received but no check will be
made that the data is the same.
d This option allows the user to override the default device,
which is the device that was specified on the syacdb command
line. If this option is used, the user must specify a device
name on the command line.
l This option allows the user to set a limit on the number of
characters sent per second by the test. If this option is used,
the user must specify a limit on the command line.
n This option allows the user to set a maximum block count. If
this option is used, the user must specify a block count on the
command line. The default is to send an unlimited number of
blocks with the test bounded by time.
r This option enables the sending of random size blocks from 1
to 512 bytes in length. The default is to send fixed size
blocks.
s This option specifies the size of fixed blocks to be used by
the test. The maximum block size allowed is 512 bytes. If this
option is used, then the user must specify a block size on the
command line.
t This option sets the running time for the test. The default
time is 30 seconds. If this option is used, then the user must
specify the time in seconds on the command line.
q This option tells the program not to send results to standard
output unless there is an error.
If two or more conflicting options are specified, then the first
option on the command line takes effect. Sample output is shown
below.
Run the remote loopback test on cluster controller 2 of the
Systech asynchronous controller that was specified on the
syacdb command line for 60 seconds using random size blocks.
rloop art 2 60
Run the remote test on cluster controller 1 of a Systech
VMEbus asynchronous controller, sending 200 blocks that are
256 bytes long.
rloop dans /dev/async/ctrl/syac(vme(0),1) 1 200 256
search [ pattern ] [ starting_addr ] [ ending_addr ]
The search command is used to search through host adapter memory to
locate a pattern. The default pattern is 00. The default starting
and ending addresses are the top and bottom of memory. The
starting address is set to the next location after a successful
search. If a search is not successful, the starting address is not
modified. A pattern may be between 1 and 4 bytes in length and
leading zeroes must be specified.
setcch [ addr ]
The setcch command is used to get or set the cluster channel
address.
setl [ length ]
The setl command is used to get or set the channel length field.
settcb
The settcb command is used to get or set the task control block
address.
show
The show command is used to print out internal variables used by
the program. Information like the starting search address and the
board type will be printed out. A number of the variables are
initialized to zero and not set until the appropriate command has
been called first to set the variable. For example, prior to the
first invocation of the queue command the queue_addr field is set
to 0x0. Sample output is shown below.
Global variables:
hps_intel = 0x0
board_type = 0x4
os_type = 0x0
ram_start = 0x100000
ram_end = 0x17ffff
tcb_addr = 0x127dae
tcb_len = 0x50
config_tasks = 0x11
ch_addr = 0x0
ch_len = 0x390
cch_addr = 0x0
queue_addr = 0x0
part_addr = 0x0
Other current variables:
remaddr = 0x0
station = 0x800
dumpaddr = 0x0;
dumplen = 0x0
search data = 0x0
search size = 0x0
search chart = 0x0
search start = 0x0
search end = 0x0
hpsstat [ dcpfioexsta ] [ device ] channel_number
The hpsstat command is used to retrieve channel parameters for an
open channel on the Systech host adapter.
options
One or more options must be selected:
d This option allows the user to override the default device,
which is the device that was specified on the syacdb command
line. If this option is used, the user must specify a device
name on the command line.
c This option causes the system configuration to be printed.
This option concerns the entire host adapter and not just an
open channel.
p This option causes the current baud rate, number of bits,
parity and stop bits to be printed.
f This option causes the display flow control parameters to be
printed.
i This option must be used with the t option. This will cause
the input parameters to be printed.
o This option must be used with the t option. This will cause
the output parameters to be printed.
e This option will cause echo parameters to be printed.
x This option is to display extra parameters which have not been
implemented in the current release of the Systech firmware.
s This option will cause the channel status to be printed.
t This option must be used with either the i or o option. This
will cause the appropriate translation table to be printed.
a This allows all options to be set.
Sample output is shown below for the hpsstat p option.
ASYNCH PROTOCOL
Baud Char Len Parity Stop bits
Receive: 300 8 none 1 stop bit
Transmit: 300 8 none 1 stop bit
tasks [ task-id ]
The tasks command is used to get information about an individual
task or about all of the tasks on the host adapter. If the task id
is specified, the information includes the contents of the
registers. Sample output is shown below.
Task TCB Pri State
____ ___ ___ _____
4 (loader task) (00127e4e) 11 RDY
12 (netman ) (00127e9e) 14 SUS QUE: 10. (NETW Q)
5 (hst_Rsp_task) (00127eee) 100 SUS QUE: 5. (RESP Q)
255 (idle task ) (001282ae) 255 RDY
usage
The usage command is used to measure the load on the host adapter.
The program will report the percentage of time the board is idle.
ver
The ver command is used to get the version of the terminal control
software (TCS) that is running on the host adapter. A menu allows
the user to get the version information, change the host adapter in
order to obtain version information on that adapter, or quit the
command. The user makes a choice by entering the menu number and
pressing the return key. Sample output is shown below.
==TCS VERSION INFORMATION==
Title: HPS-TCS-VME
Version: 04H
Part Number: 90-070054-5
Creation Date: Mon Oct 8 09:22:44 PDT 1990
Description: HPS-6945 TCS and Diag Apps, Net Man
Which version information do you want to display?
0 - Quit
1 - TCS
2 - Change host adapter (currently /dev/async/ctrl/syac(vme(0),0))
Your choice (enter a number)
FILES
/usr/sbin/syacdb Executable file for utility
/usr/lib/tcload/models/syac/dloop Executable file for the dloop
command
/usr/lib/tcload/models/syac/rloop Executable file for the rloop
command
/usr/lib/tcload/models/syac/hpsver Executable file for the ver
command
/usr/lib/tcload/models/syac/hpsstat Executable file for the hpsstat
command
SEE ALSO
syac(7), syacdump(1M).
NOTES
Several of the syacdb commands are not supported on VTCs/PTCs.
Unsupported commands will return the message "Cannot do <command> on
NTX host adaptor."
Certain commands such as clog cannot be run until the netc command
has been run.
The netc command has no meaning on a VAC16 and will cause the program
to exit.
Licensed material--property of copyright holder(s)