Revision 7e03a934 block_int.h

b/block_int.h
425 425
bool block_job_is_cancelled(BlockJob *job);
426 426

  
427 427
/**
428
 * block_job_cancel:
428
 * block_job_cancel_sync:
429 429
 * @job: The job to be canceled.
430 430
 *
431
 * Asynchronously cancel the job and wait for it to reach a quiescent
432
 * state.  Note that the completion callback will still be called
433
 * asynchronously, hence it is *not* valid to call #bdrv_delete
434
 * immediately after #block_job_cancel_sync.  Users of block jobs
435
 * will usually protect the BlockDriverState objects with a reference
436
 * count, should this be a concern.
431
 * Synchronously cancel the job.  The completion callback is called
432
 * before the function returns.  The job may actually complete
433
 * instead of canceling itself; the circumstances under which this
434
 * happens depend on the kind of job that is active.
437 435
 *
438 436
 * Returns the return value from the job if the job actually completed
439 437
 * during the call, or -ECANCELED if it was canceled.

Also available in: Unified diff