1*41ce3b17Snaddy.\" $OpenBSD: intro.4,v 1.5 2022/03/31 17:27:22 naddy Exp $ 2858be22dSschwarze.\" 3858be22dSschwarze.\" Copyright (c) 1983, 1986, 1991 Regents of the University of California. 49bd3d160Smiod.\" All rights reserved. 59bd3d160Smiod.\" 69bd3d160Smiod.\" Redistribution and use in source and binary forms, with or without 79bd3d160Smiod.\" modification, are permitted provided that the following conditions 89bd3d160Smiod.\" are met: 99bd3d160Smiod.\" 1. Redistributions of source code must retain the above copyright 109bd3d160Smiod.\" notice, this list of conditions and the following disclaimer. 119bd3d160Smiod.\" 2. Redistributions in binary form must reproduce the above copyright 129bd3d160Smiod.\" notice, this list of conditions and the following disclaimer in the 139bd3d160Smiod.\" documentation and/or other materials provided with the distribution. 149bd3d160Smiod.\" 3. Neither the name of the University nor the names of its contributors 159bd3d160Smiod.\" may be used to endorse or promote products derived from this software 169bd3d160Smiod.\" without specific prior written permission. 179bd3d160Smiod.\" 189bd3d160Smiod.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND 199bd3d160Smiod.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 209bd3d160Smiod.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 219bd3d160Smiod.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 229bd3d160Smiod.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 239bd3d160Smiod.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 249bd3d160Smiod.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 259bd3d160Smiod.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 269bd3d160Smiod.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 279bd3d160Smiod.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 289bd3d160Smiod.\" SUCH DAMAGE. 299bd3d160Smiod.\" 309bd3d160Smiod.\" from: @(#)intro.4 5.2 (Berkeley) 3/27/91 319bd3d160Smiod.\" 32*41ce3b17Snaddy.Dd $Mdocdate: March 31 2022 $ 339bd3d160Smiod.Dt INTRO 4 loongson 349bd3d160Smiod.Os 359bd3d160Smiod.Sh NAME 369bd3d160Smiod.Nm intro 379bd3d160Smiod.Nd introduction to special files and hardware support 389bd3d160Smiod.Sh DESCRIPTION 399bd3d160SmiodThe manual pages in section 4 describe the special files, 409bd3d160Smiodrelated driver functions, and networking support 419bd3d160Smiodavailable in the system. 42c9a5186dSjmcIn this part of the manual, the SYNOPSIS section of 439bd3d160Smiodeach configurable device gives a sample specification 449bd3d160Smiodfor use in constructing a system description for the 459bd3d160Smiod.Xr config 8 469bd3d160Smiodprogram. 47c9a5186dSjmcThe DIAGNOSTICS section lists messages which may appear on the console 489bd3d160Smiodand/or in the system error log 499bd3d160Smiod.Pa /var/log/messages 509bd3d160Smioddue to errors in device operation; 519bd3d160Smiodsee 529bd3d160Smiod.Xr syslogd 8 539bd3d160Smiodfor more information. 549bd3d160Smiod.Pp 559bd3d160SmiodThis section contains both devices 569bd3d160Smiodwhich may be configured into the system 579bd3d160Smiodand network related information. 589bd3d160SmiodThe networking support is introduced in 599bd3d160Smiod.Xr netintro 4 . 609bd3d160Smiod.Sh DEVICE SUPPORT 619bd3d160SmiodThis section describes the hardware supported on the 629bd3d160Smiodloongson platform. 639bd3d160SmiodSoftware support for these devices comes in two forms. 649bd3d160SmiodA hardware device may be supported with a character or block 659bd3d160Smiod.Em device driver , 669bd3d160Smiodor it may be used within the networking subsystem and have a 679bd3d160Smiod.Em network interface driver . 689bd3d160SmiodBlock and character devices are accessed through files in the file 699bd3d160Smiodsystem of a special type; see 709bd3d160Smiod.Xr mknod 8 . 719bd3d160SmiodNetwork interfaces are indirectly accessed through the interprocess 729bd3d160Smiodcommunication facilities provided by the system; see 739bd3d160Smiod.Xr socket 2 . 749bd3d160Smiod.Pp 759bd3d160SmiodA hardware device is identified to the system at configuration time 769bd3d160Smiodand the appropriate device or network interface driver is then compiled 779bd3d160Smiodinto the system. 789bd3d160SmiodWhen the resultant system is booted, the autoconfiguration facilities 799bd3d160Smiodin the system probe for the device and, if found, enable the software 809bd3d160Smiodsupport for it. 819bd3d160SmiodIf a device does not respond at autoconfiguration 82*41ce3b17Snaddytime, it is not accessible at any time afterwards. 839bd3d160SmiodTo enable a device which did not autoconfigure, 849bd3d160Smiodthe system will have to be rebooted. 859bd3d160Smiod.Pp 869bd3d160SmiodThe autoconfiguration system is described in 879bd3d160Smiod.Xr autoconf 4 . 889bd3d160Smiod.Sh LIST OF DEVICES 899bd3d160SmiodA complete list of available devices is contained within the pages 909bd3d160Smioddescribing the system buses and controllers. 919bd3d160SmiodFor example, a PCI device would be listed in the 929bd3d160Smiod.Xr pci 4 939bd3d160Smiodman page. 949bd3d160SmiodThe following buses and controllers list these devices: 959bd3d160Smiod.Pp 969bd3d160Smiod.Bl -tag -compact -width "pcctwo(4)" -offset 3n 979bd3d160Smiod.It Xr isa 4 989bd3d160Smiodintroduction to ISA bus support 999bd3d160Smiod.It Xr pci 4 1009bd3d160Smiodintroduction to PCI bus support 1019bd3d160Smiod.El 1029bd3d160Smiod.Sh SEE ALSO 1039bd3d160Smiod.Xr autoconf 4 , 1049bd3d160Smiod.Xr config 8 10532964801Sschwarze.Sh HISTORY 10632964801SschwarzeThe loongson 10732964801Sschwarze.Nm 10832964801Sschwarzeappeared in 10932964801Sschwarze.Ox 4.7 . 110