Freescale-semiconductor SEC2SWUG Manuel d'utilisateur télécharger pdf (Page 11)

SEC 2.0 Reference Device Driver User’s Guide, Rev. 0

Freescale Semiconductor PRELIMINARY—SUBJECT TO CHANGE WITHOUT NOTICE 11

User Interface

STATUS_REQ driverstatus; // Detailed information as to the state of the

// hardware and the driver at the time of an error

3.3.6 Process Request Structures

All process request structures contain the a copy of the same request header information, which is defined by the

COMMON_REQ_PREAMBLE macro. The members of this header must be filled in as needed by the user prior to the

issue of the user's request.

unsigned long opId;

unsigned char scatterBufs;

unsigned char notifyFlags;

unsigned char reserved;

unsigned char channel;

PSEC2_NOTIFY_ROUTINE notify;

PSEC2_NOTIFY_CTX pNotifyCtx;

PSEC2_NOTIFY_ON_ERROR_ROUTINE notify_on_error;

SEC2_NOTIFY_ON_ERROR_CTX ctxNotifyOnErr;

int status;

void *nextReq;

opId operation Id which identifies what type of request this is. It is normally associated with

a specific type of cryptographic operation, see Section 4, “Individual Request Type

Descriptions” for all supported request types.

scatterBufs A bitmask that specifies which of the argued buffers are mapped through a

scatter-gather list. The mask is filled out via the driver's helper function

MarkScatterBuffer(), described in Section 3.3.7, “Scatter-Gather Buffer

Management.”

notifyFlags If a POSIX-style signal handler will be responsible for request completion notification,

then it can contain ORed bits of

NOTIFY_IS_PID and/or

NOTIFY_ERROR_IS_PID, signifying that the notify or notify_on_error

pointers are instead the process ID's (i.e.

getpid()) of the task requesting a signal

upon request completion.

channel identifies the channel to be used for the request. It exists for legacy compatibility

reasons, and is no longer useful for SEC2.

notify pointer to a notification callback routine that will be called when the request has

completed successfully. May instead be a process ID if a user-state signal handler will

flag completion. Refer back to

notifyFlags for more info.

pNotifyCtx pointer to context area to be passed back through the notification routine.

1 2 ... 6 7 8 9 10 11 12 13 14 15 16 ... 43 44

Pas de commentaire

Freescale-semiconductor SEC2SWUG Manuel d'utilisateur Page 11