usb_autopm_get_interface(9) [suse man page]

USB_AUTOPM_GET_INTER(9) 					   USB Core APIs					   USB_AUTOPM_GET_INTER(9)

NAME

       usb_autopm_get_interface - increment a USB interface's PM-usage counter

SYNOPSIS

       int usb_autopm_get_interface(struct usb_interface * intf);

ARGUMENTS

       intf
	   the usb_interface whose counter should be incremented

DESCRIPTION

       This routine should be called by an interface driver when it wants to use intf and needs to guarantee that it is not suspended. In
       addition, the routine prevents intf from being autosuspended subsequently. (Note that this will not prevent suspend events originating in
       the PM core.) This prevention will persist until usb_autopm_put_interface is called or intf is unbound. A typical example would be a
       character-device driver when its device file is opened.

       intf's usage counter is incremented to prevent subsequent autosuspends. However if the autoresume fails then the counter is re-decremented.

       This routine can run only in process context.

COPYRIGHT

Kernel Hackers Manual 2.6.					     July 2010						   USB_AUTOPM_GET_INTER(9)

HFA(4)							   BSD Kernel Interfaces Manual 						    HFA(4)

NAME

     hfa -- FORE Systems 200-Series ATM adapter driver

SYNOPSIS

     device hfa

DESCRIPTION

     The hfa driver provides support for the FORE Systems ATM series 200 adapters.  This driver will support up to eight devices in a system at
     any given time.  The hfa driver follows the AALI or FORE ATM Adaptation Layer Interface and as such will adhere to its specifications.  The
     supported AALs include:

     o	 FORE AAL 0: The cell service;

     o	 FORE AAL 4: Version three and four of AAL;

     o	 FORE AAL 5: Version five of AAL.

     The hfa driver supports traffic shaping for cards with firmware revisions of 4.X.X, see fore_dnld(8).  The following sysctls are recognized
     by the driver and may be used to enable or disable traffic shaping:

     hw.atm.hfaN.shape (0)
	     Disable shaping on card number N.

     hw.atm.hfaN.shape (1)
	     Set one VCI to be traffic shaped on device N.  This will shape the first CBR VCI which is opened.

     hw.atm.hfaN.shape (2)
	     Attempt to shape all VCIs on device N.
     The firmware should be loaded before using this driver, this can be an easy task if the fore_dnld(8) utility is used.  If the /etc/rc.d/atm1
     file has been properly configured then the firmware update should be automatic.

HARDWARE

     The hfa driver supports the following adapters:

     o	 FORE Systems PCA-200E ATM
     o	 FORE Systems 200S
     o	 FORE Systems 200

DIAGNOSTICS

     fore_cmd_drain: %s%d: GET_PROM failed  The driver failed to drain the PROM buffer.

     fore initialization failed: intf=%s%d  Initialization of the card has failed.

     fore initialization timed out: intf=%s%d  Initialization of the card has timed out.

     hfa: version mismatch: fore=%d.%d kernel=%d.%d  A version mismatch error has occurred.

SEE ALSO

     fatm(4), harp(4), ng_atm(4), atm(8), fore_dnld(8)

HISTORY

     The hfa driver was written by Network Computing Services, Inc. and added to FreeBSD 3.0 by Poul-Henning Kamp <phk@FreeBSD.org>.  This manual
     page first appeared in FreeBSD 5.3.

AUTHORS

     This manual page was written by Tom Rhodes <trhodes@FreeBSD.org>.

BSD
								  August 6, 2004							       BSD