xref: /freebsd/sys/cam/scsi/scsi_targetio.h (revision 8d20be1e22095c27faf8fe8b2f0d089739cc742e)
1 /*-
2  * Ioctl definitions for the SCSI Target Driver
3  *
4  * Copyright (c) 2002 Nate Lawson.
5  * Copyright (c) 1998 Justin T. Gibbs.
6  * All rights reserved.
7  *
8  * Redistribution and use in source and binary forms, with or without
9  * modification, are permitted provided that the following conditions
10  * are met:
11  * 1. Redistributions of source code must retain the above copyright
12  *    notice, this list of conditions, and the following disclaimer,
13  *    without modification, immediately at the beginning of the file.
14  * 2. The name of the author may not be used to endorse or promote products
15  *    derived from this software without specific prior written permission.
16  *
17  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
18  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
19  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
20  * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE FOR
21  * ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
22  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
23  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
24  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
25  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
26  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
27  * SUCH DAMAGE.
28  *
29  * $FreeBSD$
30  */
31 
32 #ifndef _CAM_SCSI_SCSI_TARGETIO_H_
33 #define _CAM_SCSI_SCSI_TARGETIO_H_
34 #ifndef _KERNEL
35 #include <sys/types.h>
36 #endif
37 #include <sys/ioccom.h>
38 
39 #include <cam/cam.h>
40 #include <cam/cam_ccb.h>
41 
42 /*
43  * CCBs (ATIO, CTIO, INOT, REL_SIMQ) are sent to the kernel driver
44  * by writing one or more pointers.  The user receives notification
45  * of CCB completion through poll/select/kqueue and then calls
46  * read(2) which outputs pointers to the completed CCBs.
47  */
48 
49 /*
50  * Enable and disable a target mode instance.  For enabling, the path_id,
51  * target_id, and lun_id fields must be set.  The grp6/7_len fields
52  * specify the length of vendor-specific CDBs the target expects and
53  * should normally be set to 0.  On successful completion
54  * of enable, the specified target instance will answer selection.
55  * Disable causes the target instance to abort any outstanding commands
56  * and stop accepting new ones.  The aborted CCBs will be returned to
57  * the user via read(2) or discarded if the user closes the device.
58  * The user can then re-enable the device for a new path.
59  */
60 struct ioc_enable_lun {
61 	path_id_t	path_id;
62 	target_id_t	target_id;
63 	lun_id_t	lun_id;
64 	int		grp6_len;
65 	int		grp7_len;
66 };
67 #define TARGIOCENABLE	_IOW('C', 5, struct ioc_enable_lun)
68 #define TARGIOCDISABLE	 _IO('C', 6)
69 
70 /*
71  * Set/clear debugging for this target mode instance
72  */
73 #define	TARGIOCDEBUG	_IOW('C', 7, int)
74 
75 TAILQ_HEAD(ccb_queue, ccb_hdr);
76 
77 #endif /* _CAM_SCSI_SCSI_TARGETIO_H_ */
78