Direct Access Transport Library Functions datepmodify(3DAT)
NAME
datepmodify - change parameters of an Endpoint
SYNOPSIS
cc [ flag... ] file... -ldat [ library... ]
#include
DATRETURN
datepmodify (
IN DATEPHANDLE ephandle,
IN DATEPARAMASK epparammask,
IN DATEPARAM *epparam
)
PARAMETERS
ephandle Handle for an instance of the Endpoint.
epparammask Mask for Endpoint parameters.
epparam Pointer to the Consumer-allocated structure
that contains Consumer-requested Endpoint
parameters.
DESCRIPTION
The datepmodify() function provides the Consumer a way to
change parameters of an Endpoint.
The epparammask parameter allows Consumers to specify
which parameters to modify. Providers modify values for
epparammask requested parameters only.
Not all the parameters of the Endpoint can be modified. Some
can be modified only when the Endpoint is in a specific
state. The following list specifies which parameters can be
modified and when they can be modified.
Interface Adapter
Cannot be modified.
Endpoint belongs to an open instance of IA and that
association cannot be changed.
Endpoint State
SunOS 5.11 Last change: 16 Jul 2004 1
Direct Access Transport Library Functions datepmodify(3DAT)
Cannot be modified.
State of Endpoint cannot be changed by a datepmodify()
operation.
Local IA Address
Cannot be modified.
Local IA Address cannot be changed by a datepmodify()
operation.
Local Port Qualifier
Cannot be modified.
Local port qualifier cannot be changed by a
datepmodify() operation.
Remote IA Address
Cannot be modified.
Remote IA Address cannot be changed by a datepmodify()
operation.
Remote Port Qualifier
Cannot be modified.
Remote port qualifier cannot be changed by a
datepmodify() operation
Protection Zone
Can be modified when in Quiescent, Unconnected, and Ten-
tative Connection Pending states.
Protection Zone can be changed only when the Endpoint is
in quiescent state. The only Endpoint states that isare
quiescent isare DATEPSTATEUNCONECTED and
DATEPSTATETENTATIVECONECTIONPENDING. Consumers
should be aware that any Receive DTOs currently posted
to the Endpoint that do not match the new Protection
Zone fail with a DATPROTECTIONVIOLATION return.
SunOS 5.11 Last change: 16 Jul 2004 2
Direct Access Transport Library Functions datepmodify(3DAT)
In DTO Event Dispatcher
Can be modified when in Unconnected, Reserved, Passive
Connection Request Pending, and Tentative Connection
Pending states.
Event Dispatcher for incoming DTOs (Receive) can be
changed only prior to a request for a connection for an
Active side or prior to accepting a Connection Request
for a Passive side.
Out DTO Event Dispatcher
Can be modified when in Unconnected, Reserved, Passive
Connection Pending, and Tentative Connection Pending
states.
Event Dispatcher for outgoing DTOs (Send, RDMA Read, and
RDMA Write) can be changed only prior to a request for a
connection for an Active side or prior to accepting a
Connection Request for a Passive side.
Connection Event Dispatcher
Can be modified when in Unconnected, Reserved, Passive
Connection Pending, and Tentative Connection Pending
states.
Event Dispatcher for the Endpoint Connection events can
be changed only prior to a request for a connection for
an Active side or accepting a Connection Request for a
Passive side.
Service Type
Can be modified when in Unconnected, Reserved, Passive
Connection Pending, and Tentative Connection Pending
states.
Service Type can be changed only prior to a request for
a connection for an Active side or accepting a Connec-
tion Request for a Passive side.
Maximum Message Size
Can be modified when in Unconnected, Reserved, Passive
Connection Request Pending, and Tentative Connection
Pending states.
SunOS 5.11 Last change: 16 Jul 2004 3
Direct Access Transport Library Functions datepmodify(3DAT)
Maximum Message Size can be changed only prior to a
request for a connection for an Active side or accepting
a Connection Request for a Passive side.
Maximum RDMA Size
Can be modified when in Unconnected, Reserved, Passive
Connection Pending, and Tentative Connection Pending
states.
Maximum RDMA Size can be changed only prior to a request
for a connection for an Active side or accepting a Con-
nection Request for a Passive side.
Quality of Service
Can be modified when in Unconnected, Reserved, Passive
Connection Pending, and Tentative Connection Pending
states.
QoS can be changed only prior to a request for a connec-
tion for an Active side or accepting a Connection
Request for a Passive side.
Recv Completion Flags
Can be modified when in Unconnected, Reserved, Passive
Connection Pending, and Tentative Connection Pending
states.
Recv Completion Flags specifies what DTO flags the End-
point should support for Receive DTO operations. The
value can be DATCOMPLETIONOTIFICATIONSUPRESFLAG,
DATCOMPLETIONSOLICITEDWAITFLAG, or
DATCOMPLETIONEVDTHRESHOLDFLAG. Recv posting does not
support DATCOMPLETIONSUPRESFLAG or
DATCOMPLETIONBARIERFENCEFLAG datcompletionflags
values that are only applicable to Request postings.
Recv Completion Flags can be changed only prior to a
request for a connection for an Active side or accepting
a Connection Request for a Passive side, but before
posting of any Recvs.
Request Completion Flags
Can be modified when in Unconnected, Reserved, Passive
Connection Request Pending, and Tentative Connection
Pending states.
SunOS 5.11 Last change: 16 Jul 2004 4
Direct Access Transport Library Functions datepmodify(3DAT)
Request Completion Flags specifies what DTO flags the
Endpoint should support for Send, RDMA Read, RDMA Write,
and RMR Bind operations. The value can be:
DATCOMPLETIONUNSIGNALEDFLAG or
DATCOMPLETIONEVDTHRESHOLDFLAG. Request postings
always support DATCOMPLETIONSUPRESFLAG,
DATCOMPLETIONSOLICITEDWAITFLAG, or
DATCOMPLETIONBARIERFENCEFLAG completionflags
values. Request Completion Flags can be changed only
prior to a request for a connection for an Active side
or accepting a Connection Request for a Passive side.
Maximum Recv DTO
Can be modified when in Unconnected, Reserved, Passive
Connection Pending, and Tentative Connection Pending
states.
Maximum Recv DTO specifies the maximum number of out-
standing Consumer-submitted Receive DTOs that a Consumer
expects at any time at the Endpoint. Maximum Recv DTO
can be changed only prior to a request for a connection
for an Active side or accepting a Connection Request for
a Passive side.
Maximum Request DTO
Can be modified when in Unconnected, Reserved, Passive
Connection Pending, and Tentative Connection Pending
states.
Maximum Request DTO specifies the maximum number of out-
standing Consumer-submitted send and RDMA DTOs and RMR
Binds that a Consumer expects at any time at the End-
point. Maximum Out DTO can be changed only prior to a
request for a connection for an Active side or accepting
a Connection Request for a Passive side.
Maximum Recv IOV
Can be modified when in Unconnected, Reserved, Passive
Connection Pending, and Tentative Connection Pending
states.
Maximum Recv IOV specifies the maximum number of ele-
ments in IOV that a Consumer specifies for posting a
Receive DTO for the Endpoint. Maximum Recv IOV can be
changed only prior to a request for a connection for an
Active side or accepting a Connection Request for a
SunOS 5.11 Last change: 16 Jul 2004 5
Direct Access Transport Library Functions datepmodify(3DAT)
Passive side.
Maximum Request IOV
Can be modified when in Unconnected, Reserved, Passive
Connection Pending, and Tentative Connection Pending
states.
Maximum Request IOV specifies the maximum number of ele-
ments in IOV that a Consumer specifies for posting a
Send, RDMA Read, or RDMA Write DTO for the Endpoint.
Maximum Request IOV can be changed only prior to a
request for a connection for an Active side or accepting
a Connection Request for a Passive side.
Maximum outstanding RDMA Read as target
Can be modified when in Unconnected, Reserved, Passive
Connection Pending, and Tentative Connection Pending
states.
Maximum number of outstanding RDMA Reads for which the
Endpoint is the target.
Maximum outstanding RDMA Read as originator
Can be modified when in Unconnected, Reserved, Passive
Connection Pending, and Tentative Connection Pending
states.
Maximum number of outstanding RDMA Reads for which the
Endpoint is the originator.
Num transport-specific attributes
Can be modified when in Quiescent (unconnected) state.
Number of transport-specific attributes to be modified.
Transport-specific endpoint attributes
Can be modified when in Quiescent (unconnected) state.
Transport-specific attributes can be modified only in
the transport-defined Endpoint state. The only
guaranteed safe state in which to modify transport-
specific Endpoint attributes is the quiescent state
SunOS 5.11 Last change: 16 Jul 2004 6
Direct Access Transport Library Functions datepmodify(3DAT)
DATEPSTATEUNCONECTED.
Num provider-specific attributes
Can be modified when in Quiescent (unconnected) state.
Number of Provider-specific attributes to be modified.
Provider-specific endpoint attributes
Can be modified when in Quiescent (unconnected) state.
Provider-specific attributes can be modified only in the
Provider-defined Endpoint state. The only guaranteed
safe state in which to modify Provider-specific Endpoint
attributes is the quiescent state
DATEPSTATEUNCONECTED.
RETURN VALUES
DATSUCES The operation was successful.
DATINVALIDHANDLE The ephandle parameter is invalid.
DATINVALIDPARAMETER The epparammask parameter is
invalid, or one of the requested
Endpoint parameters or attributes
was invalid, not supported, or can-
not be modified.
DATINVALIDSTATE Parameter in an invalid state. The
Endpoint was not in the state that
allows one of the parameters or
attributes to be modified.
ATRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
SunOS 5.11 Last change: 16 Jul 2004 7
Direct Access Transport Library Functions datepmodify(3DAT)
ATRIBUTE TYPE ATRIBUTE VALUE
Interface Stability Standard: uDAPL, 1.1, 1.2
MT-Level Unsafe
SEE ALSO
libdat(3LIB), attributes(5)
SunOS 5.11 Last change: 16 Jul 2004 8
|
