The Linux Manuals (man pages) document is an important part of Linux documents. Linux Manuals are organized as several sections. Each section has a group of commands for a specific area in Linux usage, administration or development.
blk_pre_runtime_suspend – Pre runtime suspend check Synopsis int blk_pre_runtime_suspend(struct request_queue *q); Arguments q the queue of the device Description This function will check if runtime suspend is allowed for the device by examining if there are any requests pending in the queue. If there are requests pending, the device can not be runtime suspended; otherwise,…
blk_pre_runtime_resume – Pre runtime resume processing Synopsis void blk_pre_runtime_resume(struct request_queue *q); Arguments q the queue of the device Description Update the queue’s runtime status to RESUMING in preparation for the runtime resume of the device. This function should be called near the start of the device’s runtime_resume callback. Copyright
blk_post_runtime_suspend – Post runtime suspend processing Synopsis void blk_post_runtime_suspend(struct request_queue *q, int err); Arguments q the queue of the device err return value of the device’s runtime_suspend function Description Update the queue’s runtime status according to the return value of the device’s runtime suspend function and mark last busy for the device so that PM…
blk_post_runtime_resume – Post runtime resume processing Synopsis void blk_post_runtime_resume(struct request_queue *q, int err); Arguments q the queue of the device err return value of the device’s runtime_resume function Description Update the queue’s runtime status according to the return value of the device’s runtime_resume function. If it is successfully resumed, process the requests that are queued…
blk_pm_runtime_init – Block layer runtime PM initialization routine Synopsis void blk_pm_runtime_init(struct request_queue *q, struct device *dev); Arguments q the queue of the device dev the device the queue belongs to Description Initialize runtime-PM-related fields for q and start auto suspend for dev. Drivers that want to take advantage of request-based runtime PM should call this…
blk_peek_request – peek at the top of a request queue Synopsis struct request *blk_peek_request(struct request_queue *q); Arguments q request queue to peek at Description Return the request at the top of q. The returned request should be started using blk_start_request before LLD starts processing it. Return Pointer to the request at the top of q…
blk_mangle_minor – scatter minor numbers apart Synopsis int blk_mangle_minor(int minor); Arguments minor minor number to mangle Description Scatter consecutively allocated minor number apart if MANGLE_DEVT is enabled. Mangling twice gives the original value. Return Mangled value. Context Don’t care. Copyright
blk_lld_busy – Check if underlying low-level drivers of a device are busy Synopsis int blk_lld_busy(struct request_queue *q); Arguments q the queue of the device being checked Description Check if underlying low-level drivers of a device are busy. If the drivers want to export their busy state, they must set own exporting function using blk_queue_lld_busy first….
blk_limits_io_opt – set optimal request size for a device Synopsis void blk_limits_io_opt(struct queue_limits *limits, unsigned int opt); Arguments limits the queue limits opt smallest I/O size in bytes Description Storage devices may report an optimal I/O size, which is the device’s preferred unit for sustained I/O. This is rarely reported for disk drives. For RAID…
blk_limits_io_min – set minimum request size for a device Synopsis void blk_limits_io_min(struct queue_limits *limits, unsigned int min); Arguments limits the queue limits min smallest I/O size in bytes Description Some devices have an internal block size bigger than the reported hardware sector size. This function can be used to signal the smallest I/O the device…
blk_integrity_unregister – Unregister block integrity profile Synopsis void blk_integrity_unregister(struct gendisk *disk); Arguments disk disk whose integrity profile to unregister Description This function unregisters the integrity capability from a block device. Copyright
blk_integrity_register – Register a gendisk as being integrity-capable Synopsis void blk_integrity_register(struct gendisk *disk, struct blk_integrity *template); Arguments disk struct gendisk pointer to make integrity-aware template block integrity profile to register Description When a device needs to advertise itself as being able to send/receive integrity metadata it must use this function to register the capability with…
blk_integrity_compare – Compare integrity profile of two disks Synopsis int blk_integrity_compare(struct gendisk *gd1, struct gendisk *gd2); Arguments gd1 Disk to compare gd2 Disk to compare Description Meta-devices like DM and MD need to verify that all sub-devices use the same integrity format before advertising to upper layers that they can send/receive integrity metadata. This function…
blk_insert_cloned_request – Helper for stacking drivers to submit a request Synopsis int blk_insert_cloned_request(struct request_queue *q, struct request *rq); Arguments q the queue to submit the request rq the request being queued Copyright
blk_init_tags – initialize the tag info for an external tag map Synopsis struct blk_queue_tag *blk_init_tags(int depth, int alloc_policy); Arguments depth the maximum queue depth supported alloc_policy tag allocation policy Copyright
blk_init_queue – prepare a request queue for use with a block device Synopsis struct request_queue *blk_init_queue(request_fn_proc *rfn, spinlock_t *lock); Arguments rfn The function to be called to process requests that have been placed on the queue. lock Request queue spin lock Description If a block device wishes to use the standard request handling procedures, which…
blk_get_backing_dev_info – get the address of a queue’s backing_dev_info Synopsis struct backing_dev_info *blk_get_backing_dev_info(struct block_device *bdev); Arguments bdev device Description Locates the passed device’s request queue and returns the address of its backing_dev_info. This function can only be called if bdev is opened and the return value is never NULL. Copyright
blk_free_tags – release a given set of tag maintenance info Synopsis void blk_free_tags(struct blk_queue_tag *bqt); Arguments bqt the tag map to free Description Drop the reference count on bqt and frees it when the last reference is dropped. Copyright
blk_free_devt – free a dev_t Synopsis void blk_free_devt(dev_t devt); Arguments devt dev_t to free Description Free devt which was allocated using blk_alloc_devt. Context Might sleep. Copyright
blk_fetch_request – fetch a request from a request queue Synopsis struct request *blk_fetch_request(struct request_queue *q); Arguments q request queue to fetch a request from Description Return the request at the top of q. The request is started on return and LLD can start processing it immediately. Return Pointer to the request at the top of…