Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

device.hints(5) [freebsd man page]

DEVICE.HINTS(5) 					      BSD File Formats Manual						   DEVICE.HINTS(5)

NAME

     device.hints -- device resource hints

DESCRIPTION

     The device.hints file is read in by the boot loader(8) when the system is about to start, and its contents are passed to the kernel.  It con-
     tains various variables to control the boot behavior of the kernel.  These variables are typically ``device hints''.

     The file contains one variable per line.  Lines starting with the '#' character are comments and are ignored by the boot loader.

     After the file is read by the boot loader, you may examine the variables with the show command, and may add a new variable, modify an exist-
     ing one, or delete a variable with the set and unset commands of the boot loader (see loader(8)).

     After the system has started, you can dump these variables with the kenv(1) command.

DEVICE HINTS

     Device hint variables are used by device drivers to set up the device.  They are most often used by ISA device drivers to specify where the
     driver will probe for the relevant devices, and what resources it will attempt to use.

     A device hint line looks like:

	   hint.driver.unit.keyword="value"

     where driver is the name of a device driver, unit is the unit number, and keyword is the keyword of the hint.  The keyword may be:

	   at	     specifies a bus to which the device is attached.
	   port      specifies the start address of I/O ports to be used by the device.
	   portsize  specifies the number of ports used by the device.
	   irq	     is the interrupt line number to be used.
	   drq	     is the DMA channel number.
	   maddr     specifies the physical memory address used by the device.
	   msize     specifies the physical memory size used by the device.
	   flags     sets various flag bits for the device.
	   disabled  can be set to "1" to disable the device.

     A device driver may require one or more hint lines with these keywords, and may accept other keywords not listed here, through
     resource_int_value(9).  Consult individual device drivers' manual pages for available keywords and their possible values.

FILES

     /boot/device.hints 	   Device resource hints file.
     /sys/ARCH/conf/GENERIC.hints  Sample resource hints for the GENERIC kernel.
     /sys/ARCH/conf/NOTES	   Notes on the kernel configuration file and device resource hints.

EXAMPLES

     The following example sets up resources for the sio(4) driver on the ISA bus:

	   hint.sio.0.at="isa"
	   hint.sio.0.port="0x3F8"
	   hint.sio.0.flags="0x10"
	   hint.sio.0.irq="4"

     The following example disables the ACPI driver:

	   hint.acpi.0.disabled="1"

SEE ALSO

     kenv(1), loader.conf(5), loader(8), resource_int_value(9)

HISTORY

     The device.hints file first appeared in FreeBSD 5.0.

BSD
								September 11, 2009							       BSD

Check Out this Related Man Page

SND_SBC(4)						   BSD Kernel Interfaces Manual 						SND_SBC(4)

NAME

     snd_sbc, snd_sb16, snd_sb8 -- Creative Sound Blaster ISA and compatible bridge device driver

SYNOPSIS

     To compile this driver into the kernel, place the following lines in your kernel configuration file:

	   device sound
	   device snd_sbc
	   device snd_sb16
	   device snd_sb8

     Alternatively, to load the driver as a module at boot time, place the following lines in loader.conf(5):

	   snd_sbc_load="YES"
	   snd_sb16_load="YES"
	   snd_sb8_load="YES"

     Non-PnP cards require the following lines in device.hints(5):

	   hint.sbc.0.at="isa"
	   hint.sbc.0.port="0x220"
	   hint.sbc.0.irq="5"
	   hint.sbc.0.drq="1"
	   hint.sbc.0.flags="0x15"

DESCRIPTION

     The snd_sbc bridge driver allows the generic audio driver sound(4) to attach to Creative Sound Blaster ISA (mostly SB16 or SB8, known as
     SoundBlaster Pro) compatible audio cards.

     The value of flags specifies the secondary DMA channel.  If the secondary DMA channel is C, set the flags to (C | 0x10).  For a sound card
     without the secondary DMA channel, the flags should be set to zero.

HARDWARE

     The snd_sbc driver supports the following sound cards:

     o	 Avance Asound 110
     o	 Avance Logic ALS100+
     o	 Avance Logic ALS120
     o	 Creative SB16
     o	 Creative SB32
     o	 Creative AWE64
     o	 Creative AWE64 Gold
     o	 Creative ViBRA16C
     o	 Creative ViBRA16X
     o	 ESS ES1681
     o	 ESS ES1688
     o	 ESS ES1868
     o	 ESS ES1869
     o	 ESS ES1878
     o	 ESS ES1879
     o	 ESS ES1888

DIAGNOSTICS

     sb_dspwr(XX) timed out.  A command to the DSP has timed out.  Check the I/O port configuration.

     bad irq XX (5/7/9/10 valid)  The IRQ given to the driver is not valid.

SEE ALSO

     sound(4)

HISTORY

     The snd_sbc device driver first appeared in FreeBSD 4.0.

AUTHORS

     Seigo Tanimura <tanimura@r.dl.itc.u-tokyo.ac.jp>

BSD
								 February 17, 2007							       BSD
Man Page