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.
ata_scsi_slave_config – Set SCSI device attributes Synopsis int ata_scsi_slave_config(struct scsi_device *sdev); Arguments sdev SCSI device to examine Description This is called before we actually start reading and writing to the device, to configure certain SCSI mid-layer behaviors. LOCKING: Defined by SCSI layer. We don’t really care. Author Jeff Garzik Author. Copyright
ata_scsi_simulate – simulate SCSI command on ATA device Synopsis void ata_scsi_simulate(struct ata_device *dev, struct scsi_cmnd *cmd); Arguments dev the target device cmd SCSI command being sent to device. Description Interprets and directly executes a select list of SCSI commands that can be handled internally. LOCKING: spin_lock_irqsave(host lock) Author Jeff Garzik Author. Copyright
ata_scsi_rw_xlat – Translate SCSI r/w command into an ATA one Synopsis unsigned int ata_scsi_rw_xlat(struct ata_queued_cmd *qc); Arguments qc Storage for translated ATA taskfile Description Converts any of six SCSI read/write commands into the ATA counterpart, including starting sector (LBA), sector count, and taking into account the device’s LBA48 support. Commands READ_6, READ_10, READ_16, WRITE_6, WRITE_10,…
ata_scsi_report_zones_complete – convert ATA output Synopsis void ata_scsi_report_zones_complete(struct ata_queued_cmd *qc); Arguments qc command structure returning the data Description Convert T-13 little-endian field representation into T-10 big-endian field representation. What a mess. Author Jeff Garzik Author. Copyright
ata_scsi_remove_dev – remove attached SCSI device Synopsis void ata_scsi_remove_dev(struct ata_device *dev); Arguments dev ATA device to remove attached SCSI device for Description This function is called from ata_eh_scsi_hotplug and responsible for removing the SCSI device attached to dev. LOCKING: Kernel thread context (may sleep). Author Jeff Garzik Author. Copyright
ata_scsi_rbuf_put – Unmap response buffer. Synopsis void ata_scsi_rbuf_put(struct scsi_cmnd *cmd, bool copy_out, unsigned long *flags); Arguments cmd SCSI command containing buffer to be unmapped. copy_out copy out result flags flags passed to ata_scsi_rbuf_get Description Returns rbuf buffer. The result is copied to cmd‘s buffer if copy_back is true. LOCKING: Unlocks ata_scsi_rbuf_lock. Author Jeff Garzik Author….
ata_scsi_rbuf_get – Map response buffer. Synopsis void *ata_scsi_rbuf_get(struct scsi_cmnd *cmd, bool copy_in, unsigned long *flags); Arguments cmd SCSI command containing buffer to be mapped. copy_in copy in from user buffer flags unsigned long variable to store irq enable status Description Prepare buffer for simulated SCSI commands. LOCKING: spin_lock_irqsave(ata_scsi_rbuf_lock) on success Return Pointer to response buffer….
ata_scsi_rbuf_fill – wrapper for SCSI command simulators Synopsis void ata_scsi_rbuf_fill(struct ata_scsi_args *args, unsigned int (*actor)(struct ata_scsi_args *args, u8 *rbuf)); Arguments args device IDENTIFY data / SCSI command of interest. actor Callback hook for desired SCSI command simulator Description Takes care of the hard work of simulating a SCSI command… Mapping the response buffer, calling the…
ata_scsi_queuecmd – Issue SCSI cdb to libata-managed device Synopsis int ata_scsi_queuecmd(struct Scsi_Host *shost, struct scsi_cmnd *cmd); Arguments shost SCSI host of command to be sent cmd SCSI command to be sent Description In some cases, this function translates SCSI commands into ATA taskfiles, and queues the taskfiles to be sent to hardware. In other cases,…
ata_scsi_qc_new – acquire new ata_queued_cmd reference Synopsis struct ata_queued_cmd *ata_scsi_qc_new(struct ata_device *dev, struct scsi_cmnd *cmd); Arguments dev ATA device to which the new command is attached cmd SCSI command that originated this ATA command Description Obtain a reference to an unused ata_queued_cmd structure, which is the basic libata structure representing a single ATA command sent…
ata_scsi_pass_thru – convert ATA pass-thru CDB to taskfile Synopsis unsigned int ata_scsi_pass_thru(struct ata_queued_cmd *qc); Arguments qc command structure to be initialized Description Handles either 12 or 16-byte versions of the CDB. Return Zero on success, non-zero on failure. Author Jeff Garzik Author. Copyright
ata_scsi_offline_dev – offline attached SCSI device Synopsis int ata_scsi_offline_dev(struct ata_device *dev); Arguments dev ATA device to offline attached SCSI device for Description This function is called from ata_eh_hotplug and responsible for taking the SCSI device attached to dev offline. This function is called with host lock which protects dev->sdev against clearing. LOCKING: spin_lock_irqsave(host lock) Return…
ata_scsi_mode_select_xlat – Simulate MODE SELECT 6, 10 commands Synopsis unsigned int ata_scsi_mode_select_xlat(struct ata_queued_cmd *qc); Arguments qc Storage for translated ATA taskfile Description Converts a MODE SELECT command to an ATA SET FEATURES taskfile. Assume this is invoked for direct access devices (e.g. disks) only. There should be no block descriptor for other device types. LOCKING:…
ata_scsi_media_change_notify – send media change event Synopsis void ata_scsi_media_change_notify(struct ata_device *dev); Arguments dev Pointer to the disk device with media change event Description Tell the block layer to send a media change notification event. LOCKING: spin_lock_irqsave(host lock) Author Jeff Garzik Author. Copyright
ata_scsi_hotplug – SCSI part of hotplug Synopsis void ata_scsi_hotplug(struct work_struct *work); Arguments work Pointer to ATA port to perform SCSI hotplug on Description Perform SCSI part of hotplug. It’s executed from a separate workqueue after EH completes. This is necessary because SCSI hot plugging requires working EH and hot unplugging is synchronized with hot plugging…
ata_scsi_flush_xlat – Translate SCSI SYNCHRONIZE CACHE command Synopsis unsigned int ata_scsi_flush_xlat(struct ata_queued_cmd *qc); Arguments qc Storage for translated ATA taskfile Description Sets up an ATA taskfile to issue FLUSH CACHE or FLUSH CACHE EXT. LOCKING: spin_lock_irqsave(host lock) Return Zero on success, non-zero on error. Author Jeff Garzik Author. Copyright
ata_scsi_find_dev – lookup ata_device from scsi_cmnd Synopsis struct ata_device *ata_scsi_find_dev(struct ata_port *ap, const struct scsi_device *scsidev); Arguments ap ATA port to which the device is attached scsidev SCSI device from which we derive the ATA device Description Given various information provided in struct scsi_cmnd, map that onto an ATA bus, and using that mapping determine…
ata_scsi_dump_cdb – dump SCSI command contents to dmesg Synopsis void ata_scsi_dump_cdb(struct ata_port *ap, struct scsi_cmnd *cmd); Arguments ap ATA port to which the command was being sent cmd SCSI command to dump Description Prints the contents of a SCSI command via printk. Author Jeff Garzik Author. Copyright
ata_scsi_dev_rescan – initiate scsi_rescan_device Synopsis void ata_scsi_dev_rescan(struct work_struct *work); Arguments work Pointer to ATA port to perform scsi_rescan_device Description After ATA pass thru (SAT) commands are executed successfully, libata need to propagate the changes to SCSI layer. LOCKING: Kernel thread context (may sleep). Author Jeff Garzik Author. Copyright
ata_scsi_change_queue_depth – SCSI callback for queue depth config Synopsis int ata_scsi_change_queue_depth(struct scsi_device *sdev, int queue_depth); Arguments sdev SCSI device to configure queue depth for queue_depth new queue depth Description This is libata standard hostt->change_queue_depth callback. SCSI will call into this callback when user tries to set queue depth via sysfs. LOCKING: SCSI layer (we don’t…