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.
scsi_device_resume – Restart user issued commands to a quiesced device. Synopsis void scsi_device_resume(struct scsi_device *sdev); Arguments sdev scsi device to resume. Description Moves the device from quiesced back to running and restarts the queues. Must be called with user context, may sleep. Authors James Bottomley <James.Bottomley [at] hansenpartnership.com> Author. Rob Landley <rob [at] landley.net> Author….
scsi_device_quiesce – Block user issued commands. Synopsis int scsi_device_quiesce(struct scsi_device *sdev); Arguments sdev scsi device to quiesce. Description This works by trying to transition to the SDEV_QUIESCE state (which must be a legal transition). When the device is in this state, only special requests will be accepted, all others will be deferred. Since special requests…
scsi_device_put – release a reference to a scsi_device Synopsis void scsi_device_put(struct scsi_device *sdev); Arguments sdev device to release a reference on. Description Release a reference to the scsi_device and decrements the use count of the underlying LLDD module. The device is freed once the last user vanishes. Authors James Bottomley <James.Bottomley [at] hansenpartnership.com> Author. Rob…
scsi_device_lookup_by_target – find a device given the target Synopsis struct scsi_device *scsi_device_lookup_by_target(struct scsi_target *starget, u64 lun); Arguments starget SCSI target pointer lun SCSI Logical Unit Number Description Looks up the scsi_device with the specified lun for a given starget. The returned scsi_device has an additional reference that needs to be released with scsi_device_put once you’re…
scsi_device_lookup – find a device given the host Synopsis struct scsi_device *scsi_device_lookup(struct Scsi_Host *shost, uint channel, uint id, u64 lun); Arguments shost SCSI host pointer channel SCSI channel (zero if only one channel) id SCSI target number (physical unit number) lun SCSI Logical Unit Number Description Looks up the scsi_device with the specified channel, id,…
scsi_device_get – get an additional reference to a scsi_device Synopsis int scsi_device_get(struct scsi_device *sdev); Arguments sdev device to get a reference to Description Gets a reference to the scsi_device and increments the use count of the underlying LLDD module. You must hold host_lock of the parent Scsi_Host or already have a reference when calling this….
scsi_dev_info_list_find – find a matching dev_info list entry. Synopsis struct scsi_dev_info_list *scsi_dev_info_list_find(const char *vendor, const char *model, int key); Arguments vendor vendor string model model (product) string key specify list to use Description Finds the first dev_info entry matching vendor, model in list specified by key. Return pointer to matching entry, or ERR_PTR on failure….
scsi_dev_info_list_add_str – parse dev_list and add to the scsi_dev_info_list. Synopsis int scsi_dev_info_list_add_str(char *dev_list); Arguments dev_list string of device flags to add Description Parse dev_list, and add entries to the scsi_dev_info_list. dev_list is of the form “vendor:product:flag,vendor:product:flag”. dev_list is modified via strsep. Can be called for command line addition, for proc or mabye a sysfs interface….
scsi_dev_info_list_add – add one dev_info list entry. Synopsis int scsi_dev_info_list_add(int compatible, char *vendor, char *model, char *strflags, int flags); Arguments compatible if true, null terminate short strings. Otherwise space pad. vendor vendor string model model (product) string strflags integer string flags if strflags NULL, use this flag value Description Create and add one dev_info entry…
scsi_complete_async_scans – Wait for asynchronous scans to complete Synopsis int scsi_complete_async_scans(void); Arguments void no arguments Description When this function returns, any host which started scanning before this function was called will have finished its scan. Hosts which started scanning after this function was called may or may not have finished. Authors James Bottomley <James.Bottomley [at]…
scsi_cmd_get_serial – Assign a serial number to a command Synopsis void scsi_cmd_get_serial(struct Scsi_Host *host, struct scsi_cmnd *cmd); Arguments host the scsi host cmd command to assign serial number to Description a serial number identifies a request for error recovery and debugging purposes. Protected by the Host_Lock of host. Authors James Bottomley <James.Bottomley [at] hansenpartnership.com> Author….
scsi_check_sense – Examine scsi cmd sense Synopsis int scsi_check_sense(struct scsi_cmnd *scmd); Arguments scmd Cmd to have sense checked. Description Return value: SUCCESS or FAILED or NEEDS_RETRY or ADD_TO_MLQUEUE Notes When a deferred error is detected the current command has not been executed and needs retrying. Authors James Bottomley <James.Bottomley [at] hansenpartnership.com> Author. Rob Landley <rob…
scsi_change_queue_depth – change a device’s queue depth Synopsis int scsi_change_queue_depth(struct scsi_device *sdev, int depth); Arguments sdev SCSI Device in question depth number of commands allowed to be queued to the driver Description Sets the device queue depth and returns the new value. Authors James Bottomley <James.Bottomley [at] hansenpartnership.com> Author. Rob Landley <rob [at] landley.net> Author….
scsi_block_when_processing_errors – Prevent cmds from being queued. Synopsis int scsi_block_when_processing_errors(struct scsi_device *sdev); Arguments sdev Device on which we are performing recovery. Description We block until the host is out of error recovery, and then check to see whether the host or the device is offline. Return value: 0 when dev was taken offline by error…
scsi_bios_ptable – Read PC partition table out of first sector of device. Synopsis unsigned char *scsi_bios_ptable(struct block_device *dev); Arguments dev from this device Description Reads the first sector from the device and returns 0x42 bytes starting at offset 0x1be. Return partition table in kmalloc(GFP_KERNEL) memory, or NULL on error. Authors James Bottomley <James.Bottomley [at] hansenpartnership.com>…
scsi_alloc_target – allocate a new or find an existing target Synopsis struct scsi_target *scsi_alloc_target(struct device *parent, int channel, uint id); Arguments parent parent of the target (need not be a scsi host) channel target channel number (zero if no channels) id target id number Description Return an existing target if one exists, provided it hasn’t…
scsi_alloc_sdev – allocate and setup a scsi_Device Synopsis struct scsi_device *scsi_alloc_sdev(struct scsi_target *starget, u64 lun, void *hostdata); Arguments starget which target to allocate a scsi_device for lun which lun hostdata usually NULL and set by ->slave_alloc instead Description Allocate, initialize for io, and return a pointer to a scsi_Device. Stores the shost, channel, id, and…
scsi_add_single_device – Respond to user request to probe for/add device Synopsis int scsi_add_single_device(uint host, uint channel, uint id, uint lun); Arguments host user-supplied decimal integer channel user-supplied decimal integer id user-supplied decimal integer lun user-supplied decimal integer Description called by writing “scsi add-single-device” to /proc/scsi/scsi. does scsi_host_lookup and either user_scan if that transport type supports…
scsi_add_lun – allocate and fully initialze a scsi_device Synopsis int scsi_add_lun(struct scsi_device *sdev, unsigned char *inq_result, int *bflags, int async); Arguments sdev holds information to be stored in the new scsi_device inq_result holds the result of a previous INQUIRY to the LUN bflags black/white list flag async 1 if this device is being scanned asynchronously…
scsi_add_host_with_dma – add a scsi host with dma device Synopsis int scsi_add_host_with_dma(struct Scsi_Host *shost, struct device *dev, struct device *dma_dev); Arguments shost scsi host pointer to add dev a struct device of type scsi class dma_dev dma device for the host Note You rarely need to worry about this unless you’re in a virtualised host…