xref: /freebsd/sys/cam/scsi/scsi_targetio.h (revision d0b2dbfa)
1 /*-
2  * Ioctl definitions for the SCSI Target Driver
3  *
4  * SPDX-License-Identifier: BSD-2-Clause
5  *
6  * Copyright (c) 2002 Nate Lawson.
7  * Copyright (c) 1998 Justin T. Gibbs.
8  * All rights reserved.
9  *
10  * Redistribution and use in source and binary forms, with or without
11  * modification, are permitted provided that the following conditions
12  * are met:
13  * 1. Redistributions of source code must retain the above copyright
14  *    notice, this list of conditions, and the following disclaimer,
15  *    without modification, immediately at the beginning of the file.
16  * 2. The name of the author may not be used to endorse or promote products
17  *    derived from this software without specific prior written permission.
18  *
19  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
20  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
21  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
22  * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE FOR
23  * ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
24  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
25  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
26  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
27  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
28  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
29  * SUCH DAMAGE.
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