1997-10-15 06:43:54 +00:00
|
|
|
.\" $Id: sicontrol.8,v 1.6 1997/02/22 16:13:30 peter Exp $
|
1995-09-26 18:18:49 +00:00
|
|
|
.\" The following requests are required for all man pages.
|
|
|
|
|
.Dd September 26,1995
|
1995-08-14 01:56:17 +00:00
|
|
|
.Dt SICONTROL 8
|
1995-09-26 18:18:49 +00:00
|
|
|
.Os FreeBSD
|
1995-08-14 01:56:17 +00:00
|
|
|
.Sh NAME
|
|
|
|
|
.Nm sicontrol
|
1995-09-26 18:18:49 +00:00
|
|
|
.Nd Specialix SI/XIO driver configuration and debugging
|
1995-08-14 01:56:17 +00:00
|
|
|
.Sh SYNOPSIS
|
|
|
|
|
.Nm sicontrol
|
1995-09-26 18:18:49 +00:00
|
|
|
device
|
|
|
|
|
.Ar command Op Cm Ar param ...
|
1995-08-14 01:56:17 +00:00
|
|
|
.Sh DESCRIPTION
|
1997-10-15 06:43:54 +00:00
|
|
|
.Nm Sicontrol
|
1995-09-26 18:18:49 +00:00
|
|
|
is used to configure and monitor the SI/XIO device driver.
|
|
|
|
|
.Pp
|
1997-10-15 06:43:54 +00:00
|
|
|
.Nm Sicontrol
|
1995-09-26 18:18:49 +00:00
|
|
|
operates on the specified
|
|
|
|
|
.Ar device
|
|
|
|
|
to indicate which port is to be used.
|
|
|
|
|
.Pp
|
|
|
|
|
The special
|
|
|
|
|
.Ar device
|
|
|
|
|
string `-' is used to indicate the global driver settings instead.
|
|
|
|
|
.Pp
|
|
|
|
|
A '/dev/' is included if necessary.
|
|
|
|
|
.Pp
|
|
|
|
|
The following commands are used for the global settings and should be
|
|
|
|
|
specified with the '-' device name.
|
|
|
|
|
.Bl -tag -width 4n
|
|
|
|
|
.It Cm int_throttle Op Cm value
|
|
|
|
|
Configure the `aggregate interrupt throttle value'.
|
|
|
|
|
The maximum number of host adapter interrupts per second is determined by:
|
|
|
|
|
.Pp
|
|
|
|
|
.Ar "controller CPU clock / (8 * int_throttle)"
|
|
|
|
|
.Pp
|
|
|
|
|
The default value at boot time is 25000. The host adapter cpu clock is
|
|
|
|
|
25Mhz. This gives a maximum interrupt rate of about 125 interrupts per
|
|
|
|
|
second.
|
|
|
|
|
.Pp
|
|
|
|
|
Lowering this value will increase the rate in which the host adapter can
|
|
|
|
|
interrupt the operating system for attention.
|
|
|
|
|
.\"
|
|
|
|
|
.It Cm rxint_throttle Op Cm value
|
|
|
|
|
Configure the receiver interrupt throttle value.
|
|
|
|
|
The default value of 4 at boot time allows an interrupt rate of
|
|
|
|
|
approximately 25.
|
|
|
|
|
.Pp
|
|
|
|
|
Lowering this value will increase the rate in which the host adapter can
|
1996-01-30 13:52:50 +00:00
|
|
|
interrupt the operating system to empty the receiver fifos.
|
1995-09-26 18:18:49 +00:00
|
|
|
.\"
|
|
|
|
|
.It Cm nport
|
1997-10-15 06:43:54 +00:00
|
|
|
Return the number of ports under the control of the device driver.
|
1995-09-26 18:18:49 +00:00
|
|
|
.El
|
|
|
|
|
.Pp
|
|
|
|
|
The following commands are used for the individual ports and should be
|
1997-10-15 06:43:54 +00:00
|
|
|
specified with a device name from
|
|
|
|
|
.Pa /dev :
|
1995-09-26 18:18:49 +00:00
|
|
|
.Bl -tag -width 4n
|
|
|
|
|
.It Cm mstate
|
1997-10-15 06:43:54 +00:00
|
|
|
Show the current incoming modem control signals.
|
1995-09-26 18:18:49 +00:00
|
|
|
.It Cm ccbstat
|
1997-10-15 06:43:54 +00:00
|
|
|
Show the current "ccb" structure for the specified port. This is not of
|
1995-09-26 18:18:49 +00:00
|
|
|
much use outside of debugging the driver and determining why a port is
|
|
|
|
|
wedged.
|
|
|
|
|
.It Cm ttystat
|
1997-10-15 06:43:54 +00:00
|
|
|
Show the current "tty" structure that the kernel has for the specified port.
|
1995-09-26 18:18:49 +00:00
|
|
|
This is not much use outside of debugging the driver.
|
|
|
|
|
.El
|
|
|
|
|
.\" The following requests should be uncommented and used where appropriate.
|
|
|
|
|
.\" This next request is for sections 2 and 3 function return values only.
|
|
|
|
|
.\" .Sh RETURN VALUES
|
|
|
|
|
.\" This next request is for sections 1, 6, 7 & 8 only
|
|
|
|
|
.\" .Sh ENVIRONMENT
|
1995-08-14 01:56:17 +00:00
|
|
|
.Sh FILES
|
|
|
|
|
.Bl -tag -width /dev/si_control -compact
|
|
|
|
|
.It Pa /dev/si_control
|
1995-09-26 18:18:49 +00:00
|
|
|
global driver control file for use by
|
|
|
|
|
.Xr sicontrol 8 .
|
1995-08-14 01:56:17 +00:00
|
|
|
.It Pa /dev/ttyA*
|
1995-09-26 18:18:49 +00:00
|
|
|
terminal control ports
|
1995-08-14 01:56:17 +00:00
|
|
|
.It Pa /dev/ttyiA*
|
1995-09-26 18:18:49 +00:00
|
|
|
initial termios state devices, for use by
|
|
|
|
|
.Xr stty 1
|
1995-08-14 01:56:17 +00:00
|
|
|
.It Pa /dev/ttylA*
|
1995-09-26 18:18:49 +00:00
|
|
|
locked termios state devices, for use by
|
|
|
|
|
.Xr stty 1
|
|
|
|
|
.El
|
|
|
|
|
.\" .Sh EXAMPLES
|
|
|
|
|
.\" This next request is for sections 1, 6, 7 & 8 only
|
|
|
|
|
.\" (command return values (to shell) and fprintf/stderr type diagnostics)
|
|
|
|
|
.Sh DIAGNOSTICS
|
|
|
|
|
Generally self explanatory.....
|
|
|
|
|
.\" The next request is for sections 2 and 3 error and signal handling only.
|
|
|
|
|
.\" .Sh ERRORS
|
1995-08-14 01:56:17 +00:00
|
|
|
.Sh SEE ALSO
|
|
|
|
|
.Xr stty 1 ,
|
1997-01-20 00:03:00 +00:00
|
|
|
.Xr si 4 ,
|
1995-09-26 18:18:49 +00:00
|
|
|
.Xr termios 4 ,
|
|
|
|
|
.Xr tty 4 ,
|
|
|
|
|
.Xr comcontrol 8 .
|
|
|
|
|
.\" .Sh STANDARDS
|
|
|
|
|
.Sh HISTORY
|
1997-10-15 06:43:54 +00:00
|
|
|
.Nm Sicontrol
|
1995-09-26 18:18:49 +00:00
|
|
|
is loosely based on a utility called
|
|
|
|
|
.Nm siconfig
|
|
|
|
|
which was written by
|
1997-10-15 06:43:54 +00:00
|
|
|
.An Andy Rutter Aq andy@acronym.co.uk
|
1995-09-26 18:18:49 +00:00
|
|
|
.Pp
|
|
|
|
|
Specialix International do not support this device driver in any way.
|
|
|
|
|
.Sh AUTHORS
|
1997-10-15 06:43:54 +00:00
|
|
|
.An Peter Wemm Aq peter@freebsd.org
|
1995-08-14 01:56:17 +00:00
|
|
|
.Sh BUGS
|
1995-09-26 18:18:49 +00:00
|
|
|
Bound to be many... :-)
|
