@ -102,17 +102,15 @@ typedef struct BlockJob {
*/
/**
* block_job_next :
* block_job_next_locked :
* @ job : A block job , or % NULL .
*
* Get the next element from the list of block jobs after @ job , or the
* first one if @ job is % NULL .
*
* Returns the requested job , or % NULL if there are no more jobs left .
* Called with job lock held .
*/
BlockJob * block_job_next ( BlockJob * job ) ;
/* Same as block_job_next(), but called with job lock held. */
BlockJob * block_job_next_locked ( BlockJob * job ) ;
/**
@ -122,6 +120,7 @@ BlockJob *block_job_next_locked(BlockJob *job);
* Get the block job identified by @ id ( which must not be % NULL ) .
*
* Returns the requested job , or % NULL if it doesn ' t exist .
* Called with job lock * not * held .
*/
BlockJob * block_job_get ( const char * id ) ;
@ -161,43 +160,37 @@ void block_job_remove_all_bdrv(BlockJob *job);
bool block_job_has_bdrv ( BlockJob * job , BlockDriverState * bs ) ;
/**
* block_job_set_speed :
* block_job_set_speed_locked :
* @ job : The job to set the speed for .
* @ speed : The new value
* @ errp : Error object .
*
* Set a rate - limiting parameter for the job ; the actual meaning may
* vary depending on the job type .
*/
bool block_job_set_speed ( BlockJob * job , int64_t speed , Error * * errp ) ;
/*
* Same as block_job_set_speed ( ) , but called with job lock held .
* Might release the lock temporarily .
*
* Called with job lock held , but might release it temporarily .
*/
bool block_job_set_speed_locked ( BlockJob * job , int64_t speed , Error * * errp ) ;
/**
* block_job_query :
* block_job_query_locked :
* @ job : The job to get information about .
*
* Return information about a job .
*
* Called with job lock held .
*/
BlockJobInfo * block_job_query ( BlockJob * job , Error * * errp ) ;
/* Same as block_job_query(), but called with job lock held. */
BlockJobInfo * block_job_query_locked ( BlockJob * job , Error * * errp ) ;
/**
* block_job_iostatus_reset :
* block_job_iostatus_reset_locked :
* @ job : The job whose I / O status should be reset .
*
* Reset I / O status on @ job and on BlockDriverState objects it uses ,
* other than job - > blk .
*
* Called with job lock held .
*/
void block_job_iostatus_reset ( BlockJob * job ) ;
/* Same as block_job_iostatus_reset(), but called with job lock held. */
void block_job_iostatus_reset_locked ( BlockJob * job ) ;
/*