SunOS Reference Manual Sun Microsystems, Inc. 2550 Garcia Avenue Mountain View, CA 94043 U.S.A.
1994 Sun Microsystems, Inc. 2550 Garcia Avenue, Mountain View, California 94043-1100 U.S.A. All rights reserved. This product or document is protected by copyright and distributed under licenses restricting its use, copying, distribution, and decompilation. No part of this product or document may be reproduced in any form by any means without prior written authorization of Sun and its licensors, if any.
Preface OVERVIEW A man page is provided for both the naive user, and sophisticated user who is familiar with the SunOS operating system and is in need of on-line information. A man page is intended to answer concisely the question “What does it do?” The man pages in general comprise a reference manual. They are not intended to be a tutorial.
Section 4 outlines the formats of various files. The C structure declarations for the file formats are given where applicable. · Section 5 contains miscellaneous documentation such as character set tables, etc. · · Section 6 contains available games and demos. Section 7 describes various special files that refer to specific hardware peripherals, and device drivers. STREAMS software drivers, modules and the STREAMS-generic set of system calls are also described.
arguments are alphabetized, with single letter arguments first, and options with arguments next, unless a different argument order is required. The following special characters are used in this section: [] The option or argument enclosed in these brackets is optional. If the brackets are omitted, the argument must be specified. ... Ellipses. Several values may be provided for the previous argument, or the previous argument can be specified multiple times, for example, ‘filename . . .’. | Separator.
DESCRIPTION This section defines the functionality and behavior of the service. Thus it describes concisely what the command does. It does not discuss OPTIONS or cite EXAMPLES. Interactive commands, subcommands, requests, macros, functions and such, are described under USAGE. IOCTL This section appears on pages in Section 7 only. Only the device class which supplies appropriate parameters to the ioctl(2) system call is called ioctl and generates its own heading.
ERRORS On failure, most functions place an error code in the global variable errno indicating why they failed. This section lists alphabetically all error codes a function can generate and describes the conditions that cause each error. When more than one condition can cause the same error, each condition is described in a separate paragraph under the error code. USAGE This section is provided as a guidance on use. This section lists special rules, features and commands that require in-depth explanations.
EXIT STATUS This section lists the values the command returns to the calling program or shell and the conditions that cause these values to be returned. Usually, zero is returned for successful completion and values greater than zero for various error conditions. FILES This section lists all filenames referred to by the man page, files of interest, and files created or required by commands. Each is followed by a descriptive summary or explanation.
SunOS 5.5 Device and Network Interfaces NAME DESCRIPTION Intro ( 7 ) Intro, intro − introduction to special files This section describes various device and network interfaces available on the system. The types of interfaces described include character and block devices, STREAMS modules, network protocols, file systems, and ioctl requests for driver subsystems and classes.
Intro ( 7 ) Device and Network Interfaces SunOS 5.5 discussed in mtio(7I). Ioctl requests relevant to only a specific device are described on the man page for that device. The page for the device in question should still be examined for exceptions to the ioctls listed in section 7I. (7M) This section describes STREAMS modules. Note that STREAMS drivers are discussed in section 7D. streamio(7I) contains a list of ioctl requests used to manipulate STREAMS modules and interface with the STREAMS framework.
SunOS 5.
Intro ( 7 ) 7-8 Device and Network Interfaces SunOS 5.
SunOS 5.
Intro ( 7 ) Device and Network Interfaces SunOS 5.
SunOS 5.
Intro ( 7 ) 7-12 Device and Network Interfaces SunOS 5.
SunOS 5.5 Devices NAME SYNOPSIS adp ( 7D ) adp − low-level module for Adaptec 7870/7871/7872 based SCSI controllers adp@reg AVAILABILITY x86 DESCRIPTION The adp module provides low-level interface routines between the common disk/tape I/O system and SCSI (Small Computer System Interface) controllers based on the Adaptec AIC-7870, AIC-7871, and AIC7872 SCSI chip.
aha ( 7D ) Devices NAME SunOS 5.5 aha − low-level module for Adaptec 154x ISA host bus adapters AVAILABILITY x86 DESCRIPTION The aha module provides low-level interface routines between the common disk/tape I/O subsystem and the Adaptec ISA bus master 154x SCSI (Small Computer System Interface) controllers. The aha module can be configured for disk and streaming tape support for one or more host adapter boards, each of which must be the sole initiator on a SCSI bus.
SunOS 5.5 Devices aha ( 7D ) # # another controller example # name="aha" class="sysbus" reg=0x234,0,0 ioaddr=0x234 dmachan=6 dmaspeed=0 buson=5 busoff=9; After installation, 154x controllers may be jumpered for any of the I/O address, IRQ, and DMA channel combinations supported by the hardware, provided that this is reflected in the configuration file and that the parameters do not conflict with other devices on the system.
aic ( 7D ) Devices NAME SYNOPSIS SunOS 5.5 aic − low-level module for Adaptec AIC-6360 based ISA host bus adapters aic@ioaddr,0 AVAILABILITY x86 DESCRIPTION The aic module provides low-level interface routines between the common disk/tape I/O subsystem and AIC-6360 based SCSI (Small Computer System Interface) bus controllers. It also provides support for the Adaptec AHA-1510A, AHA-1520A, and AHA-1522A SCSI controllers.
SunOS 5.5 Protocols NAME SYNOPSIS arp ( 7P ) arp, ARP − Address Resolution Protocol #include #include #include #include s = socket(AF_INET, SOCK_DGRAM, 0); d = open ("/dev/arp", oflag); DESCRIPTION ARP is a protocol used to map dynamically between Internet Protocol (IP) and 10Mb/s Ethernet addresses.
arp ( 7P ) Protocols SunOS 5.
SunOS 5.5 Protocols arp ( 7P ) IP: Proxy ARP problem? Hardware address ’%x:%x:%x:%x:%x:%x’ thinks it is ’%d.%d.%d.%d’ This message will appear if arp(1M) has been used to create a published entry and some other host on the local network responds to mapping requests for the published arp entry.
asy ( 7D ) Devices NAME SYNOPSIS SunOS 5.5 asy − asynchronous serial port driver #include #include open("/dev/ttynn", mode); open("/dev/ttydn", mode); open("/dev/cuan", mode); AVAILABILITY x86 DESCRIPTION The asy module is a loadable STREAMS driver that provides basic support for the standard UARTS that use Intel-8250, National Semiconductor-16450/16550 hardware, together with basic asynchronous communication support.
SunOS 5.5 Devices IOCTLS asy ( 7D ) The standard set of termio ioctl( ) calls are supported by asy. Breaks can be generated by the TCSBRK, TIOCSBRK, and TIOCCBRK ioctl( ) calls. The input and output line speeds may be set to any of the speeds supported by termio. The speeds cannot be set independently; when the output speed is set, the input speed is set to the same speed. ERRORS FILES SEE ALSO DIAGNOSTICS An open( ) will fail if: ENXIO The unit being opened does not exist.
ata ( 7D ) Devices NAME SYNOPSIS SunOS 5.5 ata − AT attachment disk driver ata@ioaddr,0 AVAILABILITY x86 DESCRIPTION The ata driver supports disk and CD-ROM interfaces conforming to the AT Attachment specification including IDE interfaces. It excludes the MFM, RLL, ST506, and ST412 interfaces. Support is provided for CD_ROM drives that conform to the Small Form Factor (SFF) ATA Packet Interface (ATAPI) specification: SFF-8020 revision 1.2.
SunOS 5.5 Devices ata ( 7D ) # # secondary controller # name="ata" class="sysbus" intr=5,15 reg=0x170,0,0 ioaddr1=0x170 ioaddr2=0x370 drive0_block_factor=0x1 drive1_block_factor=0x1 max_transfer=0x100 flow_control="dmult" queue="qsort" disk="dadk" ; FILES SEE ALSO modified 14 Mar 1995 /kernel/drv/ata /kernel/drv/ata.
audio ( 7I ) Ioctl Requests NAME OVERVIEW SunOS 5.5 audio − generic audio device interface The audio interface described below is an uncommitted interface and may be replaced in the future. An audio device is used to play and/or record a stream of audio data. Since a specific audio device may not support all of the functionality described below, refer to the device-specific manual pages for a complete description of each hardware device.
SunOS 5.5 Ioctl Requests audio ( 7I ) Precision Precision indicates the number of bits used to store each audio sample. For instance, µlaw and A-law data are stored with 8-bit precision. PCM data may be stored at various precisions, though 16-bit PCM is most common. Channels Multiple channels of audio may be interleaved at sample boundaries. A sample frame consists of a single sample from each active channel.
audio ( 7I ) Ioctl Requests SunOS 5.5 immediately, but may return fewer bytes than requested. Refer to the read(2) manual page for a complete description of this behavior. When the audio device is opened with read access, the device driver immediately starts buffering audio input data. Since this consumes system resources, processes that do not record audio data should open the device write-only (O_WRONLY).
SunOS 5.5 Ioctl Requests audio ( 7I ) structure and output is stopped until additional data is written. If an application attempts to write a number of bytes that is not a multiple of the current sample frame size, an error will be generated and the device will need to be closed before any future writes will succeed. Asynchronous I/O The I_SETSIG STREAMS ioctl enables asynchronous notification, through the SIGPOLL signal, of input and output ready conditions.
audio ( 7I ) Ioctl Requests uint_t uint_t uchar_t uchar_t uchar_t uchar_t samples; eof; pause; error; waiting; balance; SunOS 5.
SunOS 5.5 Ioctl Requests audio ( 7I ) audio output to the normal state. Most audio devices allow input data to be monitored by mixing audio input onto the output channel. The monitor_gain field controls the level of this feedback path. The play.port field controls the output path for the audio device. It can be set to either AUDIO_SPEAKER (built-in speaker), AUDIO_HEADPHONE (headphone jack), or AUDIO_LINE_OUT (line-out port). For some devices, it may be set to a combination of these ports. The play.
audio ( 7I ) Ioctl Requests SunOS 5.5 record.buffer_size field may be modified only on the /dev/audio device by processes that have it opened for reading. The play.buffer_size field is currently not supported. The audio data format is indicated by the sample_rate, channels, precision, and encoding fields. The values of these fields correspond to the descriptions in the AUDIO FORMATS section above. Refer to the audio device-specific manual pages for a list of supported data format combinations.
SunOS 5.5 Ioctl Requests audio ( 7I ) AUDIO_SETINFO The argument is a pointer to an audio_info structure. This command may be issued for either the /dev/audio or the /dev/audioctl device with some restrictions. This command configures the audio device according to the structure supplied and overwrites the structure with the new state of the device. Note: The play.samples, record.samples, play.error, record.error, and play.
audio ( 7I ) Ioctl Requests SunOS 5.5 An ioctl( ) will fail if: FILES EINVAL The parameter changes requested in the AUDIO_SETINFO ioctl are invalid or are not supported by the device. EBUSY The parameter changes requested in the AUDIO_SETINFO ioctl could not be made because another process has the device open and is using a different format. The physcial audio device names are system dependent and are rarely used by programmers. The programmer should use the generic device names listed below.
SunOS 5.5 Devices NAME AVAILABILITY audioamd ( 7D ) audioamd − telephone quality audio device SPARC SPARCstation 1 and 2, IPC, IPX, SLC, ELC, LC, and SPARCserver 6xx systems. Desktop SPARCsystems include a built-in speaker for audio output. The audio cable provides connectors for a microphone and external headset. The headset output level is adequate to power most headphones, but may be too low for some external speakers. Powered speakers or an external amplifier may be used.
audioamd ( 7D ) Devices SunOS 5.5 Audio Ports The record.avail_ports and play.avail_ports fields of the audio_info structure report the available input and output ports. The audioamd device supports one input port, selected by setting the record.port field to AUDIO_MICROPHONE. The play.port field may be set to either AUDIO_SPEAKER or AUDIO_HEADPHONE, to direct audio output to the built-in speaker or headphone jack, respectively.
SunOS 5.5 Devices NAME AVAILABILITY audiocs ( 7D ) audiocs − Crystal Semiconductor 4231 audio Interface The AUDIOCS Multimedia codec is available on SPARCstation 5 systems. This hardware may or may not be available on future systems from Sun Microsystems Computer Corporation. Audio Interfaces SPARCstation 5 systems have the Multimedia Codec integrated onto the CPU board of the machine.
audiocs ( 7D ) Devices 22050 Hz 32000 Hz 37800 Hz 44100 Hz 48000 Hz Audio Ports Sample Granularity Audio Status Change Notification ERRORS FILES SunOS 5.5 linear linear linear linear linear 16 16 16 16 16 1 or 2 1 or 2 1 or 2 1 or 2 1 or 2 The record.avail_ports and play.avail_ports fields of the audio_info structure report the available input and output ports. The audiocs device supports three input ports, selected by setting the record.
SunOS 5.5 Devices audiocs ( 7D ) NOTES: The AUDIO_INTERNAL_CD_IN is another new functionality addition. Because of this, audiotool will now have a new button appear in the record popup box that will allow the user of audiotool to switch to the internal CD on the SPARCstation 5 (if present).
bd ( 7M ) STREAMS Modules NAME SYNOPSIS DESCRIPTION SunOS 5.5 bd − SunButtons and SunDials STREAMS module open("/dev/bd", O_RDWR) The bd STREAMS module processes the byte streams generated by the SunButtons buttonbox and SunDials dialbox. The buttonbox generates a stream of bytes that encode the identity and state transition of the buttons. The dialbox generates a stream of bytes that encode the identity of the dials and the amount by which they are turned.
SunOS 5.5 STREAMS Modules FILES SEE ALSO bd ( 7M ) /usr/include/sys/bdio.h /usr/include/sys/stropts.h $OPENWINHOME/share/include/xview/win_event.h bdconfig(1M), ioctl(2), x_dialtest(6), x_buttontest(6), streamio(7I), termio(7I) SunDials Installation and Programmers Guide SunButtons Installation and Programmers Guide WARNINGS The SunDials dial box must be used with a serial port.
be ( 7D ) Devices NAME SYNOPSIS DESCRIPTION SunOS 5.5 be − BigMAC Fast Ethernet device driver #include #include #include #include The 10/100 Mbit/s Fast Ethernet driver is a multi-threaded, loadable, clonable, STREAMS hardware device driver supporting the connectionless Data Link Provider Interface, dlpi(7P), over 10/100 Mbit/s 802.30 controller in the SBus Fast Ethernet card.
SunOS 5.5 Devices · be ( 7D ) The broadcast address value is Ethernet/IEEE broadcast address (0xFFFFFFFF). When in the DL_ATTACHED state, the user must send a DL_BIND_REQ to associate a particular SAP (Service Access Point) with the Stream. The be driver interprets the sap field within the DL_BIND_REQ as an Ethernet “type”; therefore, valid values for the sap field are in the [0-0xFFFF] range. Only one Ethernet type can be bound to the Stream at any time.
be ( 7D ) Devices SunOS 5.5 are accepted by the driver in any state following DL_ATTACHED. The DL_PROMISCON_REQ and DL_PROMISCOFF_REQ primitives with the DL_PROMISC_PHYS flag set in the dl_level field enables/disables reception of all (“promiscuous mode”) frames on the media including frames generated by the local host. When used with the DL_PROMISC_SAP flag set this enables/disables reception of all sap (Fast Ethernet type) values.
SunOS 5.5 Devices NAME SYNOPSIS DESCRIPTION APPLICATION PROGRAMMING INTERFACE bpp ( 7D ) bpp − bi-directional parallel port driver SUNW,bpp@slot,offset:bppn The bpp driver provides a general-purpose bi-directional interface to parallel devices. It supports a variety of output (printer) and input (scanner) devices, using programmable timing relationships between the various handshake signals. The bpp driver is an exclusive-use device.
bpp ( 7D ) Devices IOCTLS SunOS 5.5 The following ioctl requests are supported: BPPIOC_SETPARMS Set transfer parameters. The argument is a pointer to a bpp_transfer_parms structure. See below for a description of the elements of this structure. If a parameter is out of range, EINVAL is returned. BPPIOC_GETPARMS Get current transfer parameters. The argument is a pointer to a bpp_transfer_parms structure. See below for a description of the elements of this structure.
SunOS 5.5 Transfer Parameters Structure Devices bpp ( 7D ) This structure is defined in .
bpp ( 7D ) Devices SunOS 5.5 /∗ valid only in read/write mode ∗/ /∗ valid only in read/write mode ∗/ BPP_VPRINT_HS, BPP_VPLOT_HS }; The read_setup_time field controls the time between dstrb falling edge to bsy rising edge if the read_handshake field is set to BPP_NO_HS or BPP_ACK_HS. It controls the time between dstrb falling edge to ack rising edge if the read_handshake field is set to BPP_ACK_HS or BPP_ACK_BUSY_HS.
SunOS 5.
bufmod ( 7M ) NAME SYNOPSIS DESCRIPTION Read-side Behavior STREAMS Modules SunOS 5.5 bufmod − STREAMS Buffer Module ioctl(fd, I_PUSH, "bufmod"); bufmod is a STREAMS module that buffers incoming messages, reducing the number of system calls and the associated overhead required to read and process them.
SunOS 5.5 STREAMS Modules bufmod ( 7M ) value reflects any padding necessary to insure correct data alignment for the host machine and includes the length of the header itself. sbh_drops reports the cumulative number of input messages that this instance of bufmod has dropped due to flow control or resource exhaustion. In the current implementation message dropping due to flow control can occur only if the SB_NO_DROPS flag is not set.
bufmod ( 7M ) STREAMS Modules SunOS 5.5 has the side-effect of forcing the chunk size to zero as well, so that the module will pass all incoming messages upward immediately upon arrival. Negative values are rejected with an EINVAL error. SBIOCGTIME Return the read timeout in the struct timeval pointed to by the argument. If the timeout has been cleared with the SBIOCCTIME ioctl, return with an ERANGE error. SBIOCCTIME Clear the read timeout, effectively setting its value to infinity.
SunOS 5.5 STREAMS Modules bufmod ( 7M ) When buffering is enabled by issuing an SBIOCSCHUNK ioctl to set the chunk size to a non zero value, bufmod sends a SETOPTS message to adjust the stream head high and low water marks to accommodate the chunked messages.
bwtwo ( 7D ) Devices NAME SYNOPSIS DESCRIPTION SunOS 5.5 bwtwo − black and white memory frame buffer /dev/fbs/bwtwo The bwtwo interface provides access to monochrome memory frame buffers. It supports the ioctls described in fbio(7I). Reading or writing to the frame buffer is not allowed — you must use the mmap(2) system call to map the board into your address space.
SunOS 5.5 Ioctl Requests NAME SYNOPSIS DESCRIPTION cdio ( 7I ) cdio − CD-ROM control operations #include The set of ioctl(2) commands described below are used to perform audio and CD-ROM specific operations. Basic to these cdio ioctl requests are the definitions in . Several CD-ROM specific commands can report addresses either in LBA (Logical Block Address) format or in MSF (Minute, Second, Frame) format.
cdio ( 7I ) Ioctl Requests SunOS 5.5 the start time for a track. An approximation of the finish time can be obtained by using the CDROMREADTOCENTRY ioctl request to retrieve the start time of the track following the current track. The leadout track is the next consecutive track after the last audio track. Hence, the start time of the leadout track may be used as the effective finish time of the last audio track. CDROMPLAYTRKIND This ioctl( ) command is similar to CDROMPLAYMSF.
SunOS 5.5 Ioctl Requests cdio ( 7I ) contiguous ascending order. /∗ ∗ definition of read toc header structure ∗/ struct cdrom_tochdr { unsigned char cdth_trk0; /∗ starting track∗/ unsigned char cdth_trk1; /∗ ending track∗/ }; CDROMREADTOCENTRY This ioctl( ) command returns the information of a specified track. The third argument of the function call is a pointer to the type struct cdrom_tocentry. The caller needs to supply the track number and the address format.
cdio ( 7I ) Ioctl Requests CDROMSUBCHNL SunOS 5.5 CDROM_LBA LBA format CDROM_MSF MSF format This ioctl( ) command reads the Q sub-channel data of the current block. The subchannel data includes track number, index number, absolute CD-ROM address, track relative CD-ROM address, control data and audio status. All information is returned through a pointer to struct cdrom_subchnl. The caller needs to supply the address format for the returned address.
SunOS 5.
cdio ( 7I ) Ioctl Requests SunOS 5.5 To allocate the memory related to CD-DA and/or subcode data, the following values are appropriate for each data block transferred: CDROMCDXA CD-DA data with no subcode 2352 bytes CD-DA data with sub Q code 2368 bytes CD-DA data with all subcode 2448 bytes All subcode only 96 bytes SPARC: This ioctl( ) command returns the CD-ROM XA (CD-ROM Extended Architecture) data according to CD-ROM XA format.
SunOS 5.5 Ioctl Requests cdio ( 7I ) subcode data. The memory allocated should be a multiple of 96 bytes depending on the transfer length. /∗ ∗ Definition of subcode structure ∗/ struct cdrom_subcode { unsigned int cdsc_length; caddr_t cdsc_addr; }; The next group of I/O controls get and set various CD-ROM drive parameters. CDROMGBLKMODE SPARC: This ioctl( ) command returns the current block size used by the CD-ROM drive. The third argument of the ioctl( ) call is a pointer to an integer.
cdio ( 7I ) Ioctl Requests SunOS 5.5 CDROMSDRVSPEED SPARC: This ioctl( ) command requests the CD-ROM drive to change the current drive speed to the requested drive speed. This speed setting is only applicable when reading data areas. The third argument of the ioctl( ) is an integer which contains the requested drive speed.
SunOS 5.5 Devices NAME SYNOPSIS DESCRIPTION cgeight ( 7D ) cgeight − 24-bit color memory frame buffer /dev/fbs/cgeightn The cgeight is a 24-bit color memory frame buffer with a monochrome overlay plane and an overlay enable plane implemented optionally on the Sun-4/110, Sun-4/150, Sun-4/260 and Sun-4/280 system models. It provides the standard frame buffer interface as defined in fbio(7I).
cgfour ( 7D ) Devices NAME SYNOPSIS DESCRIPTION SunOS 5.5 cgfour − P4-bus 8-bit color memory frame buffer /dev/fbs/cgfourn The cgfour is a color memory frame buffer with a monochrome overlay plane and an overlay enable plane. It provides the standard frame buffer interface as defined in fbio(7I). In addition to the ioctls described under fbio(7I), the cgfour interface responds to two cgfour-specific colormap ioctls, FBIOPUTCMAP and FBIOGETCMAP.
SunOS 5.5 Devices NAME SYNOPSIS DESCRIPTION cgfourteen ( 7D ) cgfourteen − 24-bit color graphics device /dev/fbs/cgfourteenn The cgfourteen device driver controls the video SIMM (VSIMM) component of the video and graphics subsystem of the Desktop SPARCsystems with SX graphics option. The VSIMM provides 24-bit truecolor visuals in a variety of screen resolutions and pixel depths. The driver supports multi-threaded applications and has an interface accessible through mmap(2).
cgsix ( 7D ) Devices NAME SYNOPSIS DESCRIPTION SunOS 5.5 cgsix − accelerated 8-bit color frame buffer /dev/fbs/cgsixn cgsix is a low-end graphics accelerator designed to enhance vector and polygon drawing performance. It has an 8-bit color frame buffer and provides the standard frame buffer interface as defined in fbio(7I). In addition, cgsix supports the following cgsix-specific IOCTL, defined in . FBIOGXINFO Returns cgsix-specific information about the hardware.
SunOS 5.5 Devices NAME SYNOPSIS DESCRIPTION FILES SEE ALSO modified 27 Mar 1992 cgthree ( 7D ) cgthree − 8-bit color memory frame buffer /dev/fbs/cgthreen cgthree is a color memory frame buffer. It provides the standard frame buffer interface as defined in fbio(7I).
cgtwo ( 7D ) Devices NAME SYNOPSIS DESCRIPTION SunOS 5.5 cgtwo − color graphics interface /dev/cgtwon The cgtwo interface provides access to the color graphics controller board, which is normally supplied with a 19’’ 66 Hz non-interlaced color monitor. It provides the standard frame buffer interface as defined in fbio(7I). The hardware consumes 4 megabytes of VME bus address space. The board starts at standard address 0x400000. The board must be configured for interrupt level 4.
SunOS 5.5 Devices NAME cmdk ( 7D ) cmdk − common disk driver AVAILABILITY x86 DESCRIPTION The cmdk device driver is a common interface to various disk devices. The driver supports magnetic fixed disks, magnetic removable disks, and both 512-byte and 2K-byte CD-ROM drives. The block-files access the disk using the system’s normal buffering mechanism and are read and written without regard to physical disk records.
connld ( 7M ) STREAMS Modules NAME SYNOPSIS DESCRIPTION SunOS 5.5 connld − line discipline for unique stream connections /dev/connld connld is a STREAMS-based module that provides unique connections between server and client processes. It can only be pushed (see streamio(7I)) onto one end of a STREAMS-based pipe that may subsequently be attached to a name in the file system name space with fattach(3C).
SunOS 5.5 Devices NAME SYNOPSIS DESCRIPTION SPARC x86 console ( 7D ) console − STREAMS-based console interface /dev/console The file /dev/console refers to the system console device. The identity of this device depends on the EEPROM settings in effect at the most recent system reboot; by default, it is the ‘‘workstation console’’ device consisting of the workstation keyboard and frame buffer acting in concert to emulate an ASCII terminal (see wscons(7D)).
corvette ( 7D ) Devices NAME SunOS 5.5 corvette − low-level module for IBM Micro Channel SCSI-2 Fast/Wide Adapter/A AVAILABILITY x86 DESCRIPTION The corvette module provides low-level interface routines between the common disk/tape I/O subsystem and the IBM Micro Channel SCSI-2 (Small Computer System Interface) Fast/Wide Adapter/A controllers.
SunOS 5.5 Devices NAME csa ( 7D ) csa − low-level module for Compaq SMART SCSI Array Controller AVAILABILITY x86 DESCRIPTION The csa module provides low-level interface routines between the common disk I/O subsystem and the Compaq SMART SCSI (Small Computer System Interface) Array controllers. The csa module can be configured for disk support for one or more host adapter boards.
dbri ( 7D ) Devices NAME AVAILABILITY SunOS 5.5 dbri − Dual Basic Rate ISDN and audio Interface SPARC The DBRI Multimedia Codec, and SpeakerBox are available on SPARCstation 10 and LX systems. SPARCstation 10SX and SPARCstation 20 systems have the Multimedia Codec integrated onto the CPU board of the machine. This hardware may or may not be available on future systems from Sun Microsystems Computer Corporation. There are new configurations for the SX10SX and Gypsy machines.
SunOS 5.5 Devices dbri ( 7D ) The Sun Microphone is recommended for normal desktop audio recording. When the Sun Microphone is used in conjunction with the SpeakerBox, the microphone battery is bypassed. Other audio sources may be recorded by connecting their line output to the SpeakerBox line input (audio sources may also be connected from their headphone output if the volume is adjusted properly). ISDN Interfaces The DBRI controller offers two Basic Rate ISDN (BRI) interfaces.
dbri ( 7D ) Devices SunOS 5.5 B-channels can be configured for µ-law, A-law, or HDLC encoding of data. The µ-law and A-law formats are always at 8000 Hz, 8-bit, mono. Although a BRI H-channel is actually 16 bits wide at the physical layer and the 16-bit sample occurs at 8 kHz, the HDLC encoding always presents the data in 8-bit quantities.
SunOS 5.5 Devices ERRORS In addition to the errors described in audio(7I), an open( ) will fail if: ENODEV FILES dbri ( 7D ) The driver is unable to communicate with the SpeakerBox, possibly because it is currently not plugged in. The physical device names are very system dependent and are rarely used by programmers. For example: /devices/sbus@1,f8000000/SUNW,DBRIe@1,10000:te,b2.
dbri ( 7D ) Devices BUGS SunOS 5.5 When a DBRI channel associated with the SpeakerBox Interface underruns, DBRI may not always repeat the last sample but instead could repeat more than one sample. This behavior can result in a tone being generated by an audio device connected to the SBI port. Monitor STREAMs connected to a B1 channel on either the TE or NT interface do not work because of a DBRI hardware problem. The device driver disallows the creation of such monitors.
SunOS 5.5 Devices NAME display ( 7D ) display − system console display AVAILABILITY x86 DESCRIPTION display is a component of the kd driver, which is comprised of the display and keyboard drivers. Solaris for x86 normally uses a windowed environment. The character-based display facilities offered by the display section of the kd driver are supposed to be used only until the windowing system takes over.
dkio ( 7I ) Ioctl Requests NAME SYNOPSIS DESCRIPTION IOCTLS SunOS 5.5 dkio − disk control operations #include #include Disk drivers support a set of ioctl(2) requests for disk controller, geometry, and partition information. Basic to these ioctl( ) requests are the definitions in .
SunOS 5.
dkio ( 7I ) Ioctl Requests #define DKI_PCMCIA_PFD 0x40 SunOS 5.5 /∗ digits ∗/ /∗ PCMCIA pseudo-floppy memory card ∗/ DKIOCGAPART The argument is a pointer to a dk_allmap structure (described below). This ioctl( ) gets the controller’s notion of the current partition table for disk drive. DKIOCSAPART The argument is a pointer to a dk_allmap structure (described below). This ioctl( ) sets the controller’s notion of the partition table without changing the disk itself.
SunOS 5.5 Ioctl Requests dkio ( 7I ) DKIOCG_PHYGEOM x86: The argument is a pointer to a dk_geom structure (described below). This ioctl( ) gets the driver’s notion of the physical geometry of the disk drive. It is functionally identical to the DKIOCGGEOM ioctl( ). DKIOCG_VIRTGEOM x86: The argument is a pointer to a dk_geom structure (described below). This ioctl( ) gets the controller’s (and hence the driver’s) notion of the virtual geometry of the disk drive.
dkio ( 7I ) Ioctl Requests SunOS 5.5 ioctl( ) returns the device’s current VTOC (volume table of contents). DKIOCSVTOC The argument is a pointer to a vtoc structure (described below). This ioctl( ) changes the VTOC associated with the device.
SunOS 5.5 Ioctl Requests #define V_SWAP #define V_USR #define V_BACKUP #define V_STAND #define V_VAR #define V_HOME #define V_ALTSCTR 0x03 0x04 0x05 0x06 0x07 0x08 0x09 dkio ( 7I ) /∗ Swap filesystem ∗/ /∗ Usr filesystem ∗/ /∗ full disk ∗/ /∗ Stand partition ∗/ /∗ Var partition ∗/ /∗ Home partition ∗/ /∗ Alternate sector partition ∗/ DKIOCADDBAD x86: This ioctl( ) forces the driver to re-examine the alternates slice and rebuild the internal bad block map accordingly.
dlpi ( 7P ) Protocols NAME SYNOPSIS DESCRIPTION SunOS 5.5 dlpi − Data Link Provider Interface #include SunOS STREAMS-based device drivers wishing to support the STREAMS TCP/IP and other STREAMS-based networking protocol suite implementations support Version 2 of the Data Link Provider Interface (DLPI). DLPI V2 enables a data link service user to access and use any of a variety of conforming data link service providers without special knowledge of the provider’s protocol.
SunOS 5.5 Devices NAME SYNOPSIS dnet ( 7D ) dnet − Ethernet driver for D-Link DE-530CT, SMC EtherPower 8432BT, Znyx312, Cogent EM960, Cogent EM100 /dev/dnet AVAILABILITY x86 DESCRIPTION The dnet Ethernet driver is a multi-threaded, loadable, clonable, STREAMS GLD driver. Multiple controllers installed within the system are supported by the driver.
dnet ( 7D ) Devices FILES SEE ALSO SunOS 5.5 bncaui For BNC/AUI connectivity use bncaui=1, for RJ-45 use bncaui=0. RJ-45 is the default. fulldup For full duplex operation use fulldup=1, for half duplex use fulldup=0. Half-duplex operation gives better results on older 10mbit networks. mode For 10mbit operation use mode=10, for 100mbit operation use mode=100. Certain 21140 based cards will operate at either speed. Use the mode property to override the 100mbit default in this case.
SunOS 5.
dsa ( 7D ) Devices NAME SunOS 5.5 dsa − low-level module for Dell SCSI Array Controller (DSA) AVAILABILITY x86 DESCRIPTION The dsa module provides low-level interface routines between the common disk/tape I/O subsystem and the Dell EISA bus master controller. The dsa module can be configured for disk and raid disks on up to four host adapter boards. These disks are called composite disks in Dell configuration software.
SunOS 5.5 Devices NAME SYNOPSIS eepro ( 7D ) eepro − Intel EtherExpress-Pro Ethernet device driver /dev/eepro AVAILABILITY x86 DESCRIPTION The eepro Ethernet driver is a multi-threaded, loadable, clonable, STREAMS hardware driver supporting the connectionless Data Link Provider Interface, dlpi(7P), over Intel EtherExpress-Pro Ethernet controllers. The EtherExpress-Pro Ethernet adapter is based on the Intel 82595TX high integration controller.
eepro ( 7D ) Devices SunOS 5.5 · The provider style is DL_STYLE2. · The version is DL_VERSION_2. · The broadcast address value is Ethernet/IEEE broadcast address (FF:FF:FF:FF:FF:FF). Once in the DL_ATTACHED state, the user must send a DL_BIND_REQ to associate a particular Service Access Pointer (SAP) with the stream. The eepro driver interprets the sap field within the DL_BIND_REQ as an Ethernet “type.” Therefore valid values for the sap field are in the [0-0xFFFF] range.
SunOS 5.5 Devices eepro ( 7D ) The DL_PROMISCON_REQ and DL_PROMISCOFF_REQ primitives with the DL_PROMISC_PHYS flag set in the dl_level field enables/disables reception of all “promiscuous mode” frames on the media including frames generated by the local host. When used with the DL_PROMISC_SAP flag set, this enables/disables reception of all sap (Ethernet type) values. When used with the DL_PROMISC_MULTI flag set, this enables/disables reception of all multicast group addresses.
eepro ( 7D ) Devices FILES SEE ALSO 7D-92 /dev/eepro /kernel/drv/eepro.conf SunOS 5.5 eepro character special device configuration file of eepro driver ioctl(2), driver.
SunOS 5.5 Devices NAME eha ( 7D ) eha − low-level module for Adaptec 174x EISA host bus adapter AVAILABILITY x86 DESCRIPTION The eha module provides low-level interface routines between the common disk/tape io subsystem and the Adaptec EISA 174x SCSI (Small Computer System Interface) controllers. The eha module can be configured for disk and streaming tape support for one or more host adapter boards, each of which must be the sole initiator on a SCSI bus.
el ( 7D ) Devices NAME SYNOPSIS SunOS 5.5 el − 3COM 3C503 Ethernet device driver #include #include #include AVAILABILITY x86 DESCRIPTION The el Ethernet driver is a multi-threaded, loadable, clonable, STREAMS hardware driver supporting the connectionless Data Link Provider Interface, dlpi(7P), over 3COM 3C503 EtherLink II and EtherLink II/16 Ethernet controllers. Multiple EtherLink II controllers installed within the system are supported by the driver.
SunOS 5.5 Devices el ( 7D ) (FF:FF:FF:FF:FF:FF). Once in the DL_ATTACHED state, the user must send a DL_BIND_REQ to associate a particular Service Access Pointer (SAP) with the stream. The el driver interprets the sap field within the DL_BIND_REQ as an Ethernet “type;” therefore valid values for the sap field are in the [0-0xFFFF] range. Only one Ethernet type can be bound to the stream at any time. In addition to Ethernet V2 service, an “802.3 mode” is also provided by the driver.
el ( 7D ) Devices SunOS 5.5 When used with the DL_PROMISC_SAP flag set, this enables/disables reception of all sap (Ethernet type) values. When used with the DL_PROMISC_MULTI flag set, this enables/disables reception of all multicast group addresses. The effect of each is always on a per-stream basis and independent of the other sap and physical level configurations on this stream or other streams.
SunOS 5.5 Devices NAME SYNOPSIS elink ( 7D ) elink − 3COM 3C507 Ethernet device driver #include #include #include AVAILABILITY x86 DESCRIPTION The elink Ethernet driver is a multi-threaded, loadable, clonable, STREAMS hardware driver supporting the connectionless Data Link Provider Interface, dlpi(7P), over 3COM 3C507 EtherLink 16 Ethernet controllers. Multiple EtherLink 16 controllers installed within the system are supported by the driver.
elink ( 7D ) Devices SunOS 5.5 (FF:FF:FF:FF:FF:FF). Once in the DL_ATTACHED state, the user must send a DL_BIND_REQ to associate a particular Service Access Pointer (SAP) with the stream. The elink driver interprets the sap field within the DL_BIND_REQ as an Ethernet “type;” therefore valid values for the sap field are in the [0-0xFFFF] range. Only one Ethernet type can be bound to the stream at any time. In addition to Ethernet V2 service, an “802.3 mode” is also provided by the driver.
SunOS 5.5 Devices elink ( 7D ) When used with the DL_PROMISC_SAP flag set, this enables/disables reception of all sap (Ethernet type) values. When used with the DL_PROMISC_MULTI flag set, this enables/disables reception of all multicast group addresses. The effect of each is always on a per-stream basis and independent of the other sap and physical level configurations on this stream or other streams.
elx ( 7D ) Devices NAME SYNOPSIS SunOS 5.5 elx − 3COM EtherLink III Ethernet device driver #include #include #include AVAILABILITY x86 DESCRIPTION The elx Ethernet driver is a multi-threaded, loadable, clonable, STREAMS hardware driver supporting the connectionless Data Link Provider Interface, dlpi(7P), over 3COM ETHERLINK III Ethernet controllers (3C509, 3C529 and 3C579).
SunOS 5.5 Devices elx ( 7D ) (FF:FF:FF:FF:FF:FF). Once in the DL_ATTACHED state, the user must send a DL_BIND_REQ to associate a particular Service Access Pointer (SAP) with the stream. The elx driver interprets the sap field within the DL_BIND_RE as an Ethernet “type;” therefore valid values for the sap field are in the [0-0xFFFF] range. Only one Ethernet type can be bound to the stream at any time. In addition to Ethernet V2 service, an “802.3 mode” is provided by the driver and works as follows.
elx ( 7D ) Devices SunOS 5.5 When used with the DL_PROMISC_SAP flag set, this enables/disables reception of all sap (Ethernet type) values. When used with the DL_PROMISC_MULTI flag set, this enables/disables reception of all multicast group addresses. The effect of each is always on a per-stream basis and independent of the other sap and physical level configurations on this stream or other streams.
SunOS 5.5 Devices NAME esa ( 7D ) esa − low-level module for Adaptec 7770 based SCSI controllers AVAILABILITY x86 DESCRIPTION The esa module provides low-level interface routines between the common disk/tape I/O system and SCSI (Small Computer System Interface) controllers based on the Adaptec AIC-7770 SCSI chip. These controllers include the Adaptec 2740 and 2840, as well as motherboards with an embedded AIC-7770 SCSI chip.
esp ( 7D ) Devices NAME SYNOPSIS SunOS 5.5 esp − ESP SCSI Host Bus Adapter Driver esp@sbus-slot,0x80000 AVAILABILITY SBus-based systems with esp-based SCSI port and SSHA, SBE/S, FSBE/S and DSBE/S SBus SCSI Host Adapter options. DESCRIPTION The esp Host Bus Adapter driver is a SCSA compliant nexus driver that supports the Emulex family of esp SCSI chips (esp100, esp100A, esp236, fas101, fas236). The esp driver supports the standard functions provided by the SCSA interface.
SunOS 5.5 Devices FILES SEE ALSO /kernel/drv/esp /kernel/drv/esp.conf esp ( 7D ) ELF Kernel Module Configuration file prtconf(1M), driver.conf(4), scsi_abort(9F), scsi_hba_attach(9F), scsi_ifgetcap(9F), scsi_reset(9F), scsi_sync_pkt(9F), scsi_transport(9F), scsi_device(9S), scsi_extended_sense(9S), scsi_inquiry(9S), scsi_pkt(9S), Writing Device Drivers ANSI Small Computer System Interface-2 (SCSI-2) ESP Technical Manuals, QLogic Corp.
esp ( 7D ) Devices SunOS 5.5 The driver received an interrupt while the hardware was not interrupting. Lost state in phasemanage The driver is confused about the state of the SCSI bus. Unrecoverable DMA error during selection The DMA controller experienced host SBus problems. Check for bad hardware. Bad sequence step (0x%x) in selection The esp hardware reported a bad sequence step. Check for bad hardware. Undetermined selection failure The selection of a target failed unexpectedly.
SunOS 5.5 Devices esp ( 7D ) SCSI bus DATA IN phase parity error The driver detected parity errors on the SCSI bus. SCSI bus MESSAGE IN phase parity error The driver detected parity errors on the SCSI bus. SCSI bus STATUS phase parity error The driver detected parity errors on the SCSI bus. Premature end of extended message An extended SCSI bus message did not complete. Suspect a target f/w problem. Premature end of input message A multibyte input message was truncated. Suspect a target f/w problem.
esp ( 7D ) Devices SunOS 5.5 f/w problem. For tagged queuing targets, commands were outstanding when the timeout was detected. Connected command timeout for Target .. This is usually a SCSI bus problem. Check cables and termination. Target . reverting to async. mode A data transfer hang was detected. The driver attempts to eliminate this problem by reducing the data transfer rate. Target . reducing sync. transfer rate A data transfer hang was detected.
SunOS 5.5 Ioctl Requests NAME DESCRIPTION fbio ( 7I ) fbio − frame buffer control operations The frame buffers provided with this release support the same general interface that is defined by . Each responds to an FBIOGTYPE ioctl(2) request which returns information in a fbtype structure. Each device has an FBTYPE which is used by higher-level software to determine how to perform graphics functions.
fbio ( 7I ) Ioctl Requests SEE ALSO BUGS SunOS 5.5 ioctl(2), mmap(2), bwtwo(7D), cgeight(7D), cgfour(7D), cgsix(7D), cgthree(7D), cgtwo(7D) The FBIOSATTR and FBIOGATTR ioctl( ) requests are only supported by frame buffers which emulate older frame buffer types. For example, cgfour(7D) frame buffers emulate bwtwo(7D) frame buffers. If a frame buffer is emulating another frame buffer, FBIOGTYPE returns the emulated type. To get the real type, use FBIOGATTR.
SunOS 5.5 Devices NAME fd ( 7D ) fd, fdc − drivers for floppy disks and floppy disk controllers SYNOPSIS SPARC x86 DESCRIPTION /dev/diskette0 /dev/rdiskette0 /dev/diskette[0-1] /dev/rdiskette[0-1] The fd driver provides the interfaces to the floppy disks using the Intel 82072 on sun4c systems and the Intel 82077 on sun4m and sun4u systems. The fd and fdc drivers provide the interfaces to floppy disks using the Intel 8272, Intel 82077, NEC 765, or compatible disk controllers on x86 systems.
fd ( 7D ) Devices 5.25" Diskettes For 5.25" double-sided diskettes, the following densities are supported: 5.25" diskettes are not supported. SPARC high density double density double density quad density double density x86 double density ERRORS x86 Only SunOS 5.5 80 cylinders, 15 sectors per track, 1.
SunOS 5.5 Devices FILES /platform/platform-name/kernel/drv/fd /usr/include/sys/fdio.h SPARC /dev/fd0[a-c] /dev/rfd0[a-c] /platform/i86pc/kernel/drv/fd.conf /platform/i86pc/kernel/drv/fdc /platform/i86pc/kernel/drv/fdc.conf /usr/include/sys/fdc.h /usr/include/sys/fdmedia.h /usr/include/sys/fd_debug.
fd ( 7D ) Devices SEE ALSO SunOS 5.5 fdformat(1), uname(1), dd(1M), drvconfig(1M), vold(1M), read(2), write(2), driver.conf(4), dkio(7I), fdio(7I) Solaris 2.x x86 Hardware Compatibility List DIAGNOSTICS fd: failed ( ) The failed after several retries on drive .
SunOS 5.5 Devices fd ( 7D ) configuration to be accurate. Solaris x86 also supports "medium" density, the 1.2-Mbyte, 77-cylinder, 1024-byte sector format on 3.5" high-density diskettes, used by NEC-DOS. This feature has two hardware requirements. First, the floppy drive must be one of the supported, dual-speed, highdensity drives. Second, the floppy controller must be one of the supported enhanced controllers that provide a programmable DENSEL output.
fdio ( 7I ) Ioctl Requests NAME SYNOPSIS DESCRIPTION IOCTLS SunOS 5.5 fdio − floppy disk control operations #include The Solaris floppy driver supports a set of ioctl(2) requests for getting and setting the floppy drive characteristics. Basic to these ioctl( ) requests are the definitions in . The following ioctl( ) requests are available only on the Solaris floppy driver.
SunOS 5.5 Ioctl Requests fdio ( 7I ) /∗ ∗ Floppy characteristics ∗/ struct fd_char { u_char fdc_medium; int fdc_transfer_rate; int fdc_ncyl; int fdc_nhead; int fdc_sec_size; int fdc_secptrack; int fdc_steps; }; /∗ equals 1 if medium type ∗/ /∗ transfer rate ∗/ /∗ number of cylinders ∗/ /∗ number of heads ∗/ /∗ sector size ∗/ /∗ sectors per track ∗/ /∗ no. of steps per data track ∗/ FDGETDRIVECHAR The argument to this ioctl( ) is a pointer to an fd_drive structure (described below).
fdio ( 7I ) Ioctl Requests SunOS 5.5 FDEJECT SPARC: This ioctl() requests the floppy drive to eject the diskette. FDIOCMD The argument is a pointer to an fd_cmd structure (described below). This ioctl( ) allows access to the floppy diskette using the floppy device driver. Only the FDCMD_WRITE, FDCMD_READ, and FDCMD_FORMAT_TR commands are currently available.
SunOS 5.
gld ( 7D ) Devices NAME gld − Generic LAN Driver SYNOPSIS #include #include #include #include #include SunOS 5.5 AVAILABILITY x86 DESCRIPTION gld is a multi-threaded, clonable Generic LAN Driver support module which resides in a loadable kernel module, /kernel/misc/gld. It implements most of the STREAMS functions and DLPI functionality required of a LAN driver. Several Solaris network drivers are implemented using GLD.
SunOS 5.5 gld and Style 1 and 2 Providers Devices gld ( 7D ) GLD implements both Style 1 and Style 2 providers. The Style 1 provider assigns a physical point of attachment (PPA) based on the major/minor device that has been opened and bound. A PPA is the point at which a system attaches itself to a physical communication medium. All communication on that physical medium funnels through the PPA. The Style 2 provider requires the DLS user to explicitly identify the desired PPA using DL_ATTACH_REQ.
gld ( 7D ) Devices SunOS 5.5 closed. The DL_UNITDATA_REQ primitive is used to send data in a connectionless transfer. Because this is an unacknowledged service, there is no guarantee of delivery. The message consists of one M_PROTO message block followed by one or more M_DATA blocks containing at least one byte of data. The DL_PHYS_ADDR_REQ primitive returns the 6-octet Ethernet address currently associated (attached) to the STREAM in the DL_PHYS_ADDR_ACK primitive.
SunOS 5.5 Ioctl Requests NAME SYNOPSIS DESCRIPTION IOCTLS hdio ( 7I ) hdio − SMD and IPI disk control operations #include The SMD and IPI disk drivers supplied with this release support a set of ioctl(2) requests for diagnostics and bad sector information. Basic to these ioctl( ) requests are the definitions in . HDKIOCGTYPE The argument is a pointer to a hdk_type structure (described below). This ioctl( ) gets specific information from the hard disk.
hdio ( 7I ) Ioctl Requests /∗ ∗ Used for disk diagnostics ∗/ struct hdk_diag { u_short hdkd_errcmd; daddr_t hdkd_errsect; u_char hdkd_errno; u_char hdkd_severe; }; SEE ALSO 7I-124 SunOS 5.
SunOS 5.5 File Systems NAME DESCRIPTION hsfs ( 7FS ) hsfs − High Sierra & ISO 9660 CD-ROM filesystem HSFS is a filesystem type that allows users access to files on High Sierra or ISO 9660 format CD-ROM disks from within the SunOS operating system. Once mounted, a HSFS filesystem provides standard SunOS read-only file system operations and semantics.
hsfs ( 7FS ) File Systems SunOS 5.5 High Sierra and ISO 9660 CD-ROMs only support regular files and directories, thus HSFS only supports these file types. A Rock Ridge CD-ROM can support regular files, directories and symbolic links, as well as device nodes, such as block, character and FIFO. EXAMPLES If there is a file BIG.BAR on a High Sierra or ISO 9660 format CD-ROM it will show up as big.bar when listed on a HSFS filesystem. If there are three files BAR.BAZ;1 BAR.BAZ;2 BAR.
SunOS 5.5 File Systems hsfs ( 7FS ) Under MS-DOS (for which CD-ROMs are frequently targeted), files with no extension may be represented either as filename. or filename (that is, with or without a trailing period). These names are not equivalent under UNIX systems. For example, the names BAR. and BAR are not names for the same file under the UNIX system. This may cause confusion if you are consulting documentation for CD-ROMs originally intended for MS-DOS systems.
icmp ( 7P ) Protocols NAME SYNOPSIS SunOS 5.5 icmp, ICMP − Internet Control Message Protocol #include #include #include s = socket(AF_INET, SOCK_RAW, proto); t = t_open("/dev/icmp", O_RDWR); DESCRIPTION ICMP is the error and control message protocol used by the Internet protocol family. It is used by the kernel to handle and report errors in protocol processing.
SunOS 5.5 Protocols ENOBUFS icmp ( 7P ) The system ran out of memory for an internal data structure. EADDRNOTAVAIL An attempt was made to create a socket with a network address for which no network interface exists. NOTES modified 3 Jul 1990 Replies to ICMP “echo” messages which are source routed are not sent back using inverted source routes, but rather go back through the normal routing mechanisms.
ie ( 7D ) Devices NAME SYNOPSIS DESCRIPTION SunOS 5.5 ie − Intel 82586 Ethernet device driver /dev/ie The Intel 82586 ethernet driver is a multithreaded, loadable, clonable, STREAMS hardware driver supporting the connectionless Data Link Provider Interface, dlpi(7P), over Intel 82586 ethernet controller. Two device implementations are supported by this driver — the onboard 82586 for those systems which include this chip on the motherboard and the 3/E VME Ethernet/SCSI card.
SunOS 5.5 Devices ie ( 7D ) Once in the DL_ATTACHED state, the user must send a DL_BIND_REQ to associate a particular SAP (Service Access Pointer) with the stream. The ie driver interprets the sap field within the DL_BIND_REQ as an Ethernet “type”. Therefore, valid values for the sap field are in the [0-0xFFFF] range. Only one Ethernet type can be bound to the stream at any time. In addition to Ethernet V2 service, an “802.3 mode” is provided by the driver and works as follows.
ie ( 7D ) Devices SunOS 5.5 on a per-stream basis and independent of the other sap and physical level configurations on this stream or other streams. The DL_PHYS_ADDR_REQ primitive return the 6 octet Ethernet address currently associated (attached) to the stream in the DL_PHYS_ADDR_ACK primitive. This primitive is valid only in states following a successful DL_ATTACH_REQ. The DL_SET_PHYS_ADDR_REQ primitive changes the 6 octet Ethernet address currently associated (attached) to this stream.
SunOS 5.5 Devices NAME SYNOPSIS iee ( 7D ) iee − Intel EtherExpress 16 Ethernet device driver #include #include #include AVAILABILITY x86 DESCRIPTION The iee Ethernet driver is a multi-threaded, loadable, clonable, STREAMS hardware driver supporting the connectionless Data Link Provider Interface, dlpi(7P), over Intel EtherExpress 16 Ethernet controllers. Multiple EtherLink 16 controllers installed within the system are supported by the driver.
iee ( 7D ) Devices SunOS 5.5 (FF:FF:FF:FF:FF:FF). Once in the DL_ATTACHED state, the user must send a DL_BIND_REQ to associate a particular Service Access Pointer (SAP) with the stream. The iee driver interprets the sap field within the DL_BIND_REQ as an Ethernet “type;” therefore valid values for the sap field are in the [0-0xFFFF] range. Only one Ethernet type can be bound to the stream at any time. In addition to Ethernet V2 service, an “802.3 mode” is also provided by the driver.
SunOS 5.5 Devices iee ( 7D ) When used with the DL_PROMISC_SAP flag set, this enables/disables reception of all sap (Ethernet type) values. When used with the DL_PROMISC_MULTI flag set, this enables/disables reception of all multicast group addresses. The effect of each is always on a per-stream basis and independent of the other sap and physical level configurations on this stream or other streams.
ieef ( 7D ) Devices NAME SYNOPSIS SunOS 5.5 ieef − Intel EtherExpress Flash32/82596 Ethernet device driver #include #include #include
SunOS 5.5 Devices · ieef ( 7D ) The broadcast address value is Ethernet/IEEE broadcast address (FF:FF:FF:FF:FF:FF). Once in the DL_ATTACHED state, the user must send a DL_BIND_REQ to associate a particular Service Access Pointer (SAP) with the stream. The ieef driver interprets the sap field within the DL_BIND_REQ as an Ethernet “type;” therefore valid values for the sap field are in the [0-0xF] range. Only one Ethernet type can be bound to the stream at any time.
ieef ( 7D ) Devices SunOS 5.5 When used with the DL_PROMISC_SAP flag set, this enables/disables reception of all sap (Ethernet type) values. When used with the DL_PROMISC_MULTI flag set, this enables/disables reception of all multicast group addresses. The effect of each is always on a per-stream basis and independent of the other sap and physical level configurations on this stream or other streams.
SunOS 5.5 Protocols NAME DESCRIPTION APPLICATION PROGRAMMING INTERFACE IOCTLS if_tcp ( 7P ) if_tcp, if − general properties of Internet Protocol network interfaces A network interface is a device for sending and receiving packets on a network. A network interface is usually a hardware device, although one may be implemented in software. Network interfaces used by the Internet Protocol (IP) must be STREAMS devices conforming to the Datalink Provider Interface (DLPI). See dlpi(7P).
if_tcp ( 7P ) Protocols #define ifr_oname ifr_ifru.ifru_oname #define ifr_broadaddr ifr_ifru.ifru_broadaddr #define ifr_flags ifr_ifru.ifru_flags #define ifr_metric #define ifr_data #define ifr_enaddr }; 7P-140 ifr_ifru.ifru_metric ifr_ifru.ifru_data ifr_ifru.ifru_enaddr SunOS 5.5 /∗ other if name ∗/ /∗ broadcast address ∗/ /∗ flags ∗/ /∗ metric ∗/ /∗ for use by interface ∗/ /∗ ethernet address ∗/ SIOCSIFADDR Set interface address.
SunOS 5.5 Protocols if_tcp ( 7P ) The ifconf structure has the form: /∗ ∗ Structure used in SIOCGIFCONF request. ∗ Used to retrieve interface configuration ∗ for machine (useful for programs which ∗ must know all networks accessible). ∗/ struct ifconf { int ifc_len; /∗ size of associated buffer ∗/ union { caddr_t struct ifreq } ifc_ifcu; #define #define }; ERRORS ifc_buf ifc_req ifcu_buf; ∗ifcu_req; ifc_ifcu.ifcu_buf ifc_ifcu.
inet ( 7P ) Protocols NAME SYNOPSIS SunOS 5.5 inet − Internet protocol family #include #include DESCRIPTION The Internet protocol family implements a collection of protocols which are centered around the Internet Protocol (IP) and which share a common address format.
SunOS 5.5 ADDRESSING Protocols inet ( 7P ) IP addresses are four byte quantities, stored in network byte order. IP addresses should be manipulated using the byte order conversion routines (see byteorder(3N)). Addresses in the Internet protocol family use the sockaddr_in structure, which has that following members: short u_short struct char sin_family; sin_port; in_addr sin_zero[8]; sin_addr; Library routines are provided to manipulate structures of this form; See inet(3N).
inet ( 7P ) Protocols SunOS 5.5 Although this implementation restricts sockets to unique local port numbers, TCP allows multiple simultaneous connections involving the same local port number so long as the remote IP addresses or port numbers are different for each connection. Programs may explicitly override the socket restriction by setting the SO_REUSEADDR socket option with setsockopt (see getsockopt(3N)). TLI applies somewhat different semantics to the binding of local port numbers.
SunOS 5.5 Protocols NAME ip, IP − Internet Protocol SYNOPSIS #include #include ip ( 7P ) s = socket(AF_INET, SOCK_RAW, proto); t = t_open ("/dev/rawip", O_RDWR); DESCRIPTION IP is the internetwork datagram delivery protocol that is central to the Internet protocol family. Programs may use IP through higher-level protocols such as the Transmission Control Protocol (TCP) or the User Datagram Protocol (UDP), or may interface directly to IP. See tcp(7P) and udp(7P).
ip ( 7P ) Protocols SunOS 5.5 These options take a struct ip_mreq as the parameter. The structure contains a multicast address which has to be set to the CLASS-D IP multicast address, and an interface address. Normally the interface address is set to INADDR_ANY which causes the kernel to choose the interface to join on. IP_MULTICAST_IF The outgoing interface for multicast packets. This option takes a struct in_addr as an argument and it selects that interface for outgoing IP multicast packets.
SunOS 5.5 Protocols ip ( 7P ) The IP layer will send an ICMP message back to the source host in many cases when it receives a datagram that can not be handled. A “time exceeded” ICMP message will be sent if the “time to live” field in the IP header drops to zero in the process of forwarding a datagram. A “destination unreachable” message will be sent if a datagram can not be forwarded because there is no route to the final destination, or if it can not be fragmented.
ip ( 7P ) Protocols ERRORS NOTES SunOS 5.5 The following errors may occur when setting or getting IP options: EINVAL An unknown socket option name was given. EINVAL The IP option field was improperly formed; an option field was shorter than the minimum value or longer than the option buffer provided. Raw sockets should receive ICMP error packets relating to the protocol; currently such packets are simply discarded.
SunOS 5.5 Devices NAME SYNOPSIS AVAILABILITY ipi ( 7D ) ipi, id, is, pn, ipi3sc − IPI driver pn@4d,0x1080000/ipi3sc@board-num,0/id@facility,0:partition SPARC Only available on Sun-4/370, Sun-4/400, and SPARCsystem 600MP series systems. DESCRIPTION The driver for IPI disk devices consists of several components: an IPI controller driver (pn and ipi3sc), and a facility driver (id).
ipi ( 7D ) Devices SunOS 5.5 The supported commands are: IP_READ IP_WRITE IP_READ_DEFLIST IP_WRITE_DEFLIST DISK SUPPORT FILES SEE ALSO NOTES 7D-150 Read or write data. The addressing is always by logical block (ignoring [a-h] logical partition information); the Opcode modifier is ignored. Read or write one of the defect lists. The defect list is selected by the Opcode modifier in bits <15:8> of the hdkc_cmd. IP_FORMAT Format a range of cylinders.
SunOS 5.5 Ioctl Requests NAME SYNOPSIS isdnio ( 7I ) isdnio − ISDN interfaces #include #include int ioctl (int fd, int command, /∗ arg ∗/ . . .); DESCRIPTION ISDN ioctl commands are a subset of ioctl(2) commands that perform a variety of control functions on Integrated Services Digital Network (ISDN) STREAMS devices. The arguments command and arg are passed to the file designated by fd and are interpreted by the ISDN device driver.
isdnio ( 7I ) Ioctl Requests SunOS 5.5 The CCITT recommendations on ISDN Basic Rate interfaces, I.430, identify several “reference points” for standardization. From (Stallings89); “Reference point T (terminal) corresponds to a minimal ISDN network termination at the customer’s premises. It separates the network provider’s equipment from the user’s equipment. Reference point S (system) corresponds to the interface of individual ISDN terminals.
SunOS 5.5 Ioctl Requests isdnio ( 7I ) Primary Rate ISDN Primary Rate ISDN (PRI) interfaces are either 1.544Mbps (T1 rate) or 2.048Mbps (E1 rate) and are typically organized as 23 B-channels and one D-Channel (23B+D) for T1 rates, and 30 B-Channels and one D-Channel (30B+D) for E1 rates. The D-channels on a PRI interface operate at 64000 bits per second. T1 rate PRI interface is the standard in the United States, Canada and Japan while E1 rate PRI interface is the standard in European countries.
isdnio ( 7I ) Ioctl Requests SunOS 5.5 Auxiliary channels Auxiliary channels are non-ISDN hardware interfaces that are closely tied to the ISDN interfaces. An example would be a video or audio coder/decoder (codec). The existence of an auxiliary channel usually implies that one or more B-channels can be “connected” to an auxiliary interface in hardware. Management pseudo-channels A management pseudo-channel is used for the management of a controller, interface, or hardware channel.
SunOS 5.
isdnio ( 7I ) Ioctl Requests ∗/ /∗ Not an ISDN interface ∗/ ISDN_TYPE_OTHER, ISDN_TYPE_TE, ISDN_TYPE_NT, ISDN_TYPE_PRI, } isdn_interface_t; Activation and Deactivation of ISDN Interfaces SunOS 5.5 The management device associated with an ISDN D-channel is used to request activation, deactivation and receive information about the activation state of the interface. See the descriptions of the ISDN_PH_ACTIVATE_REQ and ISDN_MPH_DEACTIVATE_REQ ioctls.
SunOS 5.5 Ioctl Requests isdnio ( 7I ) fd must be a NT D-channel file descriptor. arg is ignored. This command requests ISDN physical layer de-activation. This is not valid for TE interfaces. A TE interace may be turned off by use of the ISDN_PARAM_POWER command or by close(2) on the associated fd. ISDN_ACTIVATION_STATUS fd is the file descriptor for a D-channel, the management device associated with an ISDN interface, or the management device associated with the controller.
isdnio ( 7I ) Ioctl Requests unsigned int unsigned int unsigned int } isdn_interface_info_t; mph_ei2; mph_ii_c; mph_ii_d; SunOS 5.5 /∗ Management: Error 2 Indication ∗/ /∗ Management: Info Ind, connection ∗/ /∗ Management: Info Ind, disconn. ∗/ ISDN_CHANNEL_STATUS The ISDN_CHANNEL_STATUS ioctl retrieves the status and statistics of an ISDN channel. The requesting channel must own the channel whose status is being requested or the ioctl will fail. fd is any file descriptor.
SunOS 5.
isdnio ( 7I ) Ioctl Requests SunOS 5.5 operation this parameter should be set to ISDN_PARAM_MAINT_ECHO. Other uses of this parameter are dependent on the definition and use of the BRI interface S and Q channels. ISDN_PARAM_ASMB There are a few differences in the BRI-TE interface activation state machine standards. This parameter allows the selection of the appropriate standard. At this time, only ISDN_PARAM_TE_ASMB_CCITT88 and ISDN_PARAM_TE_ASMB_CTS2 are available.
SunOS 5.5 ISDN data format Ioctl Requests isdnio ( 7I ) The isdn_format_t type is meant to be a complete description of the various data modes and rates available on an ISDN interface. Several macros are available for setting the format fields. The isdn_format_t structure is shown below: /∗ ISDN channel data format ∗/ typedef enum { ISDN_MODE_NOTSPEC, ISDN_MODE_HDLC, ISDN_MODE_TRANSPARENT } isdn_mode_t; /∗ Audio encoding types (from audioio.
isdnio ( 7I ) Channel Management IOCTLS Ioctl Requests SunOS 5.5 The following ioctls describe operations on individual channels and the connection of multiple channels. ISDN_SET_FORMAT fd is a data channel, the management pseudo-channel associated with the data channel, or the management channel associated with the data channel’s interface or controller. arg is a pointer to a struct isdn_format_req. The ISDN_SET_FORMAT ioctl sets the format of an ISDN channel-stream datapath.
SunOS 5.5 Ioctl Requests isdnio ( 7I ) parameter arg is a pointer to an ISDN connection request (isdn_conn_req_t∗). Once a data path is established, data flow is started as soon as the path endpoints become active. Upon taking effect, all state information is reset to initial conditions, as if a channel was just opened. The isdn_conn_req_t structure is shown below. The five fields include the receive and transmit ISDN channels, the number of directions of the data path, as well as the data format.
isdnio ( 7I ) Ioctl Requests SunOS 5.5 typedef struct isdn_conn_tab { char name[ISDN_ID_SIZE]; /∗ identification string ∗/ isdn_interface_t type; int maxpaths; /∗ size in entries of app’s array ∗/ int npaths; /∗ ∗ number of valid entries ∗ returned by driver ∗/ isdn_conn_req_t ∗paths; /∗ connection table in app’s memory ∗/ } isdn_conn_tab_t; The table contains a string which is the interface’s unique identification string.
SunOS 5.5 Devices NAME SYNOPSIS DESCRIPTION isp ( 7D ) isp − ISP SCSI Host Bus Adapter Driver isp@sbus-slot,0x10000 The isp Host Bus Adapter is a SCSA compliant nexus driver that supports the Qlogic ISP1000 SCSI chip. The ISP1000 SCSI is an intelligent SCSI Host Bus Adapter chip that reduces the amount of CPU overhead used in a SCSI transfer. The isp driver supports the standard functions provided by the SCSA interface.
isp ( 7D ) Devices FILES SEE ALSO /kernel/drv/isp /kernel/drv/isp.conf SunOS 5.5 ELF Kernel Module Configuration file prtconf(1M), driver.conf(4), scsi_abort(9F), scsi_hba_attach(9F), scsi_ifgetcap(9F), scsi_reset(9F), scsi_transport(9F), scsi_device(9S), scsi_extended_sense(9S), scsi_inquiry(9S), scsi_pkt(9S) Writing Device Drivers ANSI Small Computer System Interface-2 (SCSI-2) ISP1000 Firmware Interface Specification, QLogic Corp. ISP1000 Technical Manual, QLogic Corp.
SunOS 5.5 Devices isp ( 7D ) mean that the firmware was corrupted somehow; check the isp driver. Firmware checksum incorrect Firmware has an invalid checksum and will not be downloaded. Chip reset timeout ISP1000 failed to reset in the time allocated, may be bad hardware. Stop firmware failed Stopping the firmware failed, may be bad hardware.
isp ( 7D ) Devices SunOS 5.5 Fatal error, resetting interface This is an indication that the isp driver is doing error recovery. This will cause all outstanding commands that have been transported to the isp driver to be completed via the scsi_pkt completion routine in the target driver with reason of CMD_RESET and status of STAT_BUS_RESET set in the scsi_pkt.
SunOS 5.5 Devices NAME SYNOPSIS iss ( 7D ) iss − low-level module for Tricord System’s SCSI host bus adapter iss@slotc8bus,0 AVAILABILITY x86 DESCRIPTION The iss module provides low-level interface routines between the common disk/tape (see cmdk(7D) and st(7D)) I/O subsystem and Tricord System’s Intelligent SCSI Subsystem (ISS) controllers. The iss module can be configured for hard disk, CD-ROM and streaming tape support for one or more ISS boards.
iss ( 7D ) Devices SunOS 5.5 A system can be installed using another vendor’s SCSI controller as the boot controller, Adaptec for example. In this case the Adaptec controller devices assume the controller 0 names, and ISS busses have controllers from 1 onward. If no devices reside on a given bus of an ISS then the controller number associated with that bus will be assigned to the next bus.
SunOS 5.5 STREAMS Modules NAME SYNOPSIS kb ( 7M ) kb − keyboard STREAMS module #include #include #include #include #include #include ioctl(fd, I_PUSH, "kb"); AVAILABILITY SPARC DESCRIPTION The kb STREAMS module processes byte streams generated by keyboard attached to a CPU serial port. Definitions for altering keyboard translation, and reading events from the keyboard, are in and .
kb ( 7M ) STREAMS Modules SunOS 5.5 Controlled Used when a key is depressed and the Control key is being held down (regardless of whether a Shift key or the Alt Graph is being held down, or whether Caps Lock or Num Lock is in effect). Key Up Used when a key is released. Each key on the keyboard has a “key station” code which is a number from 0 to 127. This number is used as an index into the translation table that is currently in effect.
SunOS 5.5 STREAMS Modules FUNNY 0x300 FA_CLASS 0x400 STRING 0x500 kb ( 7M ) Performs various functions depending on the value of the low 4 bits: NOP 0x300 Does nothing. OOPS 0x301 Exists, but is undefined. HOLE 0x302 There is no key in this position on the keyboard, and the position-code should not be used. RESET 0x306 Keyboard reset. ERROR 0x307 The keyboard driver detected an internal error. IDLE 0x308 The keyboard is idle (no keys down).
kb ( 7M ) STREAMS Modules SunOS 5.5 Individual string numbers are defined as: HOMEARROW UPARROW DOWNARROW LEFTARROW RIGHTARROW 0x00 0x01 0x02 0x03 0x04 String numbers 0x05 — 0x0F are available for custom entries. FUNCKEYS 0x600 Function keys.
SunOS 5.5 STREAMS Modules PAD3 0x70E “3” key PAD0 0x70F “0” key PADDOT 0x710 “.” key PADENTER 0x711 “Enter” key kb ( 7M ) In TR_ASCII mode, when a function key is pressed, the following escape sequence is sent: ESC[0 . . .. 9z where ESC is a single escape character and “0 . .. 9” indicates the decimal representation of the function-key value. For example, function key R1 sends the sequence: ESC[208z because the decimal value of RF(1) is 208.
kb ( 7M ) STREAMS Modules SunOS 5.5 entry to be modified: UPMASK 0x0080 “Key Up” translation table. NUMLOCKMASK 0x0800 “Num Lock” translation table. CTRLMASK 0x0030 “Controlled” translation table. ALTGRAPHMASK 0x0200 “Alt Graph” translation table. SHIFTMASK 0x000E “Shifted” translation table. CAPSMASK 0x0001 “Caps Lock” translation table. (No shift keys pressed or locked) “Unshifted” translation table. kio_station specifies the keystation code for the entry to be modified.
SunOS 5.5 STREAMS Modules KBD_CMD_RESET KBD_CMD_BELL KBD_CMD_NOBELL KBD_CMD_CLICK KBD_CMD_NOCLICK kb ( 7M ) Reset keyboard as if power-up. Turn on the bell. Turn off the bell. Turn on the click annunciator. Turn off the click annunciator. Commands to the Sun Type 4 keyboard: KBD_CMD_SETLED Set keyboard LEDs. KBD_CMD_GETLAYOUT Request that keyboard indicate layout. Inappropriate commands for particular keyboard types are ignored.
kdmouse ( 7D ) NAME Devices SunOS 5.5 kdmouse − built-in mouse device interface AVAILABILITY x86 DESCRIPTION The kdmouse driver supports Micro Channel architecture mice and compatibles (such as the IBM PS/2 mouse) on machines with built-in mouse interfaces such as the 20e and the model 80. It allows applications to obtain information about the mouse’s movements and the status of its buttons. Programs are able to read directly from the device.
SunOS 5.5 Devices NAME keyboard ( 7D ) keyboard − system console keyboard AVAILABILITY x86 DESCRIPTION keyboard is a component of the kd driver, which is comprised of the display and keyboard drivers. The Solaris for x86 keyboard may be either an 84- or a 101-key standard PC keyboard. When the system is booting, keyboard services are provided by the keyboard section of the kd driver.
kstat ( 7D ) Devices NAME DESCRIPTION FILES SEE ALSO 7D-180 SunOS 5.5 kstat − kernel statistics driver The kstat driver is the mechanism used by the kstat(3K) library to extract kernel statistics. This is NOT a public interface.
SunOS 5.5 Devices NAME SYNOPSIS DESCRIPTION ksyms ( 7D ) ksyms − kernel symbols /dev/ksyms The file /dev/ksyms is a character special file that allows read-only access to an ELF format image containing two sections: a symbol table and a corresponding string table. The contents of the symbol table reflect the symbol state of the currently running kernel. You can determine the size of the image with the fstat( ) system call.
ksyms ( 7D ) Devices SunOS 5.5 Avoid keeping the /dev/ksyms file open for extended periods of time, either by using kvm_open(3K) of the default namelist file or with a direct open. There are two reasons why you should not hold /dev/ksyms open. First, the system’s ability to dynamic configure itself is partially disabled by the locking down of loaded modules.
SunOS 5.5 STREAMS Modules NAME SYNOPSIS ldterm ( 7M ) ldterm − standard STREAMS terminal line discipline module #include #include int ioctl( fd, I_PUSH, "ldterm" ); DESCRIPTION ldterm is a STREAMS module that provides most of the termio(7I) terminal interface.
ldterm ( 7M ) STREAMS Modules SunOS 5.5 termio(7I) processing is to be done. If the command field of the iocblk structure (ioc_cmd) is set to MC_NO_CANON, the input canonical processing normally performed on M_DATA messages is disabled and those messages are passed upstream unmodified; this is for the use of modules or drivers that perform their own input processing, such as a pseudo-terminal in TIOCREMOTE mode connected to a program that performs this processing.
SunOS 5.5 STREAMS Modules ldterm ( 7M ) TCSETS/TCSETSW/TCSETSF/TCSETA/TCSETAW/TCSETAF The parameters that control the behavior of the ldterm module are changed. If a mode change requires options at the stream head to be changed, an M_SETOPTS message is sent upstream. If the ICANON flag is turned on or off, the read mode at the stream head is changed to message-nondiscard or bytestream mode, respectively.
le ( 7D ) Devices NAME SYNOPSIS DESCRIPTION APPLICATION PROGRAMMING INTERFACE le and DLPI SunOS 5.5 le, lebuffer, ledma − Am7990 (LANCE) Ethernet device driver /dev/le The Am7990 (LANCE) Ethernet driver is a multi-threaded, loadable, clonable, STREAMS hardware driver supporting the connectionless Data Link Provider Interface, dlpi(7P), over a LANCE Ethernet controller. The motherboard and add-in SBus LANCE controllers of several varieties are supported.
SunOS 5.5 Devices le ( 7D ) Once in the DL_ATTACHED state, the user must send a DL_BIND_REQ to associate a particular SAP (Service Access Pointer) with the stream. The le driver interprets the sap field within the DL_BIND_REQ as an Ethernet “type” therefore valid values for the sap field are in the [0-0xFFFF] range. Only one Ethernet type can be bound to the stream at any time. If the user selects a sap with a value of 0, the receiver will be in “802.3 mode”.
le ( 7D ) Devices SunOS 5.5 When used with the DL_PROMISC_SAP flag set this enables/disables reception of all sap (Ethernet type) values. When used with the DL_PROMISC_MULTI flag set this enables/disables reception of all multicast group addresses. The effect of each is always on a per-stream basis and independent of the other sap and physical level configurations on this stream or other streams.
SunOS 5.5 Devices le ( 7D ) Under either of these two conditions the host translates the lack of link pulses into a link failure unless it is programmed to ignore link pulses. To program your system to ignore link pulses (also known as disabling the link test) do the following at the OpenBoot PROM prompt: <#0> ok setenv tpe-link-test? false tpe-link-test? = false The above command will work for SPARCstation-10, SPARCstation-20 and SPARCclassic systems that come with built in twisted pair Ethernet ports.
leo ( 7D ) Devices NAME DESCRIPTION FILES SEE ALSO 7D-190 SunOS 5.5 leo − double-buffered 24-bit SBus color frame buffer and graphics accelerator leo (ZX) is a 24-bit SBus-based color frame buffer and graphics accelerator. The frame buffer consists of 96 video memory planes of 1280 × 1024 pixels, including 24-bit doublebuffering, 8 overlay planes, 24 z-buffer planes, 10 window ID planes, and 6 fast clear planes. Leo provides the standard frame buffer interface as defined in fbio(7I).
SunOS 5.5 Devices NAME SYNOPSIS llc1 ( 7D ) llc1 − Logical Link Control Protocol Class 1 Driver #include #include #include #include AVAILABILITY x86 DESCRIPTION The llc1 driver is a multi-threaded, loadable, clonable, STREAMS multiplexing driver supporting the connectionless Data Link Provider Interface, dlpi(7P), implementing IEEE 802.2 Logical Link Control Protocol Class 1 over a STREAM to a MAC level driver.
llc1 ( 7D ) Devices SunOS 5.5 The broadcast address value is the broadcast address returned from the lower level driver. Once in the DL_ATTACHED state, the user must send a DL_BIND_REQ to associate a particular Service Access Point (SAP) with the stream. The llc1 driver interprets the sap field within the DL_BIND_REQ as an IEEE 802.2 “SAP,” therefore valid values for the sap field are in the [0-0xFF] range with only even values being legal.
SunOS 5.5 Devices llc1 ( 7D ) XID and TEST will be automatically processed by llc1 if the DL_AUTO_XID/DL_AUTO_TEST bits are set in the DL_BIND_REQ.
lofs ( 7FS ) File Systems NAME SYNOPSIS SunOS 5.5 lofs − loopback virtual file system #include #include int mount(const char ∗dir, const char ∗virtual, int mflag, lofs , NULL , 0); DESCRIPTION The loopback file system device allows new, virtual file systems to be created, which provide access to existing files using alternate pathnames. Once the virtual file system is created, other file systems can be mounted within it, without affecting the original file system.
SunOS 5.5 Devices NAME SYNOPSIS DESCRIPTION Kernel Interface log ( 7D ) log − interface to STREAMS error logging and event tracing #include #include log is a STREAMS software device driver that provides an interface for console logging and for the STREAMS error logging and event tracing processes (see strerr(1M), and strace(1M)).
log ( 7D ) Devices SunOS 5.5 Each trace_ids structure specifies a mid, sid, and level from which messages will be accepted. strlog( ) will accept messages whose mid and sid exactly match those in the trace_ids structure, and whose level is less than or equal to the level given in the trace_ids structure. A value of −1 in any of the fields of the trace_ids structure indicates that any value is accepted for that field.
SunOS 5.5 Devices log ( 7D ) ENXIO is returned for I_TRCLOG ioctls without any trace_ids structures, or for any unrecognized ioctl calls. The driver silently ignores incorrectly formatted log messages sent to the driver by a user process (no error results). Processes that wish to write a message to the console logger may direct their output to /dev/conslog, using either write(2) or putmsg(2). EXAMPLES Example of I_ERRLOG registration: struct strioctl ioc; ioc.ic_cmd = I_ERRLOG; ioc.ic_timout = 0; ioc.
log ( 7D ) Devices SunOS 5.5 dat.buf = message; lc.level = 0; lc.
SunOS 5.5 Devices NAME SYNOPSIS logi ( 7D ) logi − LOGITECH Bus Mouse device interface /dev/logi AVAILABILITY x86 DESCRIPTION The logi driver supports the LOGITECH Bus Mouse. It allows applications to obtain information about the mouse’s movements and the status of its buttons. The data is read in the Five Byte Packed Binary Format, also called MSC format.
lp ( 7D ) Devices NAME SYNOPSIS SunOS 5.5 lp − driver for parallel port include fd = open("/dev/lpn", flags); name=lp class=sysbus ioaddr=0x378 interrupts=3,7; name=lp class=sysbus ioaddr=0x278 interrupts=3,5; AVAILABILITY x86 DESCRIPTION The lp driver provides the interface to the parallel ports used by printers for x86 systems. The lp driver is implemented as a STREAMS device. Up to three parallel ports can be accessed by the driver. The lp driver accesses the /kernel/drv/lp.
SunOS 5.5 Devices Error Pins Structure lp ( 7D ) This structure and symbols are defined in the include file
mcis ( 7D ) Devices NAME SunOS 5.5 mcis − low-level module for IBM MicroChannel host bus adapter AVAILABILITY x86 DESCRIPTION The mcis module provides low-level interface routines between the common disk/tape I/O subsystem and the IBM MicroChannel bus master SCSI (Small Computer System Interface) controllers. The mcis module can be configured for disk and streaming tape support for one or more host adapter boards, each of which must be the sole initiator on a SCSI bus.
SunOS 5.5 Devices NAME SYNOPSIS DESCRIPTION (PARALLEL PORT) mcpp ( 7D ) mcpp − ALM-2 Parallel Printer port driver #include #include open("/dev/mcppn", mode); The parallel port is Centronics-compatible and is suitable for most common parallel printers. Devices attached to this interface are normally handled by the line printer spooling system and should not be accessed directly by the user. The printer devices reside on a separate major device number from the serial devices.
mcpp ( 7D ) SEE ALSO DIAGNOSTICS Devices SunOS 5.5 open(2), write(2) Printer on mcppn is out of paper Printer on mcppn paper ok Assorted printer diagnostics, if enabled as discussed above.
SunOS 5.5 Devices NAME SYNOPSIS DESCRIPTION mcpzsa ( 7D ) mcpzsa − ALM-2 Zilog 8530 SCC serial communications driver #include #include open("/dev/term/n", mode); open("/dev/cua/n", mode); The ALM-2 board provides 16 serial input/output channels that are capable of supporting a variety of communication protocols. A typical system uses these devices to implement essential functions, including RS-423 ports (which also support most RS-232 equipment).
mcpzsa ( 7D ) Devices IOCTLS SunOS 5.5 The standard set of termio ioctl( ) calls are supported by mcpzsa. If the CRTSCTS flag in the c_cflag is set, output will be generated only if CTS is high; if CTS is low, output will be frozen. If the CRTSCTS flag is clear, the state of CTS has no effect. Breaks can be generated by the TCSBRK, TIOCSBRK, and TIOCCBRK ioctl( ) calls. The modem control lines TIOCM_CAR, TIOCM_CTS, TIOCM_RTS, and TIOCM_DTR are provided.
SunOS 5.5 Devices NAME SYNOPSIS DESCRIPTION mem ( 7D ) mem, kmem − physical or virtual memory /dev/mem /dev/kmem The file /dev/mem is a special file that is an image of the physical memory of the computer. The file /dev/kmem is a special file that is an image of the kernel virtual memory of the computer. Either may be used, for example, to examine, and even patch the system. Byte addresses in /dev/mem are interpreted as physical memory addresses.
mlx ( 7D ) Devices NAME SYNOPSIS SunOS 5.5 mlx − low-level module for Mylex DAC960 EISA and IBM DMC960 Micro Channel host bus adapter series /kernel/drv/mlx AVAILABILITY x86 DESCRIPTION The mlx module provides low-level interface routines between the common disk/tape I/O subsystem and the Mylex DAC960 and IBM DMC960 controllers. The DMC960 is also known as IBM SCSI-2 RAID and IBM SCSI-2 Fast/Wide Streaming RAID Adapter/A.
SunOS 5.5 Devices mlx ( 7D ) name="mlx" parent="eisa" interrupts=5,9,5,10,5,11,5,12,5,13,5,14,5,15 reg=0xS0XX,0,0 ioaddr=0xS0XX flow_control="dsngl" queue="qsort" disk="scdk" tape="sctp" tag_fctrl="adapt" tag_queue="qtag"; The ioaddr (I/O address) is 0x1000 times the EISA slot number plus the channel number in hex. Hence, channel 2 on slot 1 is at address 0x1002 and the virtual channel on slot 10 is at 0xa0ff.
mlx ( 7D ) Devices SunOS 5.
SunOS 5.5 Devices mlx ( 7D ) For the best start-up performance on a particular host, keep only the entries that correspond to the installed slots and comment out the other entries in the configuration file /kernel/drv/mlx.conf. In the following example, the controller is installed in slot 2, and the lines starting with ’#’ are comments.
mlx ( 7D ) Devices SunOS 5.
SunOS 5.5 Hot Plugging SCSI Target IDs Devices mlx ( 7D ) Other than the ‘‘hot replacement’’ of disk drives, which is described in the manufacturer’s user’s guide, the Mylex DAC960 series do not support ‘‘hot-plugging’’ (adding or removing devices while the system is running) unless the firmware version of the adapter is 1.22 or 1.23.
msm ( 7D ) Devices NAME SunOS 5.5 msm − Microsoft Bus Mouse device interface AVAILABILITY x86 DESCRIPTION The msm driver supports the Microsoft Bus Mouse. It allows applications to obtain information about the mouse’s movements and the status of its buttons. The data is read in the Five Byte Packed Binary Format, also called MSC format.
SunOS 5.5 Devices NAME DESCRIPTION mt ( 7D ) mt − tape interface The files rmt/∗∗ refer to tape controllers and associated tape drives. The labelit(1M) command requires these magnetic tape file names to work correctly with the tape controllers. No other tape controller commands require these file names.
mtio ( 7I ) Ioctl Requests NAME SYNOPSIS DESCRIPTION SunOS 5.5 mtio − general magnetic tape interface #include #include #include 1/2”, 1/4”, 4mm, and 8mm magnetic tape drives all share the same general character device interface. There are two types of tape records: data records and end-of-file (EOF) records. EOF records are also known as tape marks and file marks. A record is separated by interrecord (or tape) gaps on a tape.
SunOS 5.5 Ioctl Requests mtio ( 7I ) 4mm DAT Tape Data is recorded either in Digital Data Storage (DDS) tape format or in Digital Data Storage, Data Compressed (DDS-DC) tape format. Since it is a variable-length tape device, the number of bytes in a physical record may vary. The recording formats available are standard 2Gbyte and compressed format. Read Operation read(2) reads the next record on the tape.
mtio ( 7I ) Ioctl Requests SunOS 5.5 Fixed-length I/O tape devices write multiple records if the blocking factor is greater than 64,512 bytes (minphys limit). These multiple writes are limited to 64,512 bytes. For example, if a write request is issued for 65,536 bytes using a 1/4” cartridge tape, two writes are issued; the first for 64,512 bytes and the second for 1024 bytes. Most tape devices which support variable-length I/O operations may write a range of 1 to 65,535 bytes.
SunOS 5.5 Ioctl Requests mtio ( 7I ) If no data was written and the driver was opened for WRITE-ONLY access, one or two file marks are written, thus creating a null file. IOCTLS Not all devices support all ioctls. The driver returns an ENOTTY error on unsupported ioctls. The following structure definitions for magnetic tape ioctl commands are from
mtio ( 7I ) Ioctl Requests SunOS 5.5 MTRETEN retension the tape (cartridge tape only) MTERASE erase the entire tape and rewind MTEOM position to EOM MTNBSF backward space file to beginning of file MTSRSZ set record size MTGRSZ get record size MTLOAD load the next tape cartridge into the tape drive.
SunOS 5.5 Ioctl Requests mtio ( 7I ) MTBSR and MTFSR operations perform much like space file operations, except that they move by records instead of files. Variable-length I/O devices (1/2” reel, for example) space actual records; fixed-length I/O devices space physical records (blocks). 1/4” cartridge tape, for example, spaces 512 byte physical records. The status ioctl residual count contains the number of files or records not skipped.
mtio ( 7I ) Ioctl Requests SunOS 5.5 mt −f /dev/rmt/0ln bsf 3 mt −f /dev/rmt/0ln fsf 1 dd if=/dev/rmt/0ln To accomplish the same tape positioning in a C program, followed by a get status ioctl: struct mtop mt_command; struct mtget mt_status; mt_command.mt_op = MTBSF; mt_command.mt_count = 3; ioctl(fd, MTIOCTOP, &mt_command); mt_command.mt_op = MTFSF; mt_command.mt_count = 1; ioctl(fd, MTIOCTOP, &mt_command); ioctl(fd, MTIOCGET, (char ∗)&mt_status); or mt_command.mt_op = MTNBSF; mt_command.
SunOS 5.5 Devices NAME SYNOPSIS AVAILABILITY DESCRIPTION ncrs ( 7D ) ncrs − low-level module for NCR 53C710, 53C810, 53C815, 53C820, and 53C825 host bus adapters ncrs@ioaddr,0 x86 The ncrs module provides low-level interface routines between the common disk/tape I/O subsystem and the NCR 53C710, 53C810, 53C815, 53C820, and 53C825 SCSI (Small Computer System Interface) controllers. The ncrs module can be configured for disk and streaming tape support for one or more host bus adapter boards.
ncrs ( 7D ) Devices SunOS 5.5 each of the targets starting with target 0. The following values are accepted: 10.0, 10, 6.67, 6.66, 5.0, 5, 4.0, 4, 3.33, 3.3, and 0. If any other value is specified or if 0 is specified for a target, the adapter will operate in Asynchronous I/O mode for that particular target. For example, the entry max-sync-rate="10,10,10,10,10,10,10" specifies a maximum synchronous I/O rate of 10 for all targets. This is the default.
SunOS 5.5 Devices NAME SYNOPSIS nee ( 7D ) nee − Novell NE3200 Ethernet device Driver #include #include #include AVAILABILITY x86 DESCRIPTION The nee Ethernet driver is a multi-threaded, loadable, clonable, STREAMS hardware driver supporting the connectionless Data Link Provider Interface, dlpi(7P), over Novell NE3200 controllers. Multiple EtherLink 16 controllers installed within the system are supported by the driver.
nee ( 7D ) Devices SunOS 5.5 (FF:FF:FF:FF:FF:FF). Once in the DL_ATTACHED state, the user must send a DL_BIND_REQ to associate a particular Service Access Pointer (SAP) with the stream. The nee driver interprets the sap field within the DL_BIND_REQ as an Ethernet “type;” therefore valid values for the sap field are in the [0-0xFFFF] range. Only one Ethernet type can be bound to the stream at any time. In addition to Ethernet V2 service, an “802.3 mode” is also provided by the driver.
SunOS 5.5 Devices nee ( 7D ) When used with the DL_PROMISC_SAP flag set, this enables/disables reception of all sap (Ethernet type) values. When used with the DL_PROMISC_MULTI flag set, this enables/disables reception of all multicast group addresses. The effect of each is always on a per-stream basis and independent of the other sap and physical level configurations on this stream or other streams.
nei ( 7D ) Devices NAME SYNOPSIS SunOS 5.5 nei − Novell NE2000, NE2000plus Ethernet device Driver /dev/nei AVAILABILITY x86 DESCRIPTION The nei Ethernet driver is a multi-threaded, loadable, clonable, STREAMS hardware driver supporting the connectionless Data Link Provider Interface, dlpi(7P), over Novell NE2000 and NE2000plus controllers. The nei driver provides basic support for the NE2000 and NE2000plus hardware.
SunOS 5.5 Devices · nei ( 7D ) The broadcast address value is Ethernet/IEEE broadcast address (FF:FF:FF:FF:FF:FF). Once in the DL_ATTACHED state, the user must send a DL_BIND_REQ to associate a particular Service Access Pointer (SAP) with the stream. The nei driver interprets the sap field within the DL_BIND_REQ as an Ethernet “type;” therefore valid values for the sap field are in the [0-0xFFFF] range. Only one Ethernet type can be bound to the stream at any time.
nei ( 7D ) Devices SunOS 5.5 When used with the DL_PROMISC_SAP flag set, this enables/disables reception of all sap (Ethernet type) values. When used with the DL_PROMISC_MULTI flag set, this enables/disables reception of all multicast group addresses. The effect of each is always on a per-stream basis and independent of the other sap and physical level configurations on this stream or other streams.
SunOS 5.5 Devices NAME SYNOPSIS nfe ( 7D ) nfe − Compaq Netflex-2 Dualport Ethernet and ENET/TR Drivers /dev/nfe AVAILABILITY x86 DESCRIPTION The nfe Ethernet driver is a multi-threaded, loadable, clonable, STREAMS hardware driver supporting the connectionless Data Link Provider Interface, dlpi(7P), over Compaq Netflex-2 controllers. Multiple Netflex-2 controllers installed within the system are supported by the driver. The nfe driver provides basic support for the Netflex-2 hardware.
nfe ( 7D ) Devices SunOS 5.5 Once in the DL_ATTACHED state, the user must send a DL_BIND_REQ to associate a particular Service Access Pointer (SAP) with the stream. The nfe driver interprets the sap field within the DL_BIND_REQ as an Ethernet “type;” therefore valid values for the sap field are in the [0-0xFFFF] range. Only one Ethernet type can be bound to the stream at any time. In addition to Ethernet V2 service, an “802.3 mode” is also provided by the driver.
SunOS 5.5 Devices nfe ( 7D ) DL_PROMISC_MULTI flag set, this enables/disables reception of all multicast group addresses. The effect of each is always on a per-stream basis and independent of the other sap and physical level configurations on this stream or other streams. The DL_PHYS_ADDR_REQ primitive returns the 6-octet Ethernet address currently associated (attached) to the stream in the DL_PHYS_ADDR_ACK primitive. This primitive is valid only in states following a successful DL_ATTACH_REQ.
null ( 7D ) Devices NAME SYNOPSIS DESCRIPTION SunOS 5.5 null − the null file /dev/null Data written on the null special file, /dev/null, is discarded. Reads from a null special file always return 0 bytes.
SunOS 5.5 Devices NAME SYNOPSIS openprom ( 7D ) openprom − PROM monitor configuration interface #include #include #include open("/dev/openprom", mode); DESCRIPTION The internal encoding of the configuration information stored in EEPROM or NVRAM varies from model to model, and on some systems the encoding is “hidden” by the firmware.
openprom ( 7D ) Devices SunOS 5.5 OPROMNXT, OPROMCHILD, OPROMGETPROP, and OPROMNXTPROP These ioctls provide an interface to the raw config_ops operations in the PROM monitor. One can use them to traverse the system device tree; see prtconf(1M). OPROMGETVERSION ERRORS EXAMPLES This ioctl returns an arbitrary and platform-dependent NULL-terminated string in oprom_array, representing the underlying version of the firmware. EAGAIN There are too many opens of the /dev/openprom device.
SunOS 5.5 Devices openprom ( 7D ) ∗ Get the peer node of the given node. The root node is the peer of zero. ∗ After changing nodes, property lookups apply to that node. The driver ∗ ’remembers’ what node you are in. ∗/ static int peer(int nodeid, int fd) { Oppbuf oppbuf; struct openpromio ∗opp = &(oppbuf.opp); int ∗ip = (int ∗)(opp->oprom_array); (void) memset(oppbuf.
openprom ( 7D ) Devices SunOS 5.5 } if (opp->oprom_size != 0) printf("Platform name <%s>\n", opp->oprom_array); /∗ ∗ Get and print the prom version.
SunOS 5.5 Devices NAME SYNOPSIS DESCRIPTION pcelx ( 7D ) pcelx − 3COM EtherLink III PCMCIA Ethernet Adapter pcelx@:pcelx The pcelx driver supports the 3COM EtherLink III PCMCIA PC Card as a standard Ethernet type of device conforming to the DLPI interface specification. The driver supports the hot-plugging of the PC Card. The PPA (Physical Point of Attachment) is defined by the socket number the card is inserted in.
pcfs ( 7FS ) File Systems NAME DESCRIPTION SunOS 5.5 pcfs, PCFS − DOS formatted file system PCFS is a file system type that allows users direct access to files on DOS formatted disks from within the SunOS operating system. Once mounted, a PCFS file system provides standard SunOS file operations and semantics. That is, users can create, delete, read, and write files on an DOS formatted disk. They can also create and delete directories and list files in a directory.
SunOS 5.5 File Systems pcfs ( 7FS ) To mount a PCMCIA pseudo-floppy memory card, use: mount −F pcfs /dev/dsk/cNtNdNsN /pcfs Conventions Files and directories created through PCFS have to comply with the DOS file name convention, which is of the form filename[.ext], where filename consists of from one to eight upper-case characters, while the optional ext consists of from one to three upper-case characters.
pcfs ( 7FS ) File Systems SunOS 5.5 in PCFS. PCFS has no provision for handling owner-ID’s or group-ID’s on files. You may experi- ence various errors coming from chown(1) or chgrp(1). This is not a problem. It is a limitation of PCFS.
SunOS 5.5 Devices NAME DESCRIPTION pcic ( 7D ) pcic − Intel i82365SL PC Card Interface Controller The Intel i82365SL PC Card Interface Controller provides one or more PCMCIA PC Card sockets. The pcic adapter driver provides an interface between the PCMCIA sockets and the PCMCIA nexus. The driver supports the Intel 82365SL chip and a number of chips from other vendors based on the 82365SL design.
pcic ( 7D ) Devices FILES SEE ALSO 7D-244 /kernel/drv/pcic /kernel/drv/pcic.conf SunOS 5.
SunOS 5.5 STREAMS Modules NAME SYNOPSIS DESCRIPTION pckt ( 7M ) pckt − STREAMS Packet Mode module int ioctl( fd, I_PUSH, "pckt"); pckt is a STREAMS module that may be used with a pseudo terminal to packetize certain messages. The pckt module should be pushed (see I_PUSH on streamio(7I)) onto the master side of a pseudo terminal. Packetizing is performed by prefixing a message with an M_PROTO message. The original message type is stored in the 1 byte data portion of the M_PROTO message.
pcmem ( 7D ) Devices NAME DESCRIPTION SunOS 5.5 pcmem − PCMCIA memory card nexus driver The pcmem driver identifies the type of memory card in the system and will allow future support of other memory device types. The PCMCIA memory card nexus driver supports PCMCIA memory card client drivers. There are no user-configurable options for this driver.
SunOS 5.5 Devices NAME SYNOPSIS pcn ( 7D ) pcn − AMD PCnet Ethernet controller device driver /dev/pcn AVAILABILITY x86 DESCRIPTION The pcn Ethernet driver is a multi-threaded, loadable, clonable driver for the AMD PCnet family of Ethernet controllers that use the Generic LAN Driver (GLD) facility to implement the required STREAMS and Data Link Provider (see dlpi(7P)) interfaces.
pcn ( 7D ) Devices SunOS 5.5 Once in the DL_ATTACHED state, the user must send a DL_BIND_REQ to associate a particular Service Access Point (SAP) with the stream. FILES SEE ALSO /dev/pcn character special device /kernel/drv/pcn.
SunOS 5.5 Devices NAME SYNOPSIS DESCRIPTION FILES SEE ALSO modified 20 Mar 1995 pcram ( 7D ) pcram − PCMCIA RAM memory card device driver pcmem@/pcram@,0:c pcmem@/pcram@,0:c,raw The PCMCIA RAM memory card device driver supports disk-like I/O access to any standard PCMCIA static random access memory (SRAM) card and dynamic random access memory (DRAM) card. The driver supports standard PCMCIA SRAM/DRAM cards that contain a Card Information Structure (CIS).
pcscsi ( 7D ) Devices NAME SYNOPSIS SunOS 5.5 pcscsi − low-level module for the AMD PCscsi, PCscsi II, and PCnet-SCSI PCI-to-SCSI bus adapters pcscsi@ioaddr,0 AVAILABILITY x86 DESCRIPTION The pcscsi module provides low-level interface routines between the common disk/tape I/O subsystem and the Am53C974 (PCscsi), Am53C974A (PCscsi II), and Am79C974 (PCnet-SCSI) Small Computer System Interface (SCSI) controllers.
SunOS 5.5 Devices NAME SYNOPSIS DESCRIPTION pcser ( 7D ) pcser − PCMCIA serial card device driver pcser@:pcser pcser@:pcser,cu The PCMCIA serial card device driver supports asynchronous serial I/O access to any PCMCIA card that that complies with Revision 2.1 of the PCMCIA Standard and which presents an 8250-type UART interface.
pe ( 7D ) Devices NAME SYNOPSIS SunOS 5.5 pe − Xircom Pocket Ethernet device driver #include #include #include AVAILABILITY x86 DESCRIPTION The Xircom Pocket Ethernet driver (pe) is a multi-threaded, loadable, clonable, STREAMS hardware driver supporting the connectionless Data Link Provider Interface, dlpi(7P), with a Xircom Pocket Ethernet Adapter III (PE3). Multiple PE3 controllers installed within the system are supported by the driver.
SunOS 5.5 Devices pe ( 7D ) · No optional quality of service (QOS) support is included at present, so the QOS fields are 0. · The provider style is DL_STYLE2. · The version is DL_VERSION_2. · The broadcast address value is Ethernet/IEEE broadcast address (FF:FF:FF:FF:FF:FF). Once in the DL_ATTACHED state, the user must send a DL_BIND_REQ to associate a particular SAP (Service Access Pointer) with the stream.
pe ( 7D ) Devices SunOS 5.5 primitives are accepted by the driver in any state following DL_ATTACHED. The DL_PROMISCON_REQ and DL_PROMISCOFF_REQ primitives with the DL_PROMISC_PHYS flag set in the dl_level field enables/disables reception of all (“promiscuous mode”) frames on the media including frames generated by the local host. When used with the DL_PROMISC_SAP flag set, this enables/disables reception of all sap (Ethernet type) values.
SunOS 5.5 STREAMS Modules NAME SYNOPSIS pfmod ( 7M ) pfmod − STREAMS Packet Filter Module #include ioctl( fd, I_PUSH, "pfmod"); DESCRIPTION Read-side Behavior pfmod is a STREAMS module that subjects messages arriving on its read queue to a packet filter and passes only those messages that the filter accepts on to its upstream neighbor.
pfmod ( 7M ) STREAMS Modules SunOS 5.5 commands and their semantics. PACKET FILTERS A packet filter consists of the filter command list length (in units of u_shorts), and the filter command list itself. (The priority field mentioned above is ignored in this implementation.) Each filter command list specifies a sequence of actions that operate on an internal stack of u_shorts (“shortwords”).
SunOS 5.5 STREAMS Modules pfmod ( 7M ) will route received packets upstream. Refer to the DLPI Version 2 specification for details on this interface. The reverse ARP daemon program may use code similar to the following fragment to construct a filter that rejects all but RARP packets. That is, is accepts only packets whose Ethernet type field has the value ETHERTYPE_REVARP. struct ether_header eh; /∗ used only for offset values ∗/ struct packetfilt pf; register u_short ∗fwp = pf.
pipemod ( 7M ) NAME DESCRIPTION STREAMS Modules SunOS 5.5 pipemod − STREAMS pipe flushing module The typical stream is composed of a stream head connected to modules and terminated by a driver. Some stream configurations such as pipes and FIFOs do not have a driver and hence certain features commonly supported by the driver need to be provided by other means. Flushing is one such feature, and it is provided by the pipemod module. Pipes and FIFOs in their simplest configurations only have stream heads.
SunOS 5.5 Devices NAME SYNOPSIS DESCRIPTION pln ( 7D ) pln − SPARCstorage Array SCSI Host Bus Adapter Driver pln@SUNW,pln@a0000800,200611b9 The pln Host Bus Adapter (HBA) driver is a SCSA compliant nexus driver which supports the SPARC Storage Array. The SPARC Storage Array is a disk array device which supports 30 disk drives. The drives are located on six SCSI busses within the SPARC Storage Array. A SPARC microprocessor controls the SPARC Storage Array. Non-volatile RAM is used as a disk cache.
ppp ( 7M ) STREAMS Modules NAME SunOS 5.5 ppp, ppp_diag, ipd, ipdptp, ipdcm − STREAMS modules and drivers for the Point-toPoint Protocol AVAILABILITY SUNWpppk DESCRIPTION ppp is a STREAMS module which implements the Point to Point Protocol (PPP). PPP is a datalink protocol which provides a method for transmitting datagrams over serial pointto-point links.
SunOS 5.5 STREAMS Modules ppp ( 7M ) When the ppp module and serial device have been linked underneath the IP-dialup interface, IP packets are sent and received over the point-to-point link in PPP frames. FILES SEE ALSO modified 18 Feb 1994 /dev/ipd pseudo device driver that provides point-to-ipoint interface. /dev/ipdptp pseudo device driver that provides point-to-multipoint interface. /dev/ipdcm pseudo device driver that provides interface between ipd and ipdptp and link manager.
ptem ( 7M ) STREAMS Modules NAME SYNOPSIS DESCRIPTION SunOS 5.5 ptem − STREAMS Pseudo Terminal Emulation module int ioctl( fd, I_PUSH, "ptem"); ptem is a STREAMS module that, when used in conjunction with a line discipline and pseudo terminal driver, emulates a terminal. The ptem module must be pushed (see I_PUSH, streamio(7I)) onto the slave side of a pseudo terminal STREAM, before the ldterm(7M) module is pushed.
SunOS 5.5 Devices NAME DESCRIPTION ptm ( 7D ) ptm − STREAMS pseudo-tty master driver The pseudo-tty subsystem simulates a terminal connection, where the master side represents the terminal and the slave represents the user process’s special device end point. In order to use the pseudo-tty subsystem, a node for the master side driver /dev/ptmx and N number of nodes for the slave driver must be installed. See pts(7D).
ptm ( 7D ) Devices FILES SEE ALSO /dev/ptmx /dev/pts/M SunOS 5.
SunOS 5.5 Devices NAME DESCRIPTION pts ( 7D ) pts − STREAMS pseudo-tty slave driver The pseudo-tty subsystem simulates a terminal connection, where the master side represents the terminal and the slave represents the user process’s special device end point. In order to use the pseudo-tty subsystem, a node for the master side driver /dev/ptmx and N nodes for the slave driver (N is determined at installation time) must be installed.
pts ( 7D ) Devices slavename = ptsname(fdm); fds = open(slavename, O_RDWR); ioctl(fds, I_PUSH, "ptem"); ioctl(fds, I_PUSH, "ldterm"); FILES SEE ALSO /dev/ptmx /dev/pts/M SunOS 5.
SunOS 5.5 Devices NAME DESCRIPTION pty ( 7D ) pty − pseudo-terminal driver The pty driver provides support for a pair of devices collectively known as a pseudoterminal. The two devices comprising a pseudo-terminal are known as a controller and a slave. The slave device distinguishes between the B0 baud rate and other baud rates specified in the c_cflag word of the termios structure, and the CLOCAL flag in that word.
pty ( 7D ) Devices SunOS 5.5 A few special ioctls are provided on the controller devices of pseudo-terminals to provide the functionality needed by applications programs to emulate real hardware interfaces: TIOCSTOP The argument is ignored. Output to the pseudo-terminal is suspended, as if a STOP character had been typed. TIOCSTART The argument is ignored. Output to the pseudo-terminal is restarted, as if a START character had been typed. TIOCPKT The argument is a pointer to an int.
SunOS 5.5 Devices pty ( 7D ) write( ), it would appear to a process reading from the slave as if a single line containing several NEWLINE characters had been typed (as if, for example, a user had typed the LNEXT character before typing all but the last of those NEWLINE characters). Remote mode can be used when doing remote line editing in a window manager, or whenever flow controlled input is required. EXAMPLES #include #include
qe ( 7D ) Devices NAME SYNOPSIS DESCRIPTION SunOS 5.5 qe − QEC/MACE Ethernet device driver #include #include #include #include qe is a multi-threaded, loadable, clonable, STREAMS hardware device driver supporting the connectionless Data Link Provider Interface, dlpi(7P), over Am79C940 (MACE) Ethernet controllers in the SBus QED card. qec(7D) is its parent in the Open Boot Prom device tree. There is no fixed limitation on the number of QED cards supported by the driver.
SunOS 5.5 Devices qe ( 7D ) Once in the DL_ATTACHED state, the user must send a DL_BIND_REQ to associate a particular SAP (Service Access Pointer) with the stream. The qe driver interprets the sap field within the DL_BIND_REQ as an Ethernet “type” therefore valid values for the sap field are in the [0-0xFFFF] range. Only one Ethernet type can be bound to the stream at any time. If the user selects a sap with a value of 0, the receiver will be in 802.3 mode.
qe ( 7D ) Devices SunOS 5.5 The DL_PROMISCON_REQ and DL_PROMISCOFF_REQ primitives with the DL_PROMISC_PHYS flag set in the dl_level field enables/disables reception of all (“promiscuous mode”) frames on the media including frames generated by the local host. When used with the DL_PROMISC_SAP flag set this enables/disables reception of all sap (Ethernet type) values. When used with the DL_PROMISC_MULTI flag set this enables/disables reception of all multicast group addresses.
SunOS 5.5 Devices NAME DESCRIPTION SEE ALSO modified 3 March 1993 qec ( 7D ) qec − QEC bus nexus device driver The qec device driver is a bus nexus driver which provides basic support for the QEC hardware. It is the parent of the qe(7D) leaf driver. The driver supports multiple QED SBus cards installed within the system. It is not directly accessible to the user.
quotactl ( 7I ) Ioctl Requests NAME SYNOPSIS SunOS 5.5 quotactl − manipulate disk quotas #include int ioctl(int fd, Q_QUOTACTL, struct quotactl ∗qp) DESCRIPTION This ioctl( ) call manipulates disk quotas. fd is the file descriptor returned by the open( ) system call after opening the quotas file (located in the root directory of the filesystem running quotas.) Q_QUOTACTL is defined in /usr/include/sys/fs/ufs_quota.h.
SunOS 5.5 Ioctl Requests ERRORS EFAULT addr is invalid. EINVAL The kernel has not been compiled with the QUOTA option. op is invalid. ENOENT The quotas file specified by addr does not exist. EPERM The call is privileged and the caller was not the super-user. ESRCH No disk quota is found for the indicated user. Quotas have not been turned on for this file system. EUSERS The quota table is full.
riles ( 7D ) Devices NAME SYNOPSIS SunOS 5.5 riles − device driver for the Racal Interlan ES-3210 Ethernet Adapter /dev/riles AVAILABILITY x86 DESCRIPTION The riles Ethernet driver is a multi-threaded, loadable, gld (Generic LAN Driver) compliant, clonable, STREAMS hardware driver that supports the connectionless service mode of the Data Link Provider Interface, dlpi(7P), over a Racal Interlan ES-3210 (ES-3210) controller. The driver can support multiple ES-3210 controllers on the same system.
SunOS 5.5 Devices riles ( 7D ) Once in the DL_ATTACHED state, the user must send a DL_BIND_REQ to associate a particular SAP (Service Access Point) with the stream. CONFIGURATION riles.conf is the configuration file for the riles device driver. The riles.conf file should contain the following properties. intr This specifies the spl level and the IRQ level for which the board has been configured reg A list of sets where each set contains 3 values specifying the entry number in the riles.
riles ( 7D ) Devices SunOS 5.5 riles%d: no match for board irq in riles.conf (attach failed) No match was found between the configured IRQ value of the board and the value(s) of the intr property in the riles.conf file. riles: cannot map RAM address(attach failed) The driver cannot map the configured RAM address to kernel space. The driver does not get loaded.
SunOS 5.5 Devices riles ( 7D ) riles%d: serious NIC error (RST set) The reset bit was set in the network interface controller’s interrupt status register. riles%d: board in slot %d failed-- resetting The ES-3210 hardware has failed and is being reset in an attempt to bring it up. riles%d: lost carrier (cable or transceiver problem?) This indicates that the transceiver/cable is faulty or improperly connected to the board.
sad ( 7D ) Devices NAME SYNOPSIS SunOS 5.5 sad − STREAMS Administrative Driver #include #include #include #include int ioctl ( int fildes, int command, int arg); DESCRIPTION The STREAMS Administrative Driver provides an interface for applications to perform administrative operations on STREAMS modules and drivers. The interface is provided through ioctl(2) commands. Privileged operations may access the sad driver using /dev/sad/admin.
SunOS 5.5 Devices sad ( 7D ) be automatically pushed when the device is opened. It must be less than or equal to MAXAPUSH , defined in sad.h. It must also be less than or equal to NSTRPUSH, the maximum number of modules that can be pushed on a stream, defined in the kernel master file. The field sap_list is an array of NULL-terminated module names to be pushed in the order in which they appear in the list. When using the SAP_CLEAR command, the user sets only sap_major and sap_minor.
sad ( 7D ) Devices SunOS 5.5 installed on the system). arg is a pointer to a str_list structure with the following members: int struct str_mlist sl_nmods; ∗sl_modlist; The str_mlist structure has the following member: char l_name[FMNAMESZ+1]; sl_nmods indicates the number of entries the user has allocated in the array and sl_modlist points to the array of module names. The return value is 0 if the list is valid, 1 if the list contains an invalid module name, or −1 on failure.
SunOS 5.5 Devices NAME SYNOPSIS sbpro ( 7D ) sbpro − Sound Blaster Pro, Sound Blaster 16, and Sound Blaster AWE32 audio device driver sbpro:sound,sbpro sbpro:sound,sbproctl AVAILABILITY x86 DESCRIPTION The Creative Labs Sound Blaster family of audio cards comprises DMA-capable ISA bus plug-in cards that provide 8 and 16 bit mono and stereo digitized sound recording and playback over a wide range of sampling rates. Each card includes a digital sound processor and mixing capability.
sbpro ( 7D ) Devices SunOS 5.5 within approximately three-fourths of the full dynamic range. Audio Ports The Sound Blaster hardware does not support multiple output devices, so the play.port field of the audio information structure only supports AUDIO_HEADPHONE. Output volume is controlled by software. There is a volume control thumbwheel on the back of the card which should be turned all the way up to maximum; otherwise no sound may be audible. The record.
SunOS 5.5 Devices NAME SYNOPSIS DESCRIPTION sd ( 7D ) sd − driver for SCSI disk and CD-ROM devices sd@target,lun:partition This driver handles embedded SCSI-2 and CCS-compatible SCSI disk drives, CD-ROM drives, and the Emulex MD21 disk controller for ESDI drives. The type of disk drive is determined using the SCSI inquiry command and reading the volume label stored on block 0 of the drive.
sd ( 7D ) Devices ENXIO During opening, the device did not exist. EROFS The device is a read-only device. SunOS 5.5 CONFIGURATION Driver Configuration FILES The sd driver can be configured by defining properties in sd.conf file. Following are the supported properties: qfull-retries The supplied value is passed as the qfull-retries capability value of the HBA driver. See scsi_ifsetcap(9F) for details.
SunOS 5.5 Devices sd ( 7D ) Not enough sense information The request sense data was less than expected. Request Sense couldn’t get sense data The REQUEST SENSE cmd did not transfer any data. Reservation Conflict The drive was reserved by another initiator. SCSI transport failed: reason ’xxxx’ : {retrying|giving up} The host adapter has failed to transport a command to the target for the reason stated. The driver will either retry the command or, ultimately, give up.
sd ( 7D ) Devices SunOS 5.5 no memory for disk label Free memory pool exhausted. no resources for dumping A packet could not be allocated during dumping. offline Drive went offline; probably powered down. requeue of command fails Driver attempted to retry a command and experienced a transport error. sdrestart transport failed () Driver attempted to retry a command and experienced a transport error. transfer length not modulo Illegal request size.
SunOS 5.5 Devices NAME SYNOPSIS smc ( 7D ) smc − SMC 8003/8013/8216/8416 Ethernet device driver /dev/smc AVAILABILITY x86 DESCRIPTION The SMC 8003/8013/8216/8416 Ethernet driver is a multi-threaded, loadable, clonable, STREAMS hardware driver supporting the connectionless Data Link Provider Interface, dlpi(7P), over an SMC 80X3/8216/8416 Ethernet controller. Multiple SMC controllers installed within the system are supported by the driver. The smc driver provides basic support for the SMC hardware.
smc ( 7D ) Devices SunOS 5.5 Once in the DL_ATTACHED state, the user must send a DL_BIND_REQ to associate a particular SAP (Service Access Pointer) with the stream. The smc driver interprets the sap field within the DL_BIND_REQ as an Ethernet “type.” Therefore valid values for the sap field are in the [0-0xFFFF] range. Only one Ethernet “type” can be bound to the stream at any time. In addition to Ethernet V2 service, an “802.3 mode” is provided by the driver and works as follows.
SunOS 5.5 Devices smc ( 7D ) When used with the DL_PROMISC_SAP flag set, this enables/disables reception of all sap (Ethernet type) values. When used with the DL_PROMISC_MULTI flag set, this enables/disables reception of all multicast group addresses. The effect of each is always on a per-stream basis and independent of the other sap and physical level configurations on this stream or other streams.
smce ( 7D ) Devices NAME SYNOPSIS SunOS 5.5 smce − SMC 3032/EISA dual-channel Ethernet device driver #include #include #include AVAILABILITY x86 DESCRIPTION The smce Ethernet driver is a multi-threaded, loadable, clonable, STREAMS hardware driver supporting the connectionless Data Link Provider Interface, dlpi(7P), over the SMC 3032/EISA dual-channel Ethernet controllers. Each dual-channel 3032/EISA controller can support two subnetworks.
SunOS 5.5 Devices smce ( 7D ) QOS fields are 0. · The provider style is DL_STYLE2. · The version is DL_VERSION_2. · The broadcast address value is Ethernet/IEEE broadcast address (FF:FF:FF:FF:FF:FF). Once in the DL_ATTACHED state, the user must send a DL_BIND_REQ to associate a particular Service Access Pointer (SAP) with the stream. The smce driver interprets the sap field within the DL_BIND_REQ as an Ethernet “type;” therefore valid values for the sap field are in the [0-0xFFFF] range.
smce ( 7D ) Devices SunOS 5.5 The DL_PROMISCON_REQ and DL_PROMISCOFF_REQ primitives with the DL_PROMISC_PHYS flag set in the dl_level field enables/disables reception of all “promiscuous mode” frames on the media including frames generated by the local host. When used with the DL_PROMISC_SAP flag set, this enables/disables reception of all sap (Ethernet type) values. When used with the DL_PROMISC_MULTI flag set, this enables/disables reception of all multicast group addresses.
SunOS 5.5 Devices NAME SYNOPSIS smceu ( 7D ) smceu − SMC Elite32 Ultra (8232) Ethernet device driver #include #include #include #include AVAILABILITY x86 DESCRIPTION The smceu Ethernet driver is a multi-threaded, loadable, clonable, STREAMS hardware driver supporting the connectionless Data Link Provider Interface over an SMC Elite32 Ultra (8232) EISA-bus adapter.
smceu ( 7D ) SEE ALSO Devices SunOS 5.
SunOS 5.5 Devices NAME SYNOPSIS smcf ( 7D ) smcf − SMC Ether100 (9232) Ethernet device driver #include #include #include #include AVAILABILITY x86 DESCRIPTION The smcf Ethernet driver is a multi-threaded, loadable, clonable, STREAMS hardware driver supporting the connectionless Data Link Provider Interface over an SMC Ether100 (9232) Fast Ethernet EISA-bus adapter.
smcf ( 7D ) Devices FILES SEE ALSO /dev/smcf /kernel/drv/smcf /kernel/drv/smcf.conf SunOS 5.
SunOS 5.5 Devices NAME SYNOPSIS DESCRIPTION soc ( 7D ) soc − Serial Optical Controller (SOC) device driver soc@sbus-slot,0 The Fibre Channel Host Bus Adapter is an SBus card which implements two full duplex Fibre Channel interfaces. Each Fibre Channel interface supports a point to point interface to another Fibre Channel device. The soc device driver is a nexus driver. The soc driver implements portions of the FC-2 and FC-4 layers of the Fibre Channel.
soc ( 7D ) Devices SunOS 5.5 attach failed: unable to access status register Driver was unable to map device registers; check for bad hardware. Driver did not attach to device, devices will be inaccessible. attach failed: unable to install interrupt handler Driver was not able to add the interrupt routine to the kernel. Driver did not attach to device, devices will be inaccessible.
SunOS 5.5 Ioctl Requests NAME SYNOPSIS DESCRIPTION SEE ALSO modified 3 Jul 1990 sockio ( 7I ) sockio − ioctls that operate directly on sockets #include The IOCTLs listed in this manual page apply directly to sockets, independent of any underlying protocol. The setsockopt() call (see getsockopt(3N)) is the primary method for operating on sockets, rather than on the underlying protocol or network interface.
ssd ( 7D ) Devices NAME SYNOPSIS DESCRIPTION SunOS 5.5 ssd − driver for SPARCstorage Array disk devices ssd@port,target:partition This driver handles SCSI-2 disks in the SPARCstorage Array. The SPARCstorage Array currently supports fixed media disk drives. The specific type of each disk in the SPARCstorage Array is determined by the SCSI inquiry command and reading the volume label stored on block 0 of the drive.
SunOS 5.5 Devices where: cn tn dn sn SEE ALSO ssd ( 7D ) is the controller number on the system. Each SPARCstorage Array will have a unique controller number port number within the SPARCstorage Array n SCSI target n partition n format(1M), ioctl(2), lseek(2), read(2), write(2), driver.
st ( 7D ) Devices NAME SYNOPSIS DESCRIPTION SunOS 5.5 st − driver for SCSI tape devices st@target,lun:[l,m,h,c,u][b][n] The st device driver is an interface to various SCSI tape devices. Supported tape devices include 1/4” Tandberg 2.5 Gigabyte QIC tape drive, 1/4” Archive Viper QIC-150 streaming tape drive, 1/4” Emulex MT-02 tape controller, HP-88780 1/2” tape drive, Exabyte EXB-8200/8500/8505/8505XL 8mm cartridge tape, and the Archive Python 4 mm DAT tape subsystem.
SunOS 5.5 Devices st ( 7D ) Note that a semicolon (;) is used to terminate a prototype devinfo node specification. Individual elements listed within the specification should not be separated by a semicolon. Refer to driver.conf(4) for more information. is the string that is returned by the tape device on a SCSI inquiry command. This string may contain any character in the range 0x20-0x7e.
st ( 7D ) Devices SunOS 5.5 ST_VARIABLE The flag indicates the tape device supports variable length record sizes. ST_QIC The flag indicates a Quarter Inch Cartridge (QIC) tape device. ST_REEL The flag indicates a 1/2−inch reel tape device. ST_BSF If flag is set, the device supports backspace over EOF marks (bsf - see mt(1)). ST_BSR If flag is set, the tape device supports the backspace record operation (bsr - see mt(1)).
SunOS 5.5 Devices st ( 7D ) ST_BUFFERED_WRITES If the flag is set, when data is written to the tape device, the data is buffered by the driver. The application may receive acknowledgement of completion of the write request before the data has been written to tape. ST_NO_RECSIZE_LIMIT (SPARC Only) The flag applies to variable-length tape devices. If this flag is set, the record size is not limited to a 64 Kbyte record size.
st ( 7D ) Devices ERRORS EXAMPLES SunOS 5.5 EACCES The driver is opened for write access and the tape is write protected. EBUSY The tape drive is in use by another process. Only one process can use the tape drive at a time. The driver will allow a grace period for the other process to finish before reporting this error. EINVAL The number of bytes read or written is not a multiple of the physical record size (fixed-length tape devices only).
SunOS 5.5 Devices st ( 7D ) target=1 lun=0; name="st" class="scsi" target=2 lun=0 tape-config-list = "Magic DAT", "Magic 4mm Helical Scan", "magic-data" magic-data = 1,0x34,1024,0x1639,4,0,0x8c,0x8c,0x8c,3; name="st" class="scsi" target=3 lun=0; . . . name="st" class="scsi" target=6 lun=0; Large Record Sizes SPARC ONLY To support applications such as seismic programs that require large record sizes, the flag ST_NO_RECSIZE_LIMIT must be set in drive option in the configuration entry.
st ( 7D ) Write Data Buffering Devices SunOS 5.5 Tape drives with data compression require a much higher data rate in order to stream the tape. Write data buffering in the driver improves streaming to the drive without changing the application and augments the buffering in the tape drive itself. If write data buffering is enabled, data is buffered in the driver and the request is immediately acknowledged by the driver before it has been written to the tape drive.
SunOS 5.5 Devices st ( 7D ) Since some applications may perceive write buffering as a potential data integrity problem, this feature is disabled by default and needs to be explicitly enabled in the config entry and turned on by means of the property in st.conf. Furthermore, some fault tolerant backup servers make assumptions about the data buffering in the tape drive itself. These assumptions may not be valid if write buffering has been enabled.
st ( 7D ) Devices SEE ALSO DIAGNOSTICS SunOS 5.5 mt(1), modload(1M), modunload(1M), read(2), write(2), driver.conf(4), esp(7D), isp(7D), mtio(7I), ioctl(9E) Error for command ’’Error Level: Fatal Requested Block , Error Block: Sense Key: Vendor ’’: ASC = 0x (), ASCQ = 0x, FRU = 0x The command indicated by failed.
SunOS 5.5 Devices st ( 7D ) Tape devices that do not report a blank check error at the end of recorded media may cause file positioning operations to fail. Some tape drives for example, mistakenly report media error instead of blank check error.
stc ( 7D ) Devices NAME DESCRIPTION SunOS 5.5 stc − Serial Parallel Communications driver for SBus The SPC/S SBus communications board consists of eight asynchronous serial ports and one IBM PS/2-compatible parallel port. The stc driver supports up to 8 SPC/S boards in an SBus system. Each serial port has full modem control: the CD, DTR, DSR, RTS and CTS modem control lines are provided, plus flow control is supported in hardware for either RTS/CTS hardware flow control or DC1/DC3 software flow control.
SunOS 5.5 Devices stc ( 7D ) line for login (using pmadm(1M)) and also used for dial-out (by tip(1) or uucp(1C)) as /dev/cua/0 when no one is logged in on the line. The parallel port is given the name /dev/stclpn, where n is the SPC/S unit number (see Minor Numbers, below). The control port, named /dev/stcn, where n is the SPC/S, is available. And ioctl( ) is provided for this special file which allow the collection of statistics maintained on serial port performance.
stc ( 7D ) Devices SunOS 5.5 The possible values for flags, defined in /usr/include/sys/stcio.h, are: PP_PAPER_OUT honor PAPER OUT from port; returned HIGH means PAPER OUT. PP_ERROR honor ERROR from port; returned HIGH means ERROR. PP_BUSY honor BUSY from port; returned HIGH means BUSY. PP_SELECT honor SELECT from port; returned HIGH means OFFLINE. PP_MSG print console message on every error scan. PP_SIGNAL send a PP_SIGTYPE (SIGURG) to the process if printer error.
SunOS 5.5 Devices stc ( 7D ) The possible cmd values, defined in /usr/include/sys/stcio.h, are STAT_CLEAR clear the line statistics STAT_GET get the line statistics The STC_GSTATS ioctl works only on the SPC/S control port. SOFTCAR, DTR and CTS/RTS FLOW CONTROL Several methods may be used to enable or disable soft carrier on a particular serial line. The non-programmatic method is to edit the /kernel/drv/stc.conf file. For this change to take effect, the machine must be rebooted.
stc ( 7D ) Devices SunOS 5.5 cflow_flush- flush any data being held off by remote flow control on close( ). cflow_msg- display a message on the console if data transmission is stalled due to remote flow control blocking the transfer in close( ). instantflow- if transmission is stopped by software flow control and the flow control is disabled via an ioctl( ) call, the transmitter will be enabled immediately. display- displays all serial port parameters.
SunOS 5.5 Devices stc ( 7D ) Valid tokens requiring parameters for the parallel ports are ack_timeout- The amount of time in seconds to wait for an ACK from the port after asserting STROBE and transferring a byte of data. error_timeout- Amount of time in seconds to wait for an error to go away. busy_timeout- The amount of time in seconds to wait for a BUSY signal to clear, or zero for an infinite BUSY timeout.
stc ( 7D ) Devices SunOS 5.5 EINTR The open was interrupted by the delivery of a signal. EPERM The control port for the board was opened by a process whose uid was not root. An ioctl( ) will fail with errno set to: FILES SEE ALSO DIAGNOSTICS ENOSR A STREAMS data block couldn’t be allocated to return data to the caller. EINVAL An invalid value was passed as the data argument to the ioctl( ) call or an invalid argument or op-field was passed in one of the driver-specific ioctl( )’s.
SunOS 5.5 Devices stc ( 7D ) stc_attach: board revision 0x%x not supported by driver. FATAL. This revision of the board is not supported by the driver. stc_attach: oscillator revision undeterminable FATAL. The driver did not get an oscillator revision level from the board’s onboard FCode PROM. stc_attach: wierd oscillator revision (0x%x), assuming 10Mhz ADVISORY.
stc ( 7D ) Devices SunOS 5.5 flushed; this message may also frequently appear due to a hardware crosstalk problem that was fixed in later releases of the board. stc_rcvex: unit %d line %d receiver overrun, char: 0x%x ERROR. The driver could not get around to service the cd-180 receive data interrupt before the cd-180’s receive data fifo filled up; this message may also frequently appear due to a hardware crosstalk problem that was fixed in later releases of the board.
SunOS 5.5 Devices stc ( 7D ) ppc_acktimeout: unit %d ACK timeout ERROR. The ACK line from the device connected to the parallel port did not assert itself within the configurable timeout period; check to be sure that the device is connected and powered on. ppc_acktimeout: unit %d BUSY timeout ERROR. The BUSY line from the device connected to the parallel port did not de-assert itself within the configurable timeout period; check to be sure that the device is connected and powered on.
stc ( 7D ) Devices SunOS 5.5 stc_ioctl: unit %d line %d can’t allocate STC_DCONTROL block ERROR. The driver could not allocate a data block from allocb(9F) for the STC_DCONTROL return value; the ioctl does not get executed. stc_ioctl: unit %d line %d can’t allocate STC_GPPC block ERROR. The driver could not allocate a data block from allocb( ) for the STC_GPPC return value; the ioctl does not get executed stc_ioctl: unit %d line %d can’t allocate TIOCMGET block ERROR.
SunOS 5.5 Devices NAME DESCRIPTION stp4020 ( 7D ) stp4020 − STP 4020 PCMCIA Adapter The STP 4020 PCMCIA Adapter provides for two PCMCIA PC Card sockets. The stp4020 adapter driver provides an interface between the PCMCIA sockets and the PCMCIA nexus. The driver supports both the Voyager PCMCIA sockets and the Sun PCMCIA Interface/Sbus card. Direct access to the PCMCIA hardware is not supported. The driver exists solely to support the PCMCIA nexus.
streamio ( 7I ) NAME SYNOPSIS Ioctl Requests SunOS 5.5 streamio − STREAMS ioctl commands #include #include #include int ioctl ( int fildes, int command, . . . /∗ arg∗/); DESCRIPTION STREAMS (see intro(2)) ioctl commands are a subset of the ioctl(2) commands, and per- form a variety of control functions on streams. fildes is an open file descriptor that refers to a stream. command determines the control function to be performed as described below.
SunOS 5.5 Ioctl Requests I_LOOK Retrieves the name of the module just below the stream head of the stream pointed to by fildes, and places it in a null terminated character string pointed at by arg. The buffer pointed to by arg should be at least FMNAMESZ+1 bytes long. This requires the declaration #include . On failure, errno is set to one of the following values: EFAULT EINVAL I_FLUSH streamio ( 7I ) arg points outside the allocated address space. No module present in stream.
streamio ( 7I ) Ioctl Requests I_SETSIG SunOS 5.5 Informs the stream head that the user wishes the kernel to issue the SIGPOLL signal (see signal(3C)) when a particular event has occurred on the stream associated with fildes. I_SETSIG supports an asynchronous processing capability in STREAMS. The value of arg is a bitmask that specifies the events for which the user should be signaled.
SunOS 5.5 Ioctl Requests streamio ( 7I ) Processes that wish to receive SIGPOLL signals must explicitly register to receive them using I_SETSIG. If several processes register to receive this signal for the same event on the same stream, each process will be signaled when the event occurs. If the value of arg is zero, the calling process will be unregistered and will not receive further SIGPOLL signals.
streamio ( 7I ) Ioctl Requests SunOS 5.5 I_PEEK returns 1 if a message was retrieved, and returns 0 if no message was found on the stream head read queue. It does not wait for a message to arrive. On return, ctlbuf specifies information in the control buffer, databuf specifies information in the data buffer, and flags contains the value RS_HIPRI or 0.
SunOS 5.5 Ioctl Requests I_FDINSERT streamio ( 7I ) Creates a message from user specified buffer(s), adds information about another stream and sends the message downstream. The message contains a control part and an optional data part. The data and control parts to be sent are distinguished by placement in separate buffers, as described below.
streamio ( 7I ) Ioctl Requests SunOS 5.5 EINVAL One of the following: fildes in the strfdinsert structure is not a valid, open stream file descriptor; the size of a pointer plus offset is greater than the len field for the buffer specified through ctlptr; offset does not specify a properly-aligned location in the data buffer; an undefined value is stored in flags. ENXIO Hangup received on fildes of the ioctl call or fildes in the strfdinsert structure.
SunOS 5.5 Ioctl Requests streamio ( 7I ) To send requests downstream, arg must point to a strioctl structure which contains the following members: int int int char ic_cmd; ic_timout; ic_len; ∗ic_dp; ic_cmd is the internal ioctl command intended for a downstream module or driver and ic_timout is the number of seconds (-1 = infinite, 0 = use default, >0 = as specified) an I_STR request will wait for acknowledgement before timing out.
streamio ( 7I ) Ioctl Requests I_SWROPT SunOS 5.5 Sets the write mode using the value of the argument arg. Legal bit settings for arg are: SNDZERO Send a zero-length message downstream when a write of 0 bytes occurs. To not send a zero-length message when a write of 0 bytes occurs, this bit must not be set in arg. On failure, errno may be set to the following value: EINVAL arg is not the above legal value.
SunOS 5.5 Ioctl Requests streamio ( 7I ) new user file descriptor is allocated for the file pointer contained in the message. The new file descriptor is placed in the fd field of the strrecvfd structure. The structure is copied into the user data buffer pointed to by arg. On failure, errno is set to one of the following values: I_LIST EAGAIN A message is not present at the stream head read queue, and the O_NDELAY or O_NONBLOCK flag is set.
streamio ( 7I ) Ioctl Requests SunOS 5.5 The return value is 1 if the mark condition is satisfied and 0 otherwise. On failure, errno is set to the following value: EINVAL I_CKBAND Check if the message of a given priority band exists on the stream head read queue. This returns 1 if a message of a given priority exists, 0 if not, or -1 on error. arg should be an integer containing the value of the priority band in question.
SunOS 5.5 Ioctl Requests WERRNORM streamio ( 7I ) Persistent write errors, the default. WERRNONPERSIST Non-persistent write errors. When no value is specified e.g. for the read side error behavior then the behavior for that side will be left unchanged. On failure, errno is set to the following value: EINVAL I_GERROPT arg is not one of the above legal values. Returns the current error mode setting in an int pointed to by the argument arg. Error modes are described above for I_SERROPT.
streamio ( 7I ) Ioctl Requests SunOS 5.5 An I_LINK can also fail while waiting for the multiplexing driver to acknowledge the link request, if a message indicating an error or a hangup is received at the stream head of fildes. In addition, an error code can be returned in the positive or negative acknowledgement message. For these cases, I_LINK will fail with errno set to the value in the message. I_UNLINK Disconnects the two streams specified by fildes and arg.
SunOS 5.5 Ioctl Requests streamio ( 7I ) EBADF arg is not a valid, open file descriptor. EINVAL fildes does not support multiplexing. EINVAL arg is not a stream or is already linked under a multiplexor. EINVAL The specified link operation would cause a ‘‘cycle’’ in the resulting configuration; that is, if a driver would be linked into the multiplexing configuration in more than one place. EINVAL fildes is the file descriptor of a pipe or FIFO.
streamio ( 7I ) SEE ALSO Ioctl Requests SunOS 5.
SunOS 5.5 Protocols NAME SYNOPSIS tcp ( 7P ) tcp, TCP − Internet Transmission Control Protocol #include #include s = socket(AF_INET, SOCK_STREAM, 0); t = t_open("/dev/tcp", O_RDWR); DESCRIPTION TCP is the virtual circuit protocol of the Internet protocol family. It provides reliable, flow-controlled, in order, two-way transmission of data.
tcp ( 7P ) Protocols SunOS 5.5 Therefore, TCP provides a boolean option, TCP_NODELAY (defined in ), to defeat this algorithm. The option level for the setsockopt( ) call is the protocol number for TCP, available from getprotobyname(3N). Options at the IP level may be used with TCP. See ip(7P). TCP provides an urgent data mechanism, which may be invoked using the out-of-band provisions of send(3N). The caller may mark one byte as “urgent” with the MSG_OOB flag to send(3N).
SunOS 5.5 Protocols tcp ( 7P ) EADDRNOTAVAIL A bind( ) operation was attempted on a socket with a network address for which no network interface exists. modified 3 Jul 1990 EACCES A bind( ) operation was attempted with a “reserved” port number and the effective user ID of the process was not the privileged user. ENOBUFS The system ran out of memory for internal data structures.
tcx ( 7D ) Devices NAME SYNOPSIS DESCRIPTION SunOS 5.5 tcx − 24-bit SBus color memory frame buffer /dev/fbs/tcx tcx is a 8/24-bit color frame buffer and graphics accelerator, with 8-bit colormap, and overlay/enable planes. It provides the standard frame buffer interface defined in fbio(7I). tcx has two control planes which define how the underlying pixel is displayed.
SunOS 5.5 Devices FILES SEE ALSO modified 10 Nov 1993 /dev/fbs/tcx /dev/fb /usr/include/sys/tcxreg.
termio ( 7I ) Ioctl Requests NAME SYNOPSIS SunOS 5.5 termio − general terminal interface #include ioctl(int fildes, int request, struct termio ∗arg); ioctl(int fildes, int request, int arg); #include ioctl(int fildes, int request, struct termios ∗arg); DESCRIPTION This release supports a general interface for asynchronous communications ports that is hardware-independent.
SunOS 5.5 Ioctl Requests termio ( 7I ) The operating system will not normally send SIGTSTP, SIGTTIN, or SIGTTOU. signals to a process that is a member of an orphaned process group. These are process groups which do not have a member with a parent in another process group that is in the same session and therefore shares the same controlling terminal. When a member’s orphaned process group attempts to access its controlling terminal, errors will be returned.
termio ( 7I ) Ioctl Requests SunOS 5.5 The ERASE and KILL characters may be entered literally by preceding them with the escape character ( \ ). In this case, the escape character is not read. The erase and kill characters may be changed. Non-canonical mode input processing In non-canonical mode input processing, input characters are not assembled into lines, and erase and kill processing does not occur. The MIN and TIME values are used to determine how to process the characters received.
SunOS 5.5 Comparison of the different cases of MIN, TIME interaction Ioctl Requests termio ( 7I ) Some points to note about MIN and TIME: 1. In the following explanations, note that the interactions of MIN and TIME are not symmetric. For example, when MIN > 0 and TIME = 0, TIME has no effect. However, in the opposite case, where MIN = 0 and TIME > 0, both MIN and TIME play a role in that MIN is satisfied with the receipt of a single character. 2.
termio ( 7I ) Ioctl Requests SunOS 5.5 EOL, or EOL2 character. REPRINT (CTRL-R or ASCII DC2) reprints all characters, preceded by a newline, that have not been read. EOF (CTRL-D or ASCII EOT) may be used to generate an end-of-file from a terminal. When received, all the characters waiting to be read are immediately passed to the program, without waiting for a newline, and the EOF is discarded.
SunOS 5.5 Ioctl Requests termio ( 7I ) special function is done. Modem disconnect When a modem disconnect is detected, a SIGHUP signal is sent to the terminal’s controlling process. Unless other arrangements have been made, these signals cause the process to terminate. If SIGHUP is ignored or caught, any subsequent read returns with an endof-file indication until the terminal is closed.
termio ( 7I ) Ioctl Requests SunOS 5.5 16-19 reserved Input modes The c_iflag field describes the basic terminal input control: IGNBRK BRKINT IGNPAR PARMRK INPCK ISTRIP INLCR IGNCR ICRNL IUCLC IXON IXANY IXOFF IMAXBEL Ignore break condition. Signal interrupt on break. Ignore characters with parity errors. Mark parity errors. Enable input parity check. Strip character. Map NL to CR on input. Ignore CR. Map CR to NL on input. Map upper-case to lower-case on input. Enable start/stop output control.
SunOS 5.5 Ioctl Requests termio ( 7I ) If IUCLC is set, a received upper case, alphabetic character is translated into the corresponding lower case character. If IXON is set, start/stop output control is enabled. A received STOP character suspends output and a received START character restarts output. The STOP and START characters will not be read, but will merely perform flow control functions. If IXANY is set, any input character restarts output that has been suspended.
termio ( 7I ) Ioctl Requests SunOS 5.5 FF0 FF1 If OPOST is set, output characters are post-processed as indicated by the remaining flags; otherwise, characters are transmitted without change. If OLCUC is set, a lower case alphabetic character is transmitted as the corresponding upper case character. This function is often used in conjunction with IUCLC. If ONLCR is set, the NL character is transmitted as the CR-NL character pair. If OCRNL is set, the CR character is transmitted as the NL character.
SunOS 5.
termio ( 7I ) Ioctl Requests SunOS 5.5 CBAUDEXT Bit to indicate output speed > B38400 CIBAUDEXTBit to indicate input speed > B38400 The CBAUD bits together with the CBAUDEXT bit specify the output baud rate. To retrieve the output speed from the termios structure pointed to by termios_p see the following code segment.
SunOS 5.5 Ioctl Requests termio ( 7I ) To store the input speed in the termios structure pointed to by termios_p see the following code segment.
termio ( 7I ) Ioctl Requests SunOS 5.5 signal is used to do inbound flow control. It is expected that input will be suspended if RTS is low and resumed when RTS is high. Case D: CRTSCTS on, CRTSXOFF on. In this case both inbound and outbound hardware flow control are enabled. Uses the state of CTS signal to do outbound flow control and RTS signal to do inbound flow control. Local modes The c_lflag field of the argument structure is used by the line discipline to control terminal functions.
SunOS 5.5 Ioctl Requests for: ` ˜ { } \ termio ( 7I ) use: \´ \! \ˆ \( \) \\ For example, A is input as \a, \n as \\n, and \N as \\\n. If ECHO is set, characters are echoed as received. When ICANON is set, the following echo functions are possible. 1. If ECHO and ECHOE are set, and ECHOPRT is not set, the ERASE and WERASE characters are echoed as one or more ASCII BS SP BS, which clears the last character(s) from a CRT screen. 2.
termio ( 7I ) Ioctl Requests SunOS 5.5 If FLUSHO and IEXTEN are set, data written to the terminal is discarded. This bit is set when the FLUSH character is typed. A program can cancel the effect of typing the FLUSH character by clearing FLUSHO. If PENDIN and IEXTEN are set, any input that has not yet been read is reprinted when the next character arrives as input. PENDIN is then automatically cleared.
SunOS 5.5 Ioctl Requests termio ( 7I ) The calls that use the termio structure only affect the flags and control characters that can be stored in the termio structure; all other flags and control characters are unaffected. Modem lines On special files representing serial ports, the modem control lines supported by the hardware can be read, and the modem status lines supported by the hardware can be changed.
termio ( 7I ) 7I-362 Ioctl Requests SunOS 5.5 TCSETSW The argument is a pointer to a termios structure. The current terminal parameters are set from the values stored in that structure. The change occurs after all characters queued for output have been transmitted. This form should be used when changing parameters that affect output. TCSETSF The argument is a pointer to a termios structure. The current terminal parameters are set from the values stored in that structure.
SunOS 5.5 Ioctl Requests FILES SEE ALSO modified 30 May 1995 termio ( 7I ) TIOCGWINSZ The argument is a pointer to a winsize structure. The terminal driver’s notion of the terminal size is stored into that structure. TIOCSWINSZ The argument is a pointer to a winsize structure. The terminal driver’s notion of the terminal size is set from the values specified in that structure. If the new sizes are different from the old sizes, a SIGWINCH signal is set to the process group of the terminal.
termiox ( 7I ) Ioctl Requests NAME SunOS 5.5 termiox − extended general terminal interface DESCRIPTION The extended general terminal interface supplements the termio(7I) general terminal interface by adding support for asynchronous hardware flow control, isochronous flow control and clock modes, and local implementations of additional asynchronous features. Some systems may not support all of these capabilities because of either hardware or software limitations.
SunOS 5.5 Terminal Parameters Ioctl Requests termiox ( 7I ) The parameters that control the behavior of devices providing the termiox interface are specified by the termiox structure, defined in the header.
termiox ( 7I ) Ioctl Requests SunOS 5.5 If CTSXON is set, output will occur only if the Clear To Send (CTS) circuit (line) is raised by the connected device. If the CTS line is lowered by the connected device, output is suspended until CTS is raised. If DTRXOFF is set, the DTE Ready (DTR) circuit (line) will be raised, and if the asynchronous port needs to have its input stopped, it will lower the DTE Ready (DTR) line.
SunOS 5.5 Ioctl Requests TSETCTBRG 0000200 TSETCTSET 0000300 TSETCRSET 0000400 RSETCLK 0007000 RSETCOFF 0000000 RSETCRBRG 0001000 RSETCTBRG 0002000 RSETCTSET 0003000 RSETCRSET 0004000 termiox ( 7I ) Output transmit baud rate generator on circuit 113. Output transmitter signal element timing (DCE source) on circuit 113. Output receiver signal element timing (DCE source) on circuit 113. Receiver signal element timing (DTE source) lead, CCITT V.
termiox ( 7I ) Ioctl Requests SunOS 5.5 If the RSETCLK field has a value of RSETCOFF the Receiver Signal Element Timing (DTE source) circuit is not driven. If RSETCLK = RSETCRBRG the Receiver Signal Element Timing (DTE source) circuit is driven by the Receive Baud Rate Generator. If RSETCLK = RSETCTBRG the Receiver Signal Element Timing (DTE source) circuit is driven by the Transmit Baud Rate Generator.
SunOS 5.5 Devices NAME SYNOPSIS DESCRIPTION ticlts ( 7D ) ticlts, ticots, ticotsord − loopback transport providers #include #include #include The devices known as ticlts, ticots, and ticotsord are ‘‘loopback transport providers,’’ that is, stand-alone networks at the transport level. Loopback transport providers are transport providers in every sense except one: only one host (the local machine) is ‘‘connected to’’ a loopback network.
ticlts ( 7D ) Devices USAGE SunOS 5.5 Loopback transports support a local IPC mechanism through the TLI interface. Applications implemented in a transport provider-independent manner on a client-server model using this IPC are transparently transportable to networked environments. Transport provider-independent applications must not include the headers listed in the synopsis section above. In particular, the options are (like all transport provider options) provider dependent.
SunOS 5.5 STREAMS Modules NAME SYNOPSIS timod ( 7M ) timod − Transport Interface cooperating STREAMS module #include ioctl(fildes, I_STR, &my_strioctl); DESCRIPTION timod is a STREAMS module for use with the Transport Interface (TI) functions of the Network Services library. The timod module converts a set of ioctl(2) calls into STREAMS messages that may be consumed by a transport protocol provider that supports the Transport Interface.
timod ( 7M ) STREAMS Modules SunOS 5.5 successful completion of the ioctl is equivalent to the TI message type T_INFO_ACK. TI_OPTMGMT Get, set, or negotiate protocol specific options with the transport protocol provider. The message issued to the TI_OPTMGMT ioctl is equivalent to the TI message type T_OPTMGMT_REQ and the message returned by the successful completion of the ioctl is equivalent to the TI message type T_OPTMGMT_ACK. FILES SEE ALSO
SunOS 5.5 Devices NAME SYNOPSIS tiqmouse ( 7D ) tiqmouse − integrated mouse device interface tiqmouse:l AVAILABILITY x86 DESCRIPTION Some notebook computers (notably the Texas Instruments 4000E) use a nonstandard PS/2-style QuickPort mouse interface that resembles but is not compatible with a PS/2 keyboard mouse port. The tiqmouse driver provides support for this alternate mouse interface. It allows applications to obtain information about the mouse’s movements and the status of its buttons.
tirdwr ( 7M ) STREAMS Modules NAME SYNOPSIS DESCRIPTION SunOS 5.5 tirdwr − Transport Interface read/write interface STREAMS module int ioctl( fd, I_PUSH, "tirdwr"); tirdwr is a STREAMS module that provides an alternate interface to a transport provider which supports the Transport Interface (TI) functions of the Network Services library (see Section 3N). This alternate interface allows a user to communicate with the transport protocol provider using the read(2) and write(2) system calls.
SunOS 5.5 STREAMS Modules tirdwr ( 7M ) The action taken on messages with control portions will be as follows: Messages that represent expedited data generate an error. All further system calls associated with the stream fail with errno set to EPROTO. Any data messages with control portions have the control portions removed from the message before to passing the message on to the upstream neighbor.
tmpfs ( 7FS ) File Systems NAME SYNOPSIS DESCRIPTION SunOS 5.5 tmpfs − memory based filesystem #include mount (special, directory, MS_DATA, "tmpfs", NULL, 0); tmpfs is a memory based filesystem which uses kernel resources relating to the VM system and page cache as a filesystem. Once mounted, a tmpfs filesystem provides standard file operations and semantics.
SunOS 5.5 File Systems SEE ALSO tmpfs ( 7FS ) df(1M), mount(1M), mount_tmpfs(1M), swap(1M), mmap(2), mount(2), umount(2), vfstab(4) System Administration Guide, Volume I DIAGNOSTICS If tmpfs runs out of space, one of the following messages will be printed to the console. directory: File system full, swap space limit exceeded This message is printed because a page could not be allocated while writing to a file.
tpf ( 7D ) Devices NAME SunOS 5.5 tpf − Platform Specific Module (PSM) for Tricord Systems Enterprise Server Models ES3000, ES4000 and ES5000. AVAILABILITY x86 DESCRIPTION tpf provides the platform dependent functions for Solaris X86 MP support. These functions adhere to the PSMI Specifications. (Platform Specific Module Interface Specifications.) Tricord Systems Enterprise Servers are Intel APIC based MP platforms which run from 1 to 12 Intel processors.
SunOS 5.5 Devices NAME SYNOPSIS tr ( 7D ) tr − IBM 16/4 Token Ring Network Adapter device driver #include #include #include AVAILABILITY x86 DESCRIPTION The tr token ring driver is a multi-threaded, loadable, clonable, STREAMS hardware driver supporting the connectionless Data Link Provider Interface, dlpi(7P), over IBM 16/4 Token Ring adapters. The driver supports installation of both a primary and secondary 16/4 Adapter within the system.
tr ( 7D ) Devices SunOS 5.5 The token ring broadcast address (C0:00:FF:FF:FF:FF) is also supported. Once in the DL_ATTACHED state, the user must send a DL_BIND_REQ to associate a particular Service Access Pointer (SAP) with the stream. The tr driver interprets the sap field within the DL_BIND_REQ as an IEEE 802.2 sap; therefore valid values for the sap field are in the [0-0xFF] range, of which only even values are legal. In addition to 802.2 service, a “SNAP mode” is also provided by the driver.
SunOS 5.5 Devices tr ( 7D ) The DL_SET_PHYS_ADDR_REQ primitive changes the 6-octet token ring address currently associated (attached) to this stream. The credentials of the process which originally opened this stream must be superuser or an EPERM error is returned in the DL_ERROR_ACK. This primitive is destructive in that it affects all other current and future streams attached to this device. Once changed, all streams subsequently opened and attached to this device will obtain this new physical address.
trantor ( 7D ) Devices NAME SYNOPSIS AVAILABILITY DESCRIPTION SunOS 5.5 trantor − low-level module for Trantor T348 Parallel SCSI host bus adapter trantor@ioaddr,0 x86 The trantor module provides low-level interface routines between the common disk/tape I/O subsystem and the Trantor T348 Mini-SCSI-Plus parallel host bus adapter. The Trantor T348 is a SCSI (Small Computer System Interface) host bus adapter that plugs into a parallel port (rather than a bus slot).
SunOS 5.5 Devices trantor ( 7D ) The trantor driver does not support the T348 pass-through parallel port. The trantor driver does not support concurrent use of SCSI devices and any other device (such as a printer) connected to the same parallel port. All SCSI devices must be closed before any other peripheral devices on the parallel port can be accessed.
ttcompat ( 7M ) NAME SYNOPSIS STREAMS Modules SunOS 5.5 ttcompat − V7, 4BSD and XENIX STREAMS compatibility module #include #include #include #include #include ioctl( fd, I_PUSH, "ttcompat"); DESCRIPTION ttcompat is a STREAMS module that translates the ioctl calls supported by the older Version 7, 4BSD, and XENIX terminal drivers into the ioctl calls supported by the termio interface (see termio(7I)).
SunOS 5.5 STREAMS Modules ttcompat ( 7M ) Delay type 0 is always mapped into the equivalent delay type 0 in the c_oflag field of the termios structure.
ttcompat ( 7M ) STREAMS Modules SunOS 5.5 The LCASE flag maps upper-case letters in the ASCII character set to their lower-case equivalents on input (the IUCLC flag is set in the c_iflag field), and maps lower-case letters in the ASCII character set to their upper-case equivalents on output (the OLCUC flag is set in the c_oflag field).
SunOS 5.5 STREAMS Modules ttcompat ( 7M ) Also associated with each terminal is a local flag word, specifying flags supported by the new 4BSD terminal interface.
ttcompat ( 7M ) STREAMS Modules SunOS 5.5 TIOCEXCL Set ‘‘exclusive-use’’ mode; no further opens are permitted until the file has been closed. TIOCNXCL Turn off ‘‘exclusive-use’’ mode. TIOCSETP The argument is a pointer to an sgttyb structure. The appropriate characters and input and output speeds in the terminal state are set from the values in that structure, and the flags in the terminal state are set to match the values of the flags in the sg_flags field of that structure.
SunOS 5.5 STREAMS Modules ttcompat ( 7M ) TIOCLBIS The argument is a pointer to an int whose value is a mask containing flags to be set in the local flags word. The current terminal state is fetched, and the values of the local flags are derived from the flags in the terminal state; the specified flags are set, and the flags in the terminal state are set to match the new value of the local flags word.
tty ( 7D ) Devices NAME DESCRIPTION FILES SEE ALSO 7D-390 SunOS 5.5 tty − controlling terminal interface The file /dev/tty is, in each process, a synonym for the control terminal associated with the process group of that process, if any. It is useful for programs or shell sequences that wish to be sure of writing messages on the terminal no matter how output has been redirected.
SunOS 5.5 Protocols NAME SYNOPSIS udp ( 7P ) udp, UDP − Internet User Datagram Protocol #include #include s = socket(AF_INET, SOCK_DGRAM, 0); t = t_open("/dev/udp", O_RDWR); DESCRIPTION UDP is a simple datagram protocol which is layered directly above the Internet Protocol (IP).
udp ( 7P ) Protocols SEE ALSO SunOS 5.5 read(2), write(2), bind(3N), connect(3N), recv(3N), send(3N), icmp(7P), inet(7P), ip(7P), tcp(7P) Postel, Jon, User Datagram Protocol, RFC 768, Network Information Center, SRI International, Menlo Park, Calif.
SunOS 5.5 Ioctl Requests NAME SYNOPSIS DESCRIPTION visual_io ( 7I ) visual_io − Solaris VISUAL I/O control operations #include The Solaris VISUAL environment defines a small set of ioctls for controlling graphics and imaging devices. One ioctl, VIS_GETIDENTIFIER, is mandatory, and must be implemented in device drivers for graphics devices using the Solaris VISUAL environment. The VIS_GETIDENTIFIER, ioctl is defined to return a device identifier from the device driver.
visual_io ( 7I ) Ioctl Requests SunOS 5.
SunOS 5.5 File Systems NAME DESCRIPTION volfs ( 7FS ) volfs − Volume Management file system volfs is the Volume Management file system rooted at root_dir. The default location for root-dir is /vol, but this can be overridden using the −d option of vold (see vold(1M)). This file system is maintained by the Volume Management daemon, vold, and will be considered to be /vol for this description.
volfs ( 7FS ) File Systems SunOS 5.5 Example: disk volume ’foo’ has 3 valid partitions: 0, 2, 5. /vol/dsk/foo/s0, /vol/dsk/foo/s2, /vol/dsk/foo/s5, /vol/rdsk/foo/s0, /vol/rdsk/foo/s2, /vol/rdsk/foo/s5 If a volume is relabeled to reflect different partitions, the name space changes to reflect the new partition layout. A format program can check to see if there are others with the volume open and not allow the format to occur if it is.
SunOS 5.5 STREAMS Modules NAME SYNOPSIS vuidmice ( 7M ) vuidmice, vuidm3p, vuidm4p, vuidm5p, vuid2ps2, vuid3ps2 − converts mouse protocol to Firm Events #include #include
vuidmice ( 7M ) Read Side Behavior Write Side Behavior STREAMS Modules SunOS 5.5 M_DATA The messages coming in are queued and converted to Firm events. M_FLUSH The read queue of the module is flushed of all its data messages and all data in the record being accumulated are also flushed. The message is passed upstream. M_IOCTL messages sent downstream as a result of an ioctl(2) system call. There are two valid ioctl options processed by the vuidmice modules VUIDGFORMAT and VUIDSFORMAT.
SunOS 5.5 Devices NAME SYNOPSIS wscons ( 7D ) wscons − workstation console #include ioctl(fd, SRIOCSREDIR, target); ioctl(fd, SRIOCISREDIR, target); DESCRIPTION Redirection The “workstation console” is a device consisting of the combination of the workstation keyboard and frame buffer, acting in concert to emulate an ASCII terminal.
wscons ( 7D ) Devices SunOS 5.5 The Sun console displays a cursor which marks the current line and character position on the screen. ASCII characters between 0x20 (space) and 0x7E (tilde) inclusive are printing characters — when one is written to the Sun console (and is not part of an escape sequence), it is displayed at the current cursor position and the cursor moves one position to the right on the current line.
SunOS 5.5 Devices wscons ( 7D ) If more than the required number of parameters is supplied, only the last n are used, where n is the number required by that particular command character. Also, parameters which are omitted or set to zero are reset to the default value of 1 (except as noted below). Consider, for example, the command character M which requires one parameter. ESC [;M and ESC [0M and ESC [M and ESC [23;15;32;1M are all equivalent to ESC [1M and provide a parameter value of 1.
wscons ( 7D ) Devices SunOS 5.5 If S is zero, ‘wrap-around’ mode is entered. ‘ESC [ 1 r’ exits back to scroll mode. If a line-feed occurs on the bottom line in wrap mode, the cursor goes to the same character position in the top line of the screen. When any line-feed occurs, the line that the cursor moves to is cleared. This means that no scrolling occurs. Wrap-around mode is not implemented in the window system.
SunOS 5.5 Devices wscons ( 7D ) Takes one parameter, # (default 1). Moves the cursor to the right by # character positions on the current line. If the cursor is fewer than # positions from the right edge of the screen, moves the cursor to the rightmost position on the current line. ESC [#D Cursor Backward (CUB) Takes one parameter, # (default 1). Moves the cursor to the left by # character positions on the current line.
wscons ( 7D ) Devices SunOS 5.5 cursor position. Shifts to the left by # character positions the tail of the current line from the current cursor position inclusive to the end of the line. Blanks are shifted into the rightmost # character positions. The position of the cursor on the screen is unchanged. ESC [#m Select Graphic Rendition (SGR) Takes one parameter, # (default 0). Note: unlike most escape sequences, the parameter defaults to zero if omitted.
SunOS 5.5 Devices ESC [s RETURN VALUES wscons ( 7D ) Reset terminal emulator (SUNRESET) Takes no parameters. Resets all modes to default, restores current font from PROM. Screen and cursor position are When there are no errors, the redirection ioctls have return values as described above. Otherwise, they return −1 and set errno to indicate the error. If the target stream is in an error state, errno is set accordingly. ERRORS x86 FILES EBADF target does not denote an open file.
xd ( 7D ) Devices NAME SYNOPSIS AVAILABILITY SunOS 5.5 xd, xdc − disk driver for Xylogics 7053 SMD Disk Controller xdc@6d,ee80/xd@slave,0:partition xdc@6d,ee90/xd@slave,0:partition xdc@6d,eea0/xd@slave,0:partition xdc@6d,eeb0/xd@slave,0:partition SPARC Only available on Sun-4/200, Sun-4/300, and Sun-4/400 series systems. DESCRIPTION The driver for Xylogics 7053 devices consists of several components: a controller driver (xdc) and a slave device driver module (xd).
SunOS 5.5 Devices NOTES modified 20 Jul 1994 xd ( 7D ) In raw I/O read(2) and write(2) truncate file offsets to 512-byte block boundaries, and write(2) scribbles on the tail of incomplete blocks. Thus, in programs that are likely to access raw devices, read(2), write(2), and lseek(2) should always deal in 512-byte multiples.
xt ( 7D ) Devices NAME SYNOPSIS SunOS 5.5 xt − driver for Xylogics 472 1/2 inch tape controller xt@2d,ee60:[l,m][b][n] xt@2d,ee68:[l,m][b][n] AVAILABILITY Only available on Sun-4/200, Sun-4/300, and Sun-4/400 series systems. DESCRIPTION The Xylogics 472 tape controller controls Pertec-interface 1/2” tape drives such as the Fujitsu M2444 and the CDC Keystone III. The xt driver provides a standard tape interface to the device; see mtio(7I) for details.
SunOS 5.5 Devices xt ( 7D ) For 1/2” reel tape devices, the densities are: SEE ALSO BUGS l typically 1600 BPI density m typically 6250 BPI density ioctl(2), driver.conf(4), vme(4), mtio(7I) Record sizes are restricted to an even number of bytes. The EOT handling for write operation differs from the mtio(7I) specification.
xy ( 7D ) Devices NAME SYNOPSIS AVAILABILITY SunOS 5.5 xy, xyc − disk driver for Xylogics 450 and 451 SMD Disk Controllers xyc@2d,ee40/xy@slave,0:partition xyc@2d,ee48/xy@slave,0:partition SPARC Only available on Sun-4/200, Sun-4/300, and Sun-4/400 series systems. DESCRIPTION The driver for Xylogics 450/451 devices consists of several components: a controller driver module (xyc) and a slave device driver module (xy).
SunOS 5.5 Devices NOTES modified 20 Jul 1994 xy ( 7D ) In raw I/O read(2) and write(2) truncate file offsets to 512-byte block boundaries, and write(2) scribbles on the tail of incomplete blocks. Thus, in programs that are likely to access raw devices, read(2), write(2), and lseek(2) should always deal in 512-byte multiples.
zero ( 7D ) Devices NAME DESCRIPTION SunOS 5.5 zero − source of zeroes A zero special file is a source of zeroed unnamed memory. Reads from a zero special file always return a buffer full of zeroes. The file is of infinite length. Writes to a zero special file are always successful, but the data written is ignored. Mapping a zero special file creates a zero-initialized unnamed memory object of a length equal to the length of the mapping and rounded up to the nearest page size as returned by sysconf.
SunOS 5.5 Devices NAME SYNOPSIS zs ( 7D ) zs − Zilog 8530 SCC serial communications driver #include #include open("/dev/term/n", mode); open("/dev/ttyn", mode); open("/dev/cua/n", mode); AVAILABILITY SPARC DESCRIPTION The Zilog 8530 provides two serial input/output channels that are capable of supporting a variety of communication protocols.
zs ( 7D ) Devices SunOS 5.5 uucp(1C)) as /dev/cua/n when no one is logged in on the line. IOCTLS The standard set of termio ioctl( ) calls are supported by zs. If the CRTSCTS flag in the c_cflag field is set, output will be generated only if CTS is high; if CTS is low, output will be frozen. If the CRTSCTS flag is clear, the state of CTS has no effect. If the CRTSXOFF flag in the c_cflag field is set, input will be received only if RTS is high; if RTS is low, input will be frozen.
SunOS 5.5 Devices zs ( 7D ) The driver’s character input ring buffer overflowed before it could be serviced.
zsh ( 7D ) Devices NAME SYNOPSIS SunOS 5.5 zsh − On-board serial HDLC/SDLC interface #include open(/dev/zshn, mode ); open(/dev/zsh, mode ); AVAILABILITY SPARC DESCRIPTION The zsh module is a loadable STREAMS driver that implements the sending and receiving of data packets as HDLC frames over synchronous serial lines. The module is not a standalone driver, but instead depends upon the zs module for the hardware support required by all on-board serial devices.
SunOS 5.5 Devices zsh ( 7D ) The zsh driver keeps running totals of various hardware generated events for each channel. These include numbers of packets and characters sent and received, abort conditions detected by the receiver, receive CRC errors, transmit underruns, receive overruns, input errors and output errors, and message block allocation failures.
zsh ( 7D ) Devices long long long long long long long cts; dcd; overrun; underrun; ierror; oerror; nobuffers; SunOS 5.5 /∗ CTS timeouts ∗/ /∗ Carrier drops ∗/ /∗ receive overrun ∗/ /∗ transmit underrun ∗/ /∗ input error ∗/ /∗ output error ∗/ /∗ receive side memory allocation failure ∗/ }; ERRORS An open( ) will fail if a STREAMS message block cannot be allocated, or: ENXIO The unit being opened does not exist. EBUSY The device is in use by another serial protocol.
SunOS 5.5 Devices zsh ( 7D ) zshn: not initialized, can’t send message An M_DATA message was passed to the driver for a channel that had not been programmed at least once since the driver was loaded. The SCC’s registers were in an unknown state. The S_IOCSETMODE ioctl command performs the programming operation. zshn: transmit hung The transmitter was not successfully restarted after the watchdog timer expired.
Index 1 1/2-inch tape drive xt — Xylogics 472 10/100 Mbit/s 802.
driver — mcpzsa Am7990 (LANCE) Ethernet device driver — le, 7D-186 — lebuffer, 7D-186 — ledma, 7D-186 Am79C940 (MACE) Ethernet device driver — qe, 7D-270 thru 7D-273 AMD PCnet Ethernet controller device driver — pcn, 7D-247 ANSI standard terminal emulation — wscons arp — Address Resolution Protocol, 7P-17 arp ioctl SIOCDARP — delete arp entry, 7P-17 SIOCGARP — get arp entry, 7P-17 SIOCSARP — set arp entry, 7P-17 asy — asynchronous serial port driver, 7D-20 asynchronous serial port driver — asy, 7D-20 AT att
connld — line discipline for unique connections, 7M-68 console — STREAMS-based console interface, 7D-69 converts mouse protocol to Firm Events — vuidmice, 7M-397 vuid2ps2, 7M-397 vuid3ps2, 7M-397 vuidm3p, 7M-397 vuidm4p, 7M-397 vuidm5p, 7M-397 core memory image — mem, 7D-207 corvette — low-level module for IBM Micro Channel SCSI-2 Fast/Wide Adapter/A, 7D-70 Crystal Semiconductor 4231 audio Interface — audiocs, 7D-35 csa — low-level module for Compaq SMART SCSI Array Controller, 7D-71 D D-LINK Ethernet cont
E eepro — EtherExpress-Pro Ethernet device driver, 7D-89 eha — low-level module for Adaptec 174x EISA host bus adapter, 7D-93 el — 3COM 3C503 Ethernet device driver, 7D-94 elink — 3COM 3C507 Ethernet device driver, 7D-97 elx — 3COM ETHERLINK III Ethernet device driver, 7D-100 elx Primitives, 7D-100 esa — low-level module for Adaptec 7770 based SCSI controllers, 7D-103 esp — ESP SCSI Host Bus Adapter Driver, 7D-104 ESP SCSI Host Bus Adapter Driver — esp, 7D-104 EtherExpress 16 Ethernet device driver, Intel —
driver — tr, 7D-379 IBM Micro Channel SCSI-2 Fast/Wide Adapter/A corvette — low-level module for, 7D-70 IBM MicroChannel host bus adapter mcis — low-level module for, 7D-202 icmp — Internet Control Message Protocol ie — Intel 82586 Ethernet device driver, 7D-130 iee — EtherExpress 16 Ethernet device driver, 7D-133 ieef — Intel EtherExpress Flash32/82596 Ethernet device driver ieef and DLPI, 7D-136 ieef Primitives, 7D-137 ieef — Intel EtherExpress Flash32/82596 Ethernet device driver, 7D-136 if — general pro
ioctl’s for terminals, continued TIOCSTART — start output (like control-Q), 7D-268 TIOCSTOP — stop output (like control-S), 7D-268 ip — Internet Protocol ipd — STREAMS modules and drivers for the Point-to-Point Protocol, 7M-260 ipdcm — STREAMS modules and drivers for the Point-to-Point Protocol, 7M-260 ipdptp — STREAMS modules and drivers for the Point-to-Point Protocol, 7M-260 ipi — IPI driver ipi — IPI driver isdnio — generic ISDN interface, 7I-151 ISO 9660 — ISO 9660 CD-ROM filesystem — hsfs, 7FS-125 isp
low-level module for Adaptec 7770 based SCSI controllers — esa, 7D-103 low-level module for Adaptec 7870 based SCSI controllers — adp, 7D-13 low-level module for Compaq SMART SCSI Array Controller — csa, 7D-71 low-level module for NCR 53C710, 53C810, 53C815, 53C820, and 53C825 host bus adapters — ncrs, 7D-223 low-level module for the AMD PCscsi, PCscsi II, and PCnet-SCSI PCI-to-SCSI bus adapters — pcscsi, 7D-250 low-level module for Tricord System’s SCSI host bus adapter — iss, 7D-169 lp — driver for parall
PCFS — DOS formatted file system, 7FS-240 pcic — Intel i82365SL PC Card Interface Controller, 7D-243 pckt — STREAMS Packet Mode module, 7M-245 PCMCIA memory card nexus driver — pcmem, 7D-246 PCMCIA RAM memory card device driver — pcram, 7D-249 PCMCIA serial card device driver — pcser, 7D-251 pcmem — PCMCIA memory card nexus driver, 7D-246 pcn — AMD PCnet Ethernet controller device driver, 7D-247 pcram — PCMCIA RAM memory card device driver, 7D-249 pcscsi — low-level module for the AMD PCscsi, PCscsi II, and
7M-177 set keyboard “direct input” state ioctl — KIOCSDIRECT, 7M-177 set keyboard translation ioctl — KIOCTRANS, 7M-175 set LEDs ioctl — KIOCSLED, 7M-176 set/clear packet mode (pty) ioctl — TIOCPKT, 7D-268 SIOCDARP — delete arp entry, 7P-17 SIOCGARP — get arp entry, 7P-17 SIOCSARP — set arp entry, 7P-17 SMC 3032/EISA dual-channel Ethernet device driver — smce, 7D-292 SMC 8003/8013/8216/8416 Ethernet device driver — smc, 7D-289 smc — SMC 8003/8013/8216/8416 Ethernet device driver, 7D-289 SMC Elite32 Ultra (8
STREAMS modules and drivers for the Point-toPoint Protocol — ipd, 7M-260 — ipdcm, 7M-260 — ipdptp, 7M-260 — ppp, 7M-260 — ppp_diag, 7M-260 STREAMS Packet Filter Module — pfmod, 7M-255 STREAMS Packet Mode module — pckt, 7M-245 STREAMS pipe flushing module — pipemod, 7M-258 STREAMS Pseudo Terminal Emulation module — ptem, 7M-262 STREAMS pseudo-tty slave driver — pts, 7D-265 SunButtons and SunDials STREAMS module — bd, 7M-38 system console display — display, 7D-77 system console keyboard — keyboard, 7D-179 T
vuidm5p — converts mouse protocol to Firm Events, 7M-397 vuidmice — converts mouse protocol to Firm Events, 7M-397 W workstation console — wscons, 7D-399 X xd — Xylogics SMD Disk driver XENIX compatibility module — ttcompat, 7M-384 xt — Xylogics 472 1/2-inch tape drive xy — Xylogics SMD Disk driver Xylogics 472 1/2-inch tape drive — xt Xylogics SMD Disk driver — xd, 7D-406 thru 7D-411 Z zero — source of zeroes, 7D-412 Zilog 8530 SCC serial communications driver — zs zs — zilog 8530 SCC serial communicati
