diff options
Diffstat (limited to 'sys/cam/ctl/ctl_frontend.h')
-rw-r--r-- | sys/cam/ctl/ctl_frontend.h | 295 |
1 files changed, 295 insertions, 0 deletions
diff --git a/sys/cam/ctl/ctl_frontend.h b/sys/cam/ctl/ctl_frontend.h new file mode 100644 index 0000000..b286476 --- /dev/null +++ b/sys/cam/ctl/ctl_frontend.h @@ -0,0 +1,295 @@ +/*- + * Copyright (c) 2003 Silicon Graphics International Corp. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions, and the following disclaimer, + * without modification. + * 2. Redistributions in binary form must reproduce at minimum a disclaimer + * substantially similar to the "NO WARRANTY" disclaimer below + * ("Disclaimer") and any redistribution must be conditioned upon + * including a substantially similar Disclaimer requirement for further + * binary redistribution. + * + * NO WARRANTY + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT + * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR + * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT + * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL + * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS + * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) + * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, + * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE + * POSSIBILITY OF SUCH DAMAGES. + * + * $Id: //depot/users/kenm/FreeBSD-test2/sys/cam/ctl/ctl_frontend.h#2 $ + * $FreeBSD$ + */ +/* + * CAM Target Layer front end registration hooks + * + * Author: Ken Merry <ken@FreeBSD.org> + */ + +#ifndef _CTL_FRONTEND_H_ +#define _CTL_FRONTEND_H_ + +typedef enum { + CTL_PORT_STATUS_NONE = 0x00, + CTL_PORT_STATUS_ONLINE = 0x01, + CTL_PORT_STATUS_TARG_ONLINE = 0x02, + CTL_PORT_STATUS_LUN_ONLINE = 0x04 +} ctl_port_status; + +typedef void (*port_func_t)(void *onoff_arg); +typedef int (*targ_func_t)(void *arg, struct ctl_id targ_id); +typedef int (*lun_func_t)(void *arg, struct ctl_id targ_id, int lun_id); + +/* + * The ctl_frontend structure is the registration mechanism between a FETD + * (Front End Target Driver) and the CTL layer. Here is a description of + * the fields: + * + * port_type: This field tells CTL what kind of front end it is + * dealing with. This field serves two purposes. + * The first is to let CTL know whether the frontend + * in question is inside the main CTL module (i.e. + * the ioctl front end), and therefore its module + * reference count shouldn't be incremented. The + * CTL ioctl front end should continue to use the + * CTL_PORT_IOCTL argument as long as it is part of + * the main CTL module. The second is to let CTL + * know what kind of front end it is dealing with, so + * it can return the proper inquiry data for that + * particular port. + * + * num_requested_ctl_io: This is the number of ctl_io structures that the + * front end needs for its pool. This should + * generally be the maximum number of outstanding + * transactions that the FETD can handle. The CTL + * layer will add a few to this to account for + * ctl_io buffers queued for pending sense data. + * (Pending sense only gets queued if the FETD + * doesn't support autosense. e.g. non-packetized + * parallel SCSI doesn't support autosense.) + * + * port_name: A string describing the FETD. e.g. "LSI 1030T U320" + * or whatever you want to use to describe the driver. + * + * + * physical_port: This is the physical port number of this + * particular port within the driver/hardware. This + * number is hardware/driver specific. + * virtual_port: This is the virtual port number of this + * particular port. This is for things like NP-IV. + * + * port_online(): This function is called, with onoff_arg as its + * argument, by the CTL layer when it wants the FETD + * to start responding to selections on the specified + * target ID. (targ_target) + * + * port_offline(): This function is called, with onoff_arg as its + * argument, by the CTL layer when it wants the FETD + * to stop responding to selection on the specified + * target ID. (targ_target) + * + * onoff_arg: This is supplied as an argument to port_online() + * and port_offline(). This is specified by the + * FETD. + * + * targ_enable(): This function is called, with targ_lun_arg and a + * target ID as its arguments, by CTL when it wants + * the FETD to enable a particular target. targ_enable() + * will always be called for a particular target ID + * before any LUN is enabled for that target. If the + * FETD does not support enabling targets, but rather + * LUNs, it should ignore this call and return 0. If + * the FETD does support enabling targets, it should + * return 0 for success and non-zero if it cannot + * enable the given target. + * + * TODO: Add the ability to specify a WWID here. + * + * targ_disable(): This function is called, with targ_lun_arg and a + * target ID as its arguments, by CTL when it wants + * the FETD to disable a particular target. + * targ_disable() will always be called for a + * particular target ID after all LUNs are disabled + * on that particular target. If the FETD does not + * support enabling targets, it should ignore this + * call and return 0. If the FETD does support + * enabling targets, it should return 0 for success, + * and non-zero if it cannot disable the given target. + * + * lun_enable(): This function is called, with targ_lun_arg, a target + * ID and a LUN ID as its arguments, by CTL when it + * wants the FETD to enable a particular LUN. If the + * FETD doesn't really know about LUNs, it should + * just ignore this call and return 0. If the FETD + * cannot enable the requested LUN for some reason, the + * FETD should return non-zero status. + * + * lun_disable(): This function is called, with targ_lun_arg, a target + * ID and LUN ID as its arguments, by CTL when it + * wants the FETD to disable a particular LUN. If the + * FETD doesn't really know about LUNs, it should just + * ignore this call and return 0. If the FETD cannot + * disable the requested LUN for some reason, the + * FETD should return non-zero status. + * + * targ_lun_arg: This is supplied as an argument to the targ/lun + * enable/disable() functions. This is specified by + * the FETD. + * + * fe_datamove(): This function is called one or more times per I/O + * by the CTL layer to tell the FETD to initiate a + * DMA to or from the data buffer(s) specified by + * the passed-in ctl_io structure. + * + * fe_done(): This function is called by the CTL layer when a + * particular SCSI I/O or task management command has + * completed. For SCSI I/O requests (CTL_IO_SCSI), + * sense data is always supplied if the status is + * CTL_SCSI_ERROR and the SCSI status byte is + * SCSI_STATUS_CHECK_COND. If the FETD doesn't + * support autosense, the sense should be queued + * back to the CTL layer via ctl_queue_sense(). + * + * fe_dump(): This function, if it exists, is called by CTL + * to request a dump of any debugging information or + * state to the console. + * + * max_targets: The maximum number of targets that we can create + * per-port. + * + * max_target_id: The highest target ID that we can use. + * + * targ_port: The CTL layer assigns a "port number" to every + * FETD. This port number should be passed back in + * in the header of every ctl_io that is queued to + * the CTL layer. This enables us to determine + * which bus the command came in on. + * + * ctl_pool_ref: Memory pool reference used by the FETD in calls to + * ctl_alloc_io(). + * + * max_initiators: Maximum number of initiators that the FETD is + * allowed to have. Initiators should be numbered + * from 0 to max_initiators - 1. This value will + * typically be 16, and thus not a problem for + * parallel SCSI. This may present issues for Fibre + * Channel. + * + * wwnn World Wide Node Name to be used by the FETD. + * Note that this is set *after* registration. It + * will be set prior to the online function getting + * called. + * + * wwpn World Wide Port Name to be used by the FETD. + * Note that this is set *after* registration. It + * will be set prior to the online function getting + * called. + * + * status: Used by CTL to keep track of per-FETD state. + * + * links: Linked list pointers, used by CTL. The FETD + * shouldn't touch this field. + */ +struct ctl_frontend { + ctl_port_type port_type; /* passed to CTL */ + int num_requested_ctl_io; /* passed to CTL */ + char *port_name; /* passed to CTL */ + int physical_port; /* passed to CTL */ + int virtual_port; /* passed to CTL */ + port_func_t port_online; /* passed to CTL */ + port_func_t port_offline; /* passed to CTL */ + void *onoff_arg; /* passed to CTL */ + targ_func_t targ_enable; /* passed to CTL */ + targ_func_t targ_disable; /* passed to CTL */ + lun_func_t lun_enable; /* passed to CTL */ + lun_func_t lun_disable; /* passed to CTL */ + void *targ_lun_arg; /* passed to CTL */ + void (*fe_datamove)(union ctl_io *io); /* passed to CTL */ + void (*fe_done)(union ctl_io *io); /* passed to CTL */ + void (*fe_dump)(void); /* passed to CTL */ + int max_targets; /* passed to CTL */ + int max_target_id; /* passed to CTL */ + int32_t targ_port; /* passed back to FETD */ + void *ctl_pool_ref; /* passed back to FETD */ + uint32_t max_initiators; /* passed back to FETD */ + uint64_t wwnn; /* set by CTL before online */ + uint64_t wwpn; /* set by CTL before online */ + ctl_port_status status; /* used by CTL */ + STAILQ_ENTRY(ctl_frontend) links; /* used by CTL */ +}; + +/* + * This may block until resources are allocated. Called at FETD module load + * time. Returns 0 for success, non-zero for failure. + */ +int ctl_frontend_register(struct ctl_frontend *fe, int master_SC); + +/* + * Called at FETD module unload time. + * Returns 0 for success, non-zero for failure. + */ +int ctl_frontend_deregister(struct ctl_frontend *fe); + +/* + * Called to set the WWNN and WWPN for a particular frontend. + */ +void ctl_frontend_set_wwns(struct ctl_frontend *fe, int wwnn_valid, + uint64_t wwnn, int wwpn_valid, uint64_t wwpn); + +/* + * Called to bring a particular frontend online. + */ +void ctl_frontend_online(struct ctl_frontend *fe); + +/* + * Called to take a particular frontend offline. + */ +void ctl_frontend_offline(struct ctl_frontend *fe); + +/* + * This routine queues I/O and task management requests from the FETD to the + * CTL layer. Returns immediately. Returns 0 for success, non-zero for + * failure. + */ +int ctl_queue(union ctl_io *io); + +/* + * This routine is used if the front end interface doesn't support + * autosense (e.g. non-packetized parallel SCSI). This will queue the + * scsiio structure back to a per-lun pending sense queue. This MUST be + * called BEFORE any request sense can get queued to the CTL layer -- I + * need it in the queue in order to service the request. The scsiio + * structure passed in here will be freed by the CTL layer when sense is + * retrieved by the initiator. Returns 0 for success, non-zero for failure. + */ +int ctl_queue_sense(union ctl_io *io); + +/* + * This routine adds an initiator to CTL's port database. The WWPN should + * be the FC WWPN, if available. The targ_port field should be the same as + * the targ_port passed back from CTL in the ctl_frontend structure above. + * The iid field should be the same as the iid passed in the nexus of each + * ctl_io from this initiator. + */ +int ctl_add_initiator(uint64_t wwpn, int32_t targ_port, uint32_t iid); + +/* + * This routine will remove an initiator from CTL's port database. The + * targ_port field should be the same as the targ_port passed back in the + * ctl_frontend structure above. The iid field should be the same as the + * iid passed in the nexus of each ctl_io from this initiator. + */ +int +ctl_remove_initiator(int32_t targ_port, uint32_t iid); + +#endif /* _CTL_FRONTEND_H_ */ |