man pages section 7 Device and Network Interfacesidn(7d).....346 iec61883(7I).....349

man pages section 7: Device and NetworkInterfacesBeta

Part No: 821–1475–06November 2010

Copyright © 2010, Oracle and/or its affiliates. All rights reserved.

This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectualproperty laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license,transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software,unless required by law for interoperability, is prohibited.

The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing.

If this is software or related software documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, the followingnotice is applicable:

U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are“commercial computer software” or “commercial technical data” pursuant to the applicable Federal Acquisition Regulation and agency-specific supplementalregulations. As such, the use, duplication, disclosure, modification, and adaptation shall be subject to the restrictions and license terms set forth in the applicableGovernment contract, and, to the extent applicable by the terms of the Government contract, the additional rights set forth in FAR 52.227-19, CommercialComputer Software License (December 2007). Oracle America, Inc., 500 Oracle Parkway, Redwood City, CA 94065.

This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherentlydangerous applications, including applications which may create a risk of personal injury. If you use this software or hardware in dangerous applications, then youshall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim anyliability for any damages caused by use of this software or hardware in dangerous applications.

Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.

AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. Intel and Intel Xeon aretrademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARCInternational, Inc. UNIX is a registered trademark licensed through X/Open Company, Ltd.

This software or hardware and documentation may provide access to or information on content, products, and services from third parties. Oracle Corporation andits affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services. Oracle Corporationand its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services.

110425@25097

Contents

Preface ...................................................................................................................................................15

Introduction .........................................................................................................................................19Intro(7) ................................................................................................................................................ 20

Device and Network Interfaces .........................................................................................................23aac(7D) ................................................................................................................................................. 24adp(7D) ................................................................................................................................................. 25adpu320(7D) ........................................................................................................................................ 27afb(7d) .................................................................................................................................................. 29afe(7D) ................................................................................................................................................. 30agpgart_io(7I) .................................................................................................................................... 32ahci(7D) ............................................................................................................................................... 43amd8111s(7D) ...................................................................................................................................... 44amr(7D) ................................................................................................................................................. 45arcmsr(7D) .......................................................................................................................................... 46arn(7D) ................................................................................................................................................. 48arp(7P) .................................................................................................................................................. 49asy(7D) ................................................................................................................................................. 54ata(7D) ................................................................................................................................................. 57atge(7D) ............................................................................................................................................... 62ath(7D) ................................................................................................................................................. 63atu(7D) ................................................................................................................................................. 64audio1575(7D) .................................................................................................................................... 65audio(7D) ............................................................................................................................................. 66audio(7I) .............................................................................................................................................. 69audio810(7D) ...................................................................................................................................... 80

3

audiocmi(7D) ...................................................................................................................................... 81audiocs(7D) ........................................................................................................................................ 82audioemu10k(7D) ................................................................................................................................ 83audioens(7D) ...................................................................................................................................... 84audiohd(7D) ........................................................................................................................................ 85audioixp(7D) ...................................................................................................................................... 86audiols(7D) ........................................................................................................................................ 87audiop16x(7D) .................................................................................................................................... 88audiopci(7D) ...................................................................................................................................... 89audiosolo(7D) .................................................................................................................................... 90audiots(7D) ........................................................................................................................................ 91audiovia823x(7D) .............................................................................................................................. 92audiovia97(7D) .................................................................................................................................. 93av1394(7D) .......................................................................................................................................... 94bbc_beep(7D) ...................................................................................................................................... 95bcm_sata(7D) ...................................................................................................................................... 96bfe(7D) ................................................................................................................................................. 97bge(7D) ................................................................................................................................................. 98blkdev(7D) ........................................................................................................................................ 101bnx(7D) ............................................................................................................................................... 102bnxe(7D) ............................................................................................................................................. 106bpf(7D) ............................................................................................................................................... 111bscv(7D) ............................................................................................................................................. 121bufmod(7M) ........................................................................................................................................ 122cadp160(7D) ...................................................................................................................................... 126cadp(7D) ............................................................................................................................................. 127cdio(7I) .............................................................................................................................................. 131ce(7D) ................................................................................................................................................. 139chxge(7D) ........................................................................................................................................... 143cmdk(7D) ............................................................................................................................................. 144connld(7M) ........................................................................................................................................ 146console(7D) ...................................................................................................................................... 148cpqary3(7D) ...................................................................................................................................... 149cpr(7) .................................................................................................................................................. 151cpuid(7D) ........................................................................................................................................... 153ctfs(7FS) ........................................................................................................................................... 156

Contents

man pages section 7: Device and Network Interfaces • November 2010 (Beta)4

ctsmc(7D) ........................................................................................................................................... 157cvc(7D) ............................................................................................................................................... 158cvcredir(7D) .................................................................................................................................... 159dad(7D) ............................................................................................................................................... 160daplt(7D) ........................................................................................................................................... 163dca(7D) ............................................................................................................................................... 164dcam1394(7D) .................................................................................................................................... 166dcfs(7FS) ........................................................................................................................................... 175dev(7FS) .............................................................................................................................................. 176devfs(7FS) ......................................................................................................................................... 177devinfo(7D) ...................................................................................................................................... 178dkio(7I) .............................................................................................................................................. 179dlcosmk(7ipp) .................................................................................................................................... 191dlpi(7P) ............................................................................................................................................. 192dm2s(7D) ............................................................................................................................................. 201dmfe(7D) ............................................................................................................................................. 202dnet(7D) ............................................................................................................................................. 204dpt(7D) ............................................................................................................................................... 206dr(7d) .................................................................................................................................................. 208dscpmk(7ipp) ...................................................................................................................................... 209dsp(7I) ................................................................................................................................................. 210dtrace(7D) ........................................................................................................................................ 218e1000g(7D) ........................................................................................................................................ 219ecpp(7D) ............................................................................................................................................. 224ehci(7D) ............................................................................................................................................. 230eiob(7D) ............................................................................................................................................. 234elxl(7D) ............................................................................................................................................. 236emlxs(7D) ........................................................................................................................................... 238eri(7D) ............................................................................................................................................... 239fas(7D) ............................................................................................................................................... 243fasttrap(7D) .................................................................................................................................... 252fbio(7I) .............................................................................................................................................. 253fbt(7D) ............................................................................................................................................... 255fcip(7D) ............................................................................................................................................. 256fcoe(7D) ............................................................................................................................................. 259fcoei(7D) ........................................................................................................................................... 260

Contents

5

fcoet(7D) ........................................................................................................................................... 261fcp(7D) ............................................................................................................................................... 262fctl(7D) ............................................................................................................................................. 263fd(7D) ................................................................................................................................................. 264fdio(7I) .............................................................................................................................................. 269ffb(7D) ............................................................................................................................................... 273flowacct(7ipp) .................................................................................................................................. 274fp(7d) .................................................................................................................................................. 275FSS(7) .................................................................................................................................................. 277ge(7D) ................................................................................................................................................. 280gld(7D) ............................................................................................................................................... 284glm(7D) ............................................................................................................................................... 293gpio_87317(7D) ................................................................................................................................ 299grbeep(7d) ......................................................................................................................................... 300hci1394(7D) ...................................................................................................................................... 301hdio(7I) .............................................................................................................................................. 302heci(7D) ............................................................................................................................................. 304hermon(7D) ........................................................................................................................................ 305hid(7D) ............................................................................................................................................... 307hme(7D) ............................................................................................................................................... 310hpfc(7D) ............................................................................................................................................. 315hsfs(7FS) ........................................................................................................................................... 317hubd(7D) ............................................................................................................................................. 321hwahc(7D) ........................................................................................................................................... 324hwarc(7D) ........................................................................................................................................... 325hxge(7D) ............................................................................................................................................. 326i915(7d) .............................................................................................................................................. 329ib(7D) ................................................................................................................................................. 330ibcm(7D) ............................................................................................................................................. 333ibdm(7D) ............................................................................................................................................. 334ibdma(7D) ........................................................................................................................................... 335ibmf(7) ................................................................................................................................................ 336ibp(7D) ............................................................................................................................................... 337ibtl(7D) ............................................................................................................................................. 341icmp6(7P) ........................................................................................................................................... 342icmp(7P) ............................................................................................................................................. 344

Contents


idn(7d) ................................................................................................................................................ 346iec61883(7I) ...................................................................................................................................... 349ieee1394(7D) .................................................................................................................................... 358ifb(7d) ................................................................................................................................................ 360ifp(7D) ............................................................................................................................................... 361if_tcp(7P) ......................................................................................................................................... 365igb(7D) ............................................................................................................................................... 374ii(7D) ................................................................................................................................................. 377inet6(7P) ........................................................................................................................................... 379inet(7P) ............................................................................................................................................. 384ip6(7P) ................................................................................................................................................ 387ip(7P) .................................................................................................................................................. 395ipge(7D) ............................................................................................................................................. 403ipgpc(7ipp) ........................................................................................................................................ 407ipnat(7I) ............................................................................................................................................ 409ipnet(7D) ........................................................................................................................................... 416ipqos(7ipp) ........................................................................................................................................ 418iprb(7D) ............................................................................................................................................. 420ipsec(7P) ........................................................................................................................................... 423ipsecah(7P) ....................................................................................................................................... 427ipsecesp(7P) ..................................................................................................................................... 428ipw(7D) ............................................................................................................................................... 429iscsi(7D) ........................................................................................................................................... 430isdnio(7I) .......................................................................................................................................... 431iser(7D) ............................................................................................................................................. 446isp(7D) ............................................................................................................................................... 447iwh(7D) ............................................................................................................................................... 453iwi(7D) ............................................................................................................................................... 454iwk(7D) ............................................................................................................................................... 455iwp(7D) ............................................................................................................................................... 456ixgb(7d) .............................................................................................................................................. 457ixgbe(7D) ........................................................................................................................................... 459jfb(7D) ............................................................................................................................................... 461kb(7M) ................................................................................................................................................ 462kdmouse(7D) ...................................................................................................................................... 471kfb(7D) ............................................................................................................................................... 472

Contents

7

kmdb(7d) .............................................................................................................................................. 473kstat(7D) ........................................................................................................................................... 474ksyms(7D) ........................................................................................................................................... 475ldterm(7M) ........................................................................................................................................ 477llc1(7D) ............................................................................................................................................. 480llc2(7D) ............................................................................................................................................. 483lockstat(7D) .................................................................................................................................... 490lofi(7D) ............................................................................................................................................. 491lofs(7FS) ........................................................................................................................................... 493log(7D) ............................................................................................................................................... 495lp(7D) ................................................................................................................................................. 499lsimega(7D) ...................................................................................................................................... 501m64(7D) ............................................................................................................................................... 502marvell88sx(7D) .............................................................................................................................. 503mc-opl(7D) ........................................................................................................................................ 507mcxe(7D) ............................................................................................................................................. 508md(7D) ................................................................................................................................................. 510mediator(7D) .................................................................................................................................... 514mega_sas(7D) .................................................................................................................................... 517mem(7D) ............................................................................................................................................... 519mhd(7i) ................................................................................................................................................. 520mixer(7I) ............................................................................................................................................ 525mpt(7D) ............................................................................................................................................... 536mpt_sas(7D) ...................................................................................................................................... 542mr_sas(7D) ........................................................................................................................................ 543msglog(7D) ........................................................................................................................................ 545mt(7D) ................................................................................................................................................. 546mtio(7I) .............................................................................................................................................. 547mwl(7D) ............................................................................................................................................... 561mxfe(7D) ............................................................................................................................................. 562myri10ge(7D) .................................................................................................................................... 563n2cp(7d) .............................................................................................................................................. 565n2rng(7d) ........................................................................................................................................... 567ncp(7D) ............................................................................................................................................... 569ncrs(7D) ............................................................................................................................................. 571nfb(7D) ............................................................................................................................................... 578

Contents


nge(7D) ............................................................................................................................................... 579npe(7D) ............................................................................................................................................... 583ntwdt(7D) ........................................................................................................................................... 584ntxn(7D) ............................................................................................................................................. 585null(7D) ............................................................................................................................................. 587nulldriver(7D) ................................................................................................................................ 588nv_sata(7D) ...................................................................................................................................... 589nxge(7D) ............................................................................................................................................. 590objfs(7FS) ......................................................................................................................................... 593oce(7D) ............................................................................................................................................... 594ohci(7D) ............................................................................................................................................. 595openprom(7D) .................................................................................................................................... 597oplkmdrv(7D) .................................................................................................................................... 603oplmsu(7D) ........................................................................................................................................ 604oplpanel(7D) .................................................................................................................................... 605packet(7P) ......................................................................................................................................... 606pcan(7D) ............................................................................................................................................. 609pcata(7D) ........................................................................................................................................... 610pcfs(7FS) ........................................................................................................................................... 612pcic(7D) ............................................................................................................................................. 618pcicmu(7D) ........................................................................................................................................ 619pcie_pci(7D) .................................................................................................................................... 620pcipsy(7D) ........................................................................................................................................ 621pcisch(7D) ........................................................................................................................................ 622pckt(7M) ............................................................................................................................................ 623pcmcia(7D) ........................................................................................................................................ 624pcn(7D) ............................................................................................................................................... 625pcser(7D) ........................................................................................................................................... 627pcwl(7D) ............................................................................................................................................. 629pfb(7D) ............................................................................................................................................... 630pf_key(7P) ......................................................................................................................................... 631pfmod(7M) .......................................................................................................................................... 645physmem(7D) ...................................................................................................................................... 649pipemod(7M) ...................................................................................................................................... 650pm(7D) ................................................................................................................................................. 651poll(7d) .............................................................................................................................................. 657

Contents

9

prnio(7I) ............................................................................................................................................ 663profile(7D) ...................................................................................................................................... 668ptem(7M) ............................................................................................................................................ 669ptm(7D) ............................................................................................................................................... 670pts(7D) ............................................................................................................................................... 672pty(7D) ............................................................................................................................................... 674qfe(7d) ................................................................................................................................................ 677qlc(7D) ............................................................................................................................................... 681qlge(7D) ............................................................................................................................................. 683quotactl(7I) ...................................................................................................................................... 684qus(7D) ............................................................................................................................................... 686radeon(7d) ......................................................................................................................................... 693ral(7D) ............................................................................................................................................... 694ramdisk(7D) ...................................................................................................................................... 695random(7D) ........................................................................................................................................ 697rarp(7P) ............................................................................................................................................. 699rge(7D) ............................................................................................................................................... 700route(7P) ........................................................................................................................................... 702routing(7P) ....................................................................................................................................... 707rtls(7D) ............................................................................................................................................. 709rtw(7D) ............................................................................................................................................... 710rum(7D) ............................................................................................................................................... 711rwd(7D) ............................................................................................................................................... 712rwn(7D) ............................................................................................................................................... 713sad(7D) ............................................................................................................................................... 714sata(7D) ............................................................................................................................................. 717scfd(7D) ............................................................................................................................................. 720schpc(7D) ........................................................................................................................................... 721scsa1394(7D) .................................................................................................................................... 722scsa2usb(7D) .................................................................................................................................... 725scsi_vhci(7D) .................................................................................................................................. 730sctp(7P) ............................................................................................................................................. 733sd(7D) ................................................................................................................................................. 739sda(7D) ............................................................................................................................................... 746SDC(7) .................................................................................................................................................. 747sdcard(7D) ........................................................................................................................................ 748

Contents


sdhost(7D) ........................................................................................................................................ 750sdp(7D) ............................................................................................................................................... 751sdt(7D) ............................................................................................................................................... 754se(7D) ................................................................................................................................................. 755se_hdlc(7D) ...................................................................................................................................... 759ses(7D) ............................................................................................................................................... 762sesio(7I) ............................................................................................................................................ 764sf(7D) ................................................................................................................................................. 766sfe(7D) ............................................................................................................................................... 769sgen(7D) ............................................................................................................................................. 771sharefs(7FS) ..................................................................................................................................... 776si3124(7D) ........................................................................................................................................ 777sip(7P) ................................................................................................................................................ 778sk98sol(7D) ...................................................................................................................................... 779skfp(7D) ............................................................................................................................................. 785slp(7P) ................................................................................................................................................ 787smbfs(7FS) ......................................................................................................................................... 789smbios(7D) ........................................................................................................................................ 791smbus(7D) ........................................................................................................................................... 792smp(7D) ............................................................................................................................................... 793socal(7D) ........................................................................................................................................... 794sockio(7I) .......................................................................................................................................... 796sol_ofs(7D) ...................................................................................................................................... 797sol_ucma(7D) .................................................................................................................................... 798sol_umad(7D) .................................................................................................................................... 799sol_uverbs(7D) ................................................................................................................................ 800sppptun(7M) ...................................................................................................................................... 801srpt(7D) ............................................................................................................................................. 802ssd(7D) ............................................................................................................................................... 803st(7D) ................................................................................................................................................. 808streamio(7I) ...................................................................................................................................... 826su(7D) ................................................................................................................................................. 841sv(7D) ................................................................................................................................................. 844symhisl(7D) ...................................................................................................................................... 845sysmsg(7D) ........................................................................................................................................ 848systrace(7D) .................................................................................................................................... 849

Contents

11

tavor(7D) ........................................................................................................................................... 850tcp(7P) ................................................................................................................................................ 852termio(7I) .......................................................................................................................................... 859termiox(7I) ........................................................................................................................................ 880ticlts(7D) ........................................................................................................................................ 886timod(7M) .......................................................................................................................................... 888tirdwr(7M) ........................................................................................................................................ 890tmpfs(7FS) ......................................................................................................................................... 892todopol(7D) ...................................................................................................................................... 894tokenmt(7ipp) .................................................................................................................................... 895tpf(7D) ............................................................................................................................................... 898tsalarm(7D) ...................................................................................................................................... 899tswtclmt(7ipp) .................................................................................................................................. 903ttcompat(7M) .................................................................................................................................... 904tty(7D) ............................................................................................................................................... 912ttymux(7D) ........................................................................................................................................ 913tzmon(7d) ........................................................................................................................................... 914uata(7D) ............................................................................................................................................. 915uath(7D) ............................................................................................................................................. 918udfs(7FS) ........................................................................................................................................... 919udp(7P) ................................................................................................................................................ 920ufs(7FS) .............................................................................................................................................. 923ugen(7D) ............................................................................................................................................. 926uhci(7D) ............................................................................................................................................. 949ural(7D) ............................................................................................................................................. 950urtw(7D) ............................................................................................................................................. 951usba(7D) ............................................................................................................................................. 952usb_ac(7D) ........................................................................................................................................ 955usb_ah(7M) ........................................................................................................................................ 957usb_as(7D) ........................................................................................................................................ 958usbecm(7D) ........................................................................................................................................ 960usbftdi(7D) ...................................................................................................................................... 961usb_ia(7D) ........................................................................................................................................ 964usbkbm(7M) ........................................................................................................................................ 965usb_mid(7D) ...................................................................................................................................... 967usbms(7M) .......................................................................................................................................... 969

Contents


usbprn(7D) ........................................................................................................................................ 973usbsacm(7D) ...................................................................................................................................... 978usbser_edge(7D) .............................................................................................................................. 981usbsksp(7D) ...................................................................................................................................... 984usbsprl(7D) ...................................................................................................................................... 987usbvc(7D) ........................................................................................................................................... 990usbwcm(7M) ........................................................................................................................................ 994uscsi(7I) ............................................................................................................................................ 996usmp(7I) ............................................................................................................................................ 1000usoc(7D) ........................................................................................................................................... 1002uwba(7D) ........................................................................................................................................... 1004virtualkm(7D) ................................................................................................................................ 1005visual_io(7I) .................................................................................................................................. 1008vni(7d) .............................................................................................................................................. 1015vr(7D) ............................................................................................................................................... 1016vt(7I) ................................................................................................................................................. 1018vuidmice(7M) .................................................................................................................................. 1023wpi(7D) ............................................................................................................................................. 1026wscons(7D) ...................................................................................................................................... 1027wusb_ca(7D) .................................................................................................................................... 1037wusb_df(7D) .................................................................................................................................... 1038xge(7D) ............................................................................................................................................. 1039yge(7D) ............................................................................................................................................. 1041zcons(7D) ......................................................................................................................................... 1043zero(7D) ........................................................................................................................................... 1044zs(7D) ............................................................................................................................................... 1045zsh(7D) ............................................................................................................................................. 1048zulu(7d) ............................................................................................................................................ 1052zyd(7D) ............................................................................................................................................. 1053

Contents

13

Preface

Both novice users and those familar with the SunOS operating system can use online man pagesto obtain information about the system and its features. A man page is intended to answerconcisely the question “What does it do?” The man pages in general comprise a referencemanual. They are not intended to be a tutorial.

OverviewThe following contains a brief description of each man page section and the information itreferences:

■ Section 1 describes, in alphabetical order, commands available with the operating system.■ Section 1M describes, in alphabetical order, commands that are used chiefly for system

maintenance and administration purposes.■ Section 2 describes all of the system calls. Most of these calls have one or more error returns.

An error condition is indicated by an otherwise impossible returned value.■ Section 3 describes functions found in various libraries, other than those functions that

directly invoke UNIX system primitives, which are described in Section 2.■ 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.■ 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 callsare also described.

■ Section 9E describes the DDI (Device Driver Interface)/DKI (Driver/Kernel Interface),DDI-only, and DKI-only entry-point routines a developer can include in a device driver.

■ Section 9F describes the kernel functions available for use by device drivers.■ Section 9S describes the data structures used by drivers to share information between the

driver and the kernel.

Below is a generic format for man pages. The man pages of each manual section generallyfollow this order, but include only needed headings. For example, if there are no bugs to report,

15

there is no BUGS section. See the intro pages for more information and detail about eachsection, and man(1) for more information about man pages in general.

NAME This section gives the names of the commands or functionsdocumented, followed by a brief description of what theydo.

SYNOPSIS This section shows the syntax of commands or functions.When a command or file does not exist in the standardpath, its full path name is shown. Options and argumentsare alphabetized, with single letter arguments first, andoptions with arguments next, unless a different argumentorder is required.

The following special characters are used in this section:

[ ] Brackets. The option or argument enclosed inthese brackets is optional. If the brackets areomitted, the argument must be specified.

. . . Ellipses. Several values can be provided for theprevious argument, or the previous argumentcan be specified multiple times, for example,"filename . . ." .

| Separator. Only one of the argumentsseparated by this character can be specified at atime.

{ } Braces. The options and/or argumentsenclosed within braces are interdependent,such that everything enclosed must be treatedas a unit.

PROTOCOL This section occurs only in subsection 3R to indicate theprotocol description file.

DESCRIPTION This section defines the functionality and behavior of theservice. Thus it describes concisely what the commanddoes. It does not discuss OPTIONS or cite EXAMPLES.Interactive commands, subcommands, requests, macros,and functions are described under USAGE.

IOCTL This section appears on pages in Section 7 only. Only thedevice class that supplies appropriate parameters to theioctl(2) system call is called ioctl and generates its ownheading. ioctl calls for a specific device are listedalphabetically (on the man page for that specific device).

Preface


http://www.oracle.com/pls/topic/lookup?ctx=821-1461&id=man-1http://www.oracle.com/pls/topic/lookup?ctx=821-1463&id=ioctl-2

ioctl calls are used for a particular class of devices all ofwhich have an io ending, such as mtio(7I).

OPTIONS This secton lists the command options with a concisesummary of what each option does. The options are listedliterally and in the order they appear in the SYNOPSISsection. Possible arguments to options are discussed underthe option, and where appropriate, default values aresupplied.

OPERANDS This section lists the command operands and describeshow they affect the actions of the command.

OUTPUT This section describes the output – standard output,standard error, or output files – generated by thecommand.

RETURN VALUES If the man page documents functions that return values,this section lists these values and describes the conditionsunder which they are returned. If a function can returnonly constant values, such as 0 or –1, these values are listedin tagged paragraphs. Otherwise, a single paragraphdescribes the return values of each function. Functionsdeclared void do not return values, so they are notdiscussed in RETURN VALUES.

ERRORS On failure, most functions place an error code in the globalvariable errno indicating why they failed. This section listsalphabetically all error codes a function can generate anddescribes the conditions that cause each error. When morethan one condition can cause the same error, eachcondition is described in a separate paragraph under theerror code.

USAGE This section lists special rules, features, and commandsthat require in-depth explanations. The subsections listedhere are used to explain built-in functionality:

CommandsModifiersVariablesExpressionsInput Grammar

EXAMPLES This section provides examples of usage or of how to use acommand or function. Wherever possible a complete

Preface

17

example including command-line entry and machineresponse is shown. Whenever an example is given, theprompt is shown as example%, or if the user must besuperuser, example#. Examples are followed byexplanations, variable substitution rules, or returnedvalues. Most examples illustrate concepts from theSYNOPSIS, DESCRIPTION, OPTIONS, and USAGEsections.

ENVIRONMENT VARIABLES This section lists any environment variables that thecommand or function affects, followed by a briefdescription of the effect.

EXIT STATUS This section lists the values the command returns to thecalling program or shell and the conditions that cause thesevalues to be returned. Usually, zero is returned forsuccessful completion, and values other than zero forvarious error conditions.

FILES This section lists all file names 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.

ATTRIBUTES This section lists characteristics of commands, utilities,and device drivers by defining the attribute type and itscorresponding value. See attributes(5) for moreinformation.

SEE ALSO This section lists references to other man pages, in-housedocumentation, and outside publications.

DIAGNOSTICS This section lists diagnostic messages with a briefexplanation of the condition causing the error.

WARNINGS This section lists warnings about special conditions whichcould seriously affect your working conditions. This is nota list of diagnostics.

NOTES This section lists additional information that does notbelong anywhere else on the page. It takes the form of anaside to the user, covering points of special interest.Critical information is never covered here.

BUGS This section describes known bugs and, wherever possible,suggests workarounds.

Preface


http://www.oracle.com/pls/topic/lookup?ctx=821-1474&id=attributes-5

Introduction

R E F E R E N C E

19

Intro – introduction to special files

This section describes various device and network interfaces available on the system. Thetypes of interfaces described include character and block devices, STREAMS modules,network protocols, file systems, and ioctl requests for driver subsystems and classes.

This section contains the following major collections:

(7D) The system provides drivers for a variety of hardware devices, such as disk,magnetic tapes, serial communication lines, mice, and frame buffers, as well asvirtual devices such as pseudo-terminals and windows.

This section describes special files that refer to specific hardware peripherals anddevice drivers. STREAMS device drivers are also described. Characteristics of boththe hardware device and the corresponding device driver are discussed whereapplicable.

An application accesses a device through that device's special file. This sectionspecifies the device special file to be used to access the device as well as applicationprogramming interface (API) information relevant to the use of the device driver.

All device special files are located under the /devices directory. The /devicesdirectory hierarchy attempts to mirror the hierarchy of system busses, controllers,and devices configured on the system. Logical device names for special files in/devices are located under the /dev directory. Although not every special fileunder /devices will have a corresponding logical entry under /dev, wheneverpossible, an application should reference a device using the logical name for thedevice. Logical device names are listed in the FILES section of the page for the devicein question.

This section also describes driver configuration where applicable. Many devicedrivers have a driver configuration file of the form driver_name.conf associatedwith them (see driver.conf(4)). The configuration information stored in the driverconfiguration file is used to configure the driver and the device. Driverconfiguration files are located in /kernel/drv and /usr/kernel/drv. Driverconfiguration files for platform dependent drivers are located in /platform/‘uname-i‘/kernel/drv where ‘uname -i‘ is the output of the uname(1) command with the-i option.

Some driver configuration files may contain user configurable properties. Changesin a driver's configuration file will not take effect until the system is rebooted or thedriver has been removed and re-added (see rem_drv(1M) and add_drv(1M)).

(7FS) This section describes the programmatic interface for several file systems supportedby SunOS.

Name

Description

Intro(7)

man pages section 7: Device and Network Interfaces • Last Revised 29 Sep 199420

http://www.oracle.com/pls/topic/lookup?ctx=821-1473&id=driver.conf-4http://www.oracle.com/pls/topic/lookup?ctx=821-1461&id=uname-1http://www.oracle.com/pls/topic/lookup?ctx=821-1462&id=rem-drv-1mhttp://www.oracle.com/pls/topic/lookup?ctx=821-1462&id=add-drv-1m

(7I) This section describes ioctl requests which apply to a class of drivers or subsystems.For example, ioctl requests which apply to most tape devices are discussed inmtio(7I). Ioctl requests relevant to only a specific device are described on the manpage for that device. The page for the device in question should still be examined forexceptions to the ioctls listed in section 7I.

(7M) This section describes STREAMS modules. Note that STREAMS drivers arediscussed in section 7D. streamio(7I) contains a list of ioctl requests used tomanipulate STREAMS modules and interface with the STREAMS framework. Ioctlrequests specific to a STREAMS module will be discussed on the man page for thatmodule.

(7P) This section describes various network protocols available in SunOS.

SunOS supports both socket-based and STREAMS-based networkcommunications. The Internet protocol family, described in inet(7P), is theprimary protocol family supported by SunOS, although the system can support anumber of others. The raw interface provides low-level services, such as packetfragmentation and reassembly, routing, addressing, and basic transport forsocket-based implementations. Facilities for communicating using anInternet-family protocol are generally accessed by specifying the AF_INET addressfamily when binding a socket; see socket(3SOCKET) for details.

Major protocols in the Internet family include:■ The Internet Protocol (IP) itself, which supports the universal datagram format,

as described in ip(7P). This is the default protocol for SOCK_RAW type socketswithin the AF_INET domain.

■ The Transmission Control Protocol (TCP); see tcp(7P). This is the defaultprotocol for SOCK_STREAM type sockets.

■ The User Datagram Protocol (UDP); see udp(7P). This is the default protocol forSOCK_DGRAM type sockets.

■ The Address Resolution Protocol (ARP); see arp(7P).■ The Internet Control Message Protocol (ICMP); see icmp(7P).

add_drv(1M), rem_drv(1M), Intro(3), ioctl(2), socket(3SOCKET), driver.conf(4),arp(7P), icmp(7P), inet(7P), ip(7P), mtio(7I), st(7D), streamio(7I), tcp(7P), udp(7P)

System Administration Guide: IP Services

STREAMS Programming Guide

Writing Device Drivers

See Also

Intro(7)

Introduction 21

http://www.oracle.com/pls/topic/lookup?ctx=821-1466&id=socket-3sockethttp://www.oracle.com/pls/topic/lookup?ctx=821-1462&id=add-drv-1mhttp://www.oracle.com/pls/topic/lookup?ctx=821-1462&id=rem-drv-1mhttp://www.oracle.com/pls/topic/lookup?ctx=821-1464&id=intro-3http://www.oracle.com/pls/topic/lookup?ctx=821-1463&id=ioctl-2http://www.oracle.com/pls/topic/lookup?ctx=821-1466&id=socket-3sockethttp://www.oracle.com/pls/topic/lookup?ctx=821-1473&id=driver.conf-4http://www.oracle.com/pls/topic/lookup?ctx=821-1453&id=sysadv3http://www.oracle.com/pls/topic/lookup?ctx=816-4855&id=streamshttp://www.oracle.com/pls/topic/lookup?ctx=819-3196&id=driver

Device and Network Interfaces

R E F E R E N C E

23

aac – SCSI HBA driver for Adaptec AdvancedRAID Controller

The aac plain SCSI host bus adapter driver is a SCSA-compliant nexus driver that supports theAdaptec 2200S/2120S SCSI RAID card, Dell PERC 3Di SCSI RAID controller, Dell PERC 3SiSCSI RAID controller, Adaptec 2820SA SATA RAID card, Adaptec 4800SAS, 4805SAS SASRAID cards and SUN's STK RAID REM, STK RAID INT, and STK RAID EXT RAID cards.

The aac driver is ported from FreeBSD and supports RAID disk I/O functions and the RAIDmanagement interface.

There are no user configurable parameters available. Please configure your hardware throughBIOS.

See attributes(5) for a description of the following attributes:

ATTRIBUTE TYPE ATTRIBUTE VALUE

Availability x86, SPARC (Limited to systems with AAC hardwareRAID cards.)

/kernel/drv/aac 32-bit ELF kernel module.

/kernel/drv/amd64/aac 64-bit ELF kernel module. (x86)

/kernel/drv/sparcv9/aac 64-bit ELF kernel module. (SPARC)

/kernel/drv/aac.conf Configuration file. (Contains no user-configurable options).

prtconf(1M), attributes(5), scsi_hba_attach(9F), scsi_sync_pkt(9F),scsi_transport(9F), scsi_device(9S), scsi_inquiry(9S), scsi_pkt(9S)

Small Computer System Interface-2 (SCSI-2)

Name

Description

DriverConfiguration

Attributes

Files

See Also

aac(7D)

man pages section 7: Device and Network Interfaces • Last Revised 27 Dec 200724

http://www.oracle.com/pls/topic/lookup?ctx=821-1474&id=attributes-5http://www.oracle.com/pls/topic/lookup?ctx=821-1462&id=prtconf-1mhttp://www.oracle.com/pls/topic/lookup?ctx=821-1474&id=attributes-5http://www.oracle.com/pls/topic/lookup?ctx=821-1477&id=scsi-hba-attach-9fhttp://www.oracle.com/pls/topic/lookup?ctx=821-1477&id=scsi-sync-pkt-9fhttp://www.oracle.com/pls/topic/lookup?ctx=821-1477&id=scsi-transport-9fhttp://www.oracle.com/pls/topic/lookup?ctx=821-1478&id=scsi-device-9shttp://www.oracle.com/pls/topic/lookup?ctx=821-1478&id=scsi-inquiry-9shttp://www.oracle.com/pls/topic/lookup?ctx=821-1478&id=scsi-pkt-9s

adp – Low-level module for controllers based on Adaptec AIC-7870P and AIC-7880P SCSIchips

The adp module provides low-level interface routines between the common disk/tape I/Osystem and SCSI (Small Computer System Interface) controllers based on the AdaptecAIC-7870P and AIC-7880P SCSI chips. These controllers include the Adaptec AHA–2940,AHA–2940W, AHA–2940U, AHA–2940UW, AHA–3940, and AHA–3940W, as well asmotherboards with embedded AIC-7870P and AIC-7880P SCSI chips.

Supported devices are AIC-7850, AIC-7860, AIC-7870, AIC-7880 and AIC-7895.

The adp module can be configured for disk and streaming tape support for one or more hostadapter boards, each of which must be the sole initiator on a SCSI bus. Auto-configurationcode determines if the adapter is present at the configured address and what types of devicesare attached to the adapter.

The Plug N Play SCAM Support option is not supported.

■ To use the AHA-3940 or AHA-3940W adapters, the motherboard must have a BIOS thatsupports the DEC PCI-to-PCI Bridge chip on the host bus adapter.

■ User-level programs have exhibited problems on some PCI systems with an AdaptecAHA-2940 or AHA-2940W card and certain motherboards. If problems with user-levelprograms occur, use the BIOS setup to disable write-back CPU caching (or all caching ifthere is no control over the caching algorithm). The affected motherboards are:

- PCI motherboards with a 60-MHz Pentium chip, with PCI chipset numbers S82433LX Z852and S82434LX Z850. The part numbers of the Intel motherboards are AA616393-007 andAA615988-009.- PCI motherboards with a 90-MHz Pentium chip, with PCI chipset numbers S82433NXZ895, S82434NX Z895, and S82434NX Z896. The part number of the Intel motherboard is541286-005. (Some Gateway 2000 systems use this motherboard.)- AA-619772-002 motherboard with 82433LX Z852 and 82434LX Z882 chips causes randommemory inconsistencies. Return the motherboard to the vendor for a replacement.

■ If the AHA-2940 SCSI adapter does not recognize the Quantum Empire 1080S, HP 3323SE or other SCSI disk drive, reduce the Synchronous Transfer rate on the Adapteccontroller to 8 Mbps.

■ The AHA-3940 has been certified by Adaptec to work on specific systems; however, sometesting has shown that the Solaris operating environment works properly in some of thosesystems and not in others.

Use the Adaptec configuration utility to perform the following steps:

Name

Description

Preconfigure

Known Problems andLimitations

Configuration

adp(7D)

Device and Network Interfaces 25

■ Configure each SCSI device to have a unique SCSI ID, then using the adapter's AdvancedConfiguration Options setup menu, set the Plug N Play SCAM Support option toDisabled.

■ If there is more than one controller (or an embedded controller), try to use one IRQ percontroller.

■ Enable bus mastering for the slots with your host bus adapters, when the choice is given.■ For older disk drives, tape drives, and most CD-ROM devices, make sure the maximum

SCSI data transfer speed is set to 5.0 Mbps.■ Enable support for disks larger than 1 Gbyte if applicable.

/kernel/drv/adp.conf Configuration file for the adp driver; there are nouser-configurable options in this file

See attributes(5) for descriptions of the following attributes:


Architecture x86

attributes(5)

Solaris (Intel Platform Edition) Hardware Compatibility List

Throughout the release, support of additional devices may be added. See the Solaris (IntelPlatform Edition) Hardware Compatibility List for additional information.

The adp driver supports Logical Unit Number (“LUN”) values of 0 through 15. This rangeexceeds the standard SCSI-2 requirements which call for support of LUNs 0 through 7.

Files

Attributes

See Also

Notes

adp(7D)

man pages section 7: Device and Network Interfaces • Last Revised 10 Oct 200026

http://www.oracle.com/pls/topic/lookup?ctx=821-1474&id=attributes-5http://www.oracle.com/pls/topic/lookup?ctx=821-1474&id=attributes-5

adpu320 – Adaptec Ultra320 SCSI host bus adapter driver

scsi@unit-address

The adpu320 host bus adapter driver is a SCSA-compliant nexus driver that supports thefollowing Adaptec Ultra320 SCSI Devices:

Chips AIC-7902

The adpu320 driver supports standard functions provided by the SCSA interface, includingtagged and untagged queuing, Wide/Fast/Ultra SCSI, and auto request sense. The adpu320driver does not support linked commands. The adpu320 driver supports hot swap SCSI andhot plug PCI.

Additionally, the adpu320 driver supports the following features:

■ 64-bit addressing (Dual address Cycle)■ PCI-X v1.1 operating up to 133MHz and 64bits■ PCI bus spec v2.2 operating up to 66MHz and 64bits■ Packetized SCSI at 320 and 160 MB/s■ QAS■ DT■ 40MB/sec in single-ended mode and up to 320MB/sec transfer rate in LVD mode■ Domain Validation■ Retained Training Information (RTI)■ PCI and PCI-X Error handling

Note – The adpu320 driver does not support the HostRAID feature found on some AdaptecSCSI controllers. For adpu320 to support a Adaptec SCSI adapter with HostRAID, you mustnot use any HostRAID features.

The adpu320 host bus adapter driver is configured by defining the properties found inadpu320.conf. Properties in the adpu320.conf file that can be modified by the user include:ADPU320_SCSI_RD_STRM, ADPU320_SCSI_NLUN_SUPPORT.

-------------------------------------------------------------

Option: ADPU320_SCSI_RD_STRM=[value]

Definition: Enables/disables read streaming negotiation

for all drives.

Possible Values: 0 (off), 1 (on)

Default Value: 0 (off)

Option: ADPU320_SCSI_NLUN_SUPPORT=[value]

Definition: Enables the number of logical units to be

scanned per drive.

Possible Values: 1-64

Default Value: 64

-------------------------------------------------------------

Name

Synopsis

Description

Driver Configuration

adpu320(7D)


If you alter or add driver parameters incorrectly, you can render your system inoperable. Usedriver parameters with caution.

See attributes(5) for descriptions of the following attributes:


Availability x86

/kernel/drv/adpu320 Driver module.

/kernel/drv/amd64/adpu320 64–bit driver module.

/kernel/drv/adpu320.conf Configuration file.

cfgadm(1M), prtconf(1M), attributes(5), scsi_abort(9F), scsi_hba_attach_setup(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

Small Computer System Interface-3 (SCSI-3)

Attributes

Files

See Also

adpu320(7D)

man pages section 7: Device and Network Interfaces • Last Revised 23 May 200628

http://www.oracle.com/pls/topic/lookup?ctx=821-1474&id=attributes-5http://www.oracle.com/pls/topic/lookup?ctx=821-1462&id=cfgadm-1mhttp://www.oracle.com/pls/topic/lookup?ctx=821-1462&id=prtconf-1mhttp://www.oracle.com/pls/topic/lookup?ctx=821-1474&id=attributes-5http://www.oracle.com/pls/topic/lookup?ctx=821-1477&id=scsi-abort-9fhttp://www.oracle.com/pls/topic/lookup?ctx=821-1477&id=scsi-hba-attach-setup-9fhttp://www.oracle.com/pls/topic/lookup?ctx=821-1477&id=scsi-ifgetcap-9fhttp://www.oracle.com/pls/topic/lookup?ctx=821-1477&id=scsi-reset-9fhttp://www.oracle.com/pls/topic/lookup?ctx=821-1477&id=scsi-sync-pkt-9fhttp://www.oracle.com/pls/topic/lookup?ctx=821-1477&id=scsi-transport-9fhttp://www.oracle.com/pls/topic/lookup?ctx=821-1478&id=scsi-device-9shttp://www.oracle.com/pls/topic/lookup?ctx=821-1478&id=scsi-extended-sense-9shttp://www.oracle.com/pls/topic/lookup?ctx=821-1478&id=scsi-inquiry-9shttp://www.oracle.com/pls/topic/lookup?ctx=821-1478&id=scsi-pkt-9shttp://www.oracle.com/pls/topic/lookup?ctx=819-3196&id=driver

afb – Elite3D graphics accelerator driver

The afb driver is the device driver for the Sun Elite3D graphics accelerators. Theafbdaemonprocess loads the afb microcode at system startup time and during the resumesequence of a suspend-resume cycle.

/dev/fbs/afbn Device special file

/usr/lib/afb.ucode afb microcode

/usr/sbin/afbdaemon afb microcode loader

afbconfig(1M)

Name

Description

Files

See Also

afb(7d)


afe – ADMtek Fast Ethernet device driver

/dev/afe

The afe driver is a multi-threaded, loadable, clonable, GLD-based STREAMS driversupporting the Data Link Provider Interface dlpi(7P) on ADMtek (now Infineon) Centaurand Comet Fast Ethernet controllers.

The afe driver can be used as either a "style 1" or a "style 2" Data Link Service Provider.Physical points of attachment (PPAs) are interpreted as the instance number of the afecontroller as assigned by the Solaris operating environment.

The relevant fields returned as part of a DL_INFO_ACK response are:

■ Maximum SDU is 1500.■ Minimum SDU is 0.■ The dlsap address length is 8.■ MAC type is DL_ETHER.■ SAP length is -2. The 6–byte physical address is followed immediately by a 2–byte SAP.■ Service mode is DL_CLDLS.■ Broadcast address is the 6-byte Ethernet broadcast address (ff:ff:ff:ff:ff:ff).

If the SAP provided is zero, then IEEE 802.3 mode is assumed and outbound frames will havethe frame payload length written into the type field. Likewise, inbound frames with a SAPbetween zero and 1500 are interpreted as IEEE 802.3 frames and delivered to any streams thatare bound to SAP zero (the 802.3 SAP).

The following properties may be configured using either ndd(1M) or the afe.confconfiguration file as described by driver.conf(4):

adv_autoneg_cap

Enables (default) or disables IEEE 802.3u auto-negotiation of link speed and duplexsettings. If enabled, the device negotiates among the supported (and configured, see below)link options with the link partner. If disabled, at least one of the link options below must bespecified. The driver selects the first enabled link option according to the IEEE 802.3uspecified preferences.

adv_100T4_cap

Enables the 100 BaseT4 link option. (Note that most hardware does not support thisunusual link style. Also, this uses two pairs of wires for data, rather than one.)

adv_100fdx_cap

Enables the 100 Base TX full-duplex link option. (This is generally the fastest mode if bothlink partners support it. Most modern equipment supports this mode.)

Name

Synopsis

Description

ApplicationProgramming

Interface

Properties

afe(7D)

man pages section 7: Device and Network Interfaces • Last Revised 1 Apr 200730

http://www.oracle.com/pl

man pages section 7 Device and Network Interfacesidn(7d).....346 iec61883(7I).....349

Documents

Transcript of man pages section 7 Device and Network Interfacesidn(7d).....346 iec61883(7I).....349