csx_ModifyConfiguration man page on OpenIndiana

Man page or keyword search:  
man Server   20441 pages
apropos Keyword Search (all sections)
Output format
OpenIndiana logo
[printable version]

csx_ModifyConfiguration(9Kernel Functions for Drivecsx_ModifyConfiguration(9F)

NAME
       csx_ModifyConfiguration	- modify socket and PC Card Configuration Reg‐
       ister

SYNOPSIS
       #include <sys/pccard.h>

       int32_t csx_ModifyConfiguration(client_handle_t ch, modify_config_t *mc);

INTERFACE LEVEL
       Solaris DDI Specific (Solaris DDI)

PARAMETERS
       ch     Client handle returned from csx_RegisterClient(9F).

       mc     Pointer to a modify_config_t structure.

DESCRIPTION
       This function allows a socket and PC Card configuration to be modified.
       This   function	 can   only   modify  a	 configuration	requested  via
       csx_RequestConfiguration(9F).

STRUCTURE MEMBERS
       The structure members of modify_config_t are:

	 uint32_t     Socket;	     /* socket number */
	 uint32_t     Attributes;    /* attributes to modify */
	 uint32_t     Vpp1;	     /* Vpp1 value */
	 uint32_t     Vpp2;	     /* Vpp2 value */

       The fields are defined as follows:

       Socket	      Not used in Solaris, but for portability with other Card
		      Services	implementations, it should be set to the logi‐
		      cal socket number.

       Attributes     This  field  is  bit-mapped.  The	 following  bits   are
		      defined:

		      CONF_ENABLE_IRQ_STEERING	  Enable  IRQ steering. Set to
						  connect  the	PC  Card  IREQ
						  line	  to	a   previously
						  selected system interrupt.

		      CONF_IRQ_CHANGE_VALID	  IRQ  change  valid.  Set  to
						  request   the	 IRQ  steering
						  enable to be changed.

		      CONF_VPP1_CHANGE_VALID	  Vpp1	change	valid.	 These
						  bits	are  set  to request a
						  change to the	 corresponding
						  voltage  level  for  the  PC
						  Card.

		      CONF_VPP2_CHANGE_VALID	  Vpp2	change	valid.	 These
						  bits	are  set  to request a
						  change to the	 corresponding
						  voltage  level  for  the  PC
						  Card.

		      CONF_VSOVERRIDE		  Override VS  pins.  For  Low
						  Voltage keyed cards, must be
						  set if a client  desires  to
						  apply	 a voltage inappropri‐
						  ate for  this	 card  to  any
						  pin.	After  card  insertion
						  and  prior  to   the	 first
						  csx_RequestConfiguration(9F)
						  call for  this  client,  the
						  voltage  levels  applied  to
						  the card will be those spec‐
						  ified	 by the Card Interface
						  Specification.  (See	 WARN‐
						  INGS.)

       Vpp1, Vpp2     Represent voltages expressed in tenths of a volt. Values
		      from 0 to 25.5 volts may be set. To be valid, the	 exact
		      voltage must be available from the system. To be compli‐
		      ant with the PC Card 95 Standard, PCMCIA/JEIDA,  systems
		      must always support 5.0 volts for both Vcc and Vpp. (See
		      WARNINGS.)

RETURN VALUES
       CS_SUCCESS		   Successful operation.

       CS_BAD_HANDLE		   Client handle is invalid or csx_RequestCon‐
				   figuration(9F) not done.

       CS_BAD_SOCKET		   Error   getting/setting   socket   hardware
				   parameters.

       CS_BAD_VPP		   Requested Vpp is not available on socket.

       CS_NO_CARD		   No PC Card in socket.

       CS_UNSUPPORTED_FUNCTION	   No PCMCIA hardware installed.

CONTEXT
       This function may be called from user or kernel context.

SEE ALSO
       csx_RegisterClient(9F),	  csx_ReleaseConfiguration(9F),	    csx_Relea‐
       seIO(9F), csx_ReleaseIRQ(9F), csx_RequestConfiguration(9F), csx_Reques‐
       tIO(9F), csx_RequestIRQ(9F)

       PC Card 95 Standard, PCMCIA/JEIDA

WARNINGS
	   1.	  CONF_VSOVERRIDE is provided for clients that have a need  to
		  override  the	 information  provided	in the CIS. The client
		  must exercise caution when setting this as it overrides  any
		  voltage level protection provided by Card Services.

	   2.	  Using	 csx_ModifyConfiguration()  to	set Vpp to 0 volts may
		  result in the loss of a PC Card's state. Any client  setting
		  Vpp  to  0  volts  is	 responsible  for insuring that the PC
		  Card's state is restored when power  is  re-applied  to  the
		  card.

NOTES
       Mapped  IO addresses can only be changed by first releasing the current
       configuration and IO resources  with  csx_ReleaseConfiguration(9F)  and
       csx_ReleaseIO(9F),  requesting new IO resources and a new configuration
       with csx_RequestIO(9F), followed by csx_RequestConfiguration(9F).

       IRQ priority can only be changed by first releasing the current config‐
       uration	 and   IRQ  resources  with  csx_ReleaseConfiguration(9F)  and
       csx_ReleaseIRQ(9F), requesting new IRQ resources and a  new  configura‐
       tion with csx_RequestIRQ(9F), followed by csx_RequestConfiguration(9F).

       Vcc  can	 not  be  changed  using csx_ModifyConfiguration(). Vcc may be
       changed by first	 invoking  csx_ReleaseConfiguration(9F),  followed  by
       csx_RequestConfiguration(9F) with a new Vcc value.

SunOS 5.11			  19 Jul 1996	   csx_ModifyConfiguration(9F)
[top]

List of man pages available for OpenIndiana

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net