man Pages(7):Device and Network Interfaces Sun Microsystems, Inc. 901 San Antonio Road Palo Alto, CA 94303-4900 U.S.A. Part No: 805-3179-10 October 1998 Copyright 1998 Sun Microsystems, Inc. 901 San Antonio Road, Palo Alto, California 94303-4900 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. Third-party software, including font technology, is copyrighted and licensed from Sun suppliers. Parts of the product may be derived from Berkeley BSD systems, licensed from the University of California. UNIX is a registered trademark in the U.S. and other countries, exclusively licensed through X/Open Company, Ltd. Sun, Sun Microsystems, the Sun logo, SunDocs, Java, the Java Coffee Cup logo, and Solaris are trademarks, registered trademarks, or service marks of Sun Microsystems, Inc. in the U.S. and other countries. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. in the U.S. and other countries. Products bearing SPARC trademarks are based upon an architecture developed by Sun Microsystems, Inc. The OPEN LOOK and SunTM Graphical User Interface was developed by Sun Microsystems, Inc. for its users and licensees. Sun acknowledges the pioneering efforts of Xerox in researching and developing the concept of visual or graphical user interfaces for the computer industry. Sun holds a non-exclusive license from Xerox to the Xerox Graphical User Interface, which license also covers Sun’s licensees who implement OPEN LOOK GUIs and otherwise comply with Sun’s written license agreements. RESTRICTED RIGHTS: Use, duplication, or disclosure by the U.S. Government is subject to restrictions of FAR 52.227–14(g)(2)(6/87) and FAR 52.227–19(6/87), or DFAR 252.227–7015(b)(6/95) and DFAR 227.7202–3(a). DOCUMENTATION IS PROVIDED “AS IS” AND ALL EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT, ARE DISCLAIMED, EXCEPT TO THE EXTENT THAT SUCH DISCLAIMERS ARE HELD TO BE LEGALLY INVALID. Copyright 1998 Sun Microsystems, Inc. 901 San Antonio Road, Palo Alto, Californie 94303-4900 Etats-Unis. Tous droits réservés. Ce produit ou document est protégé par un copyright et distribué avec des licences qui en restreignent l’utilisation, la copie, la distribution, et la décompilation. Aucune partie de ce produit ou document ne peut être reproduite sous aucune forme, par quelque moyen que ce soit, sans l’autorisation préalable et écrite de Sun et de ses bailleurs de licence, s’il y en a. Le logiciel détenu par des tiers, et qui comprend la technologie relative aux polices de caractères, est protégé par un copyright et licencié par des fournisseurs de Sun. Des parties de ce produit pourront être dérivées du système Berkeley BSD licenciés par l’Université de Californie. UNIX est une marque déposée aux Etats-Unis et dans d’autres pays et licenciée exclusivement par X/Open Company, Ltd. Sun, Sun Microsystems, le logo Sun, SunDocs, Java, le logo Java Coffee Cup, et Solaris sont des marques de fabrique ou des marques déposées, ou marques de service, de Sun Microsystems, Inc. aux Etats-Unis et dans d’autres pays. Toutes les marques SPARC sont utilisées sous licence et sont des marques de fabrique ou des marques déposées de SPARC International, Inc. aux Etats-Unis et dans d’autres pays. Les produits portant les marques SPARC sont basés sur une architecture développée par Sun Microsystems, Inc. L’interface d’utilisation graphique OPEN LOOK et SunTM a été développée par Sun Microsystems, Inc. pour ses utilisateurs et licenciés. Sun reconnaît les efforts de pionniers de Xerox pour la recherche et le développement du concept des interfaces d’utilisation visuelle ou graphique pour l’industrie de l’informatique. Sun détient une licence non exclusive de Xerox sur l’interface d’utilisation graphique Xerox, cette licence couvrant également les licenciés de Sun qui mettent en place l’interface d’utilisation graphique OPEN LOOK et qui en outre se conforment aux licences écrites de Sun. CETTE PUBLICATION EST FOURNIE “EN L’ETAT” ET AUCUNE GARANTIE, EXPRESSE OU IMPLICITE, N’EST ACCORDEE, Y COMPRIS DES GARANTIES CONCERNANT LA VALEUR MARCHANDE, L’APTITUDE DE LA PUBLICATION A REPONDRE A UNE UTILISATION PARTICULIERE, OU LE FAIT QU’ELLE NE SOIT PAS CONTREFAISANTE DE PRODUIT DE TIERS. CE DENI DE GARANTIE NE S’APPLIQUERAIT PAS, DANS LA MESURE OU IL SERAIT TENU JURIDIQUEMENT NUL ET NON AVENU. Please Recycle Contents PREFACE xi Intro(7) 2 adp(7D) 13 aha(7D) 15 aic(7D) 17 arp(7P) 19 asy(7D) 22 ata(7D) 25 audio(7I) 27 audioamd(7D) 38 audiocs(7D) 40 bd(7M) 43 bpp(7D) 45 bufmod(7M) 51 bwtwo(7D) 56 cdio(7I) 57 cgeight(7D) 68 cgfour(7D) 70 cgfourteen(7D) 71 Contents iii cgsix(7D) 72 cgthree(7D) 73 cgtwo(7D) 74 cmdk(7D) 75 cnft(7D) 77 connld(7M) 81 console(7D) 83 cpqncr(7D) 84 cpr(7) 86 csa(7D) 89 cvc(7D) 90 cvcredir(7D) 91 dbri(7D) 92 devinfo(7D) 98 display(7D) 99 dkio(7I) 100 dlpi(7P) 110 dnet(7D) 111 dpt(7D) 113 ecpp(7D) 114 eepro(7D) 120 eha(7D) 122 elx(7D) 123 esa(7D) 125 esp(7D) 126 fas(7D) 135 fbio(7I) 146 fd(7D) 148 iv man Pages(7):Device and Network Interfaces ♦ October 1998 fdio(7I) 154 ffb(7D) 159 flashpt(7D) 160 gld(7D) 161 glm(7D) 165 hdio(7I) 171 hme(7D) 173 hsfs(7FS) 178 i2o_bs(7D) 181 i2o_scsi(7D) 183 icmp(7P) 184 iee(7D) 186 ieef(7D) 188 ifp(7D) 190 if_tcp(7P) 195 inet(7P) 199 ip(7P) 202 iprb(7D) 207 isdnio(7I) 209 isp(7D) 225 kb(7M) 232 kdmouse(7D) 243 keyboard(7D) 244 kstat(7D) 245 ksyms(7D) 246 ldterm(7M) 248 le(7D) 252 llc1(7D) 257 Contents v lockstat(7D) 260 lofs(7FS) 261 log(7D) 263 logi(7D) 267 lp(7D) 268 ltem(7D) 270 m64(7D) 271 mem(7D) 273 mhd(7I) 274 mic(7D) 277 mlx(7D) 280 msm(7D) 283 mt(7D) 284 mtio(7I) 285 ncrs(7D) 299 nee(7D) 302 nei(7D) 304 nfe(7D) 306 null(7D) 308 openprom(7D) 309 pcata(7D) 314 pcelx(7D) 316 pcfs(7FS) 317 pcic(7D) 322 pckt(7M) 323 pcmem(7D) 324 pcn(7D) 325 pcram(7D) 327 vi man Pages(7):Device and Network Interfaces ♦ October 1998 pcscsi(7D) 328 pcser(7D) 329 pe(7D) 330 pfmod(7M) 332 pipemod(7M) 336 pln(7D) 337 pm(7D) 339 pmc(7D) 343 ppp(7M) 345 ptem(7M) 347 ptm(7D) 348 pts(7D) 350 pty(7D) 352 qe(7D) 356 qec(7D) 359 qfe(7d) 360 quotactl(7I) 365 rns_smt(7D) 368 route(7P) 369 routing(7P) 375 sad(7D) 377 sbpro(7D) 381 sd(7D) 384 se(7D) 391 se_hdlc(7D) 395 ses(7D) 399 sesio(7I) 400 sf(7D) 402 Contents vii smartii(7D) 405 smc(7D) 407 smce(7D) 409 smceu(7D) 413 smcf(7D) 415 soc(7D) 417 socal(7D) 419 sockio(7I) 422 ssd(7D) 423 st(7D) 428 stc(7D) 442 stp4020(7D) 456 streamio(7I) 457 sxp(7D) 476 tcp(7P) 479 tcx(7D) 484 termio(7I) 487 termiox(7I) 511 ticlts(7D) 517 timod(7M) 520 tirdwr(7M) 522 tmpfs(7FS) 528 tpf(7D) 530 tr(7D) 531 trantor(7D) 535 ttcompat(7M) 536 tty(7D) 544 udp(7P) 545 viii man Pages(7):Device and Network Interfaces ♦ October 1998 uscsi(7I) 547 visual_io(7I) 552 volfs(7FS) 559 vuidmice(7M) 561 wscons(7D) 564 xd(7D) 574 xt(7D) 576 xy(7D) 578 zero(7D) 580 zs(7D) 581 zsh(7D) 584 Index 588 Contents ix x man Pages(7):Device and Network Interfaces ♦ October 1998 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. The following contains a brief description of each section in the man pages and the information it references: 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 of this volume. 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 6 contains available games and demos. PREFACE xi 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. Section 9 provides reference information needed to write device drivers in the kernel operating systems environment. It describes two device driver interface specifications: the Device Driver Interface (DDI) and the Driver/Kernel Interface (DKI).