DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 
SVR5 and SCO OpenServer 5

ModifyConfiguration(D3pccard)


ModifyConfiguration -- partially modify socket and PC Card configuration

Synopsis

   #include <sys/types.h>
   #include <sys/lcs.h>
   #include <sys/lss.h>
   

int CardServices (ModifyConfiguration, ClientHandle_t *ch, int n2, int ModifyConfigurationLen, ModifyConfiguration_t *mcfg, rm_key_t key);

Description

ModifyConfiguration( ) can partially modify a socket and PC Card configuration without having to resort to a pair of Release/RequestConfiguration services.

Arguments


ch
Pointer to a ClientHandle(D4pccard) structure.

n2
NULL

ModifyConfigurationLen
Length of the ModifyConfiguration(D4pccard) structure. Must be set to 7.

mcfg
Pointer to a ModifyConfiguration(D4pccard) structure.

key
Resource manager key.

Return values


NO_CARD
No card in socket.

BAD_ARG_LEN
ModifyConfigurationLen not equal to 7.

BAD_ATTRIBUTE
Can not enable/disable IRQ steering.

BAD_HANDLE
*ch does not point to the right Client.

BAD_SOCKET
Socket or function invalid.

BAD_VPP
Socket cannot deliver requested VPP1 or VPP2.

SUCCESS
Configuration successfully modified. Successfully added the socket service handler

Usage

The ClientHandle(D4pccard) structure that had earlier been passed to the RequestConfiguration(D3pccard) service is now passed again by the pointer *ch. Because it is necessary to pass a ClientHandle that had been passed to RequestConfiguration( ), ModifyConfiguration can deal only with a configuration originally set up by the RequestConfiguration( ) service.

The ModifyConfiguration service is useful for changing VPP1 or VPP2 without throwing away the present configuration. However, ModifyConfiguration has notable limitations. It can not change I/O address mapping, IRQ routing nor VCC. To change these, the configuration must be released and a new configuration with the new I/O, IRQ, and/or VCC requested.

Context and synchronization

Interrupt, initialization, or user context

Hardware applicability

All

Version applicability

pccard: 1, 2, 3

References

ClientHandle(D4pccard), ModifyConfiguration(D4pccard)
19 June 2005
© 2005 The SCO Group, Inc. All rights reserved.
OpenServer 6 and UnixWare (SVR5) HDK - June 2005