job.h: split function pointers in JobDriver
The job API will be handled separately in another serie. Signed-off-by: Emanuele Giuseppe Esposito <eesposit@redhat.com> Message-Id: <20220303151616.325444-31-eesposit@redhat.com> Signed-off-by: Kevin Wolf <kwolf@redhat.com>
This commit is contained in:
parent
dc2b15ba08
commit
32498092c4
|
@ -169,6 +169,12 @@ typedef struct Job {
|
||||||
* Callbacks and other information about a Job driver.
|
* Callbacks and other information about a Job driver.
|
||||||
*/
|
*/
|
||||||
struct JobDriver {
|
struct JobDriver {
|
||||||
|
|
||||||
|
/*
|
||||||
|
* These fields are initialized when this object is created,
|
||||||
|
* and are never changed afterwards
|
||||||
|
*/
|
||||||
|
|
||||||
/** Derived Job struct size */
|
/** Derived Job struct size */
|
||||||
size_t instance_size;
|
size_t instance_size;
|
||||||
|
|
||||||
|
@ -184,9 +190,18 @@ struct JobDriver {
|
||||||
* aborted. If it returns zero, the job moves into the WAITING state. If it
|
* aborted. If it returns zero, the job moves into the WAITING state. If it
|
||||||
* is the last job to complete in its transaction, all jobs in the
|
* is the last job to complete in its transaction, all jobs in the
|
||||||
* transaction move from WAITING to PENDING.
|
* transaction move from WAITING to PENDING.
|
||||||
|
*
|
||||||
|
* This callback must be run in the job's context.
|
||||||
*/
|
*/
|
||||||
int coroutine_fn (*run)(Job *job, Error **errp);
|
int coroutine_fn (*run)(Job *job, Error **errp);
|
||||||
|
|
||||||
|
/*
|
||||||
|
* Functions run without regard to the BQL that may run in any
|
||||||
|
* arbitrary thread. These functions do not need to be thread-safe
|
||||||
|
* because the caller ensures that they are invoked from one
|
||||||
|
* thread at time.
|
||||||
|
*/
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* If the callback is not NULL, it will be invoked when the job transitions
|
* If the callback is not NULL, it will be invoked when the job transitions
|
||||||
* into the paused state. Paused jobs must not perform any asynchronous
|
* into the paused state. Paused jobs must not perform any asynchronous
|
||||||
|
@ -201,6 +216,13 @@ struct JobDriver {
|
||||||
*/
|
*/
|
||||||
void coroutine_fn (*resume)(Job *job);
|
void coroutine_fn (*resume)(Job *job);
|
||||||
|
|
||||||
|
/*
|
||||||
|
* Global state (GS) API. These functions run under the BQL.
|
||||||
|
*
|
||||||
|
* See include/block/block-global-state.h for more information about
|
||||||
|
* the GS API.
|
||||||
|
*/
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Called when the job is resumed by the user (i.e. user_paused becomes
|
* Called when the job is resumed by the user (i.e. user_paused becomes
|
||||||
* false). .user_resume is called before .resume.
|
* false). .user_resume is called before .resume.
|
||||||
|
|
Loading…
Reference in New Issue