1653e7d63SEnji Cooper.\" Copyright (c) 2013 Edward Tomasz Napierala 2653e7d63SEnji Cooper.\" Copyright (c) 2015-2017 Alexander Motin <mav@FreeBSD.org> 3*da5069e1SEnji Cooper.\" Copyright (c) 2017 Enji Cooper <ngie@FreeBSD.org> 4653e7d63SEnji Cooper.\" 5653e7d63SEnji Cooper.\" Redistribution and use in source and binary forms, with or without 6653e7d63SEnji Cooper.\" modification, are permitted provided that the following conditions 7653e7d63SEnji Cooper.\" are met: 8653e7d63SEnji Cooper.\" 1. Redistributions of source code must retain the above copyright 9653e7d63SEnji Cooper.\" notice, this list of conditions and the following disclaimer. 10653e7d63SEnji Cooper.\" 2. Redistributions in binary form must reproduce the above copyright 11653e7d63SEnji Cooper.\" notice, this list of conditions and the following disclaimer in the 12653e7d63SEnji Cooper.\" documentation and/or other materials provided with the distribution. 13653e7d63SEnji Cooper.\" 14653e7d63SEnji Cooper.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 15653e7d63SEnji Cooper.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 16653e7d63SEnji Cooper.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 17653e7d63SEnji Cooper.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 18653e7d63SEnji Cooper.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 19653e7d63SEnji Cooper.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 20653e7d63SEnji Cooper.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 21653e7d63SEnji Cooper.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 22653e7d63SEnji Cooper.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 23653e7d63SEnji Cooper.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 24653e7d63SEnji Cooper.\" SUCH DAMAGE. 254b2a6604SEdward Tomasz Napierala.Dd May 28, 2017 26653e7d63SEnji Cooper.Dt CFISCSI 4 27653e7d63SEnji Cooper.Os 28653e7d63SEnji Cooper.Sh NAME 29653e7d63SEnji Cooper.Nm cfiscsi 30653e7d63SEnji Cooper.Nd CAM Target Layer iSCSI target frontend 31653e7d63SEnji Cooper.Sh SYNOPSIS 32653e7d63SEnji CooperTo compile this driver into the kernel, 33653e7d63SEnji Cooperplace the following lines in your 34653e7d63SEnji Cooperkernel configuration file: 35653e7d63SEnji Cooper.Bd -ragged -offset indent 36653e7d63SEnji Cooper.Cd "device cfiscsi" 37653e7d63SEnji Cooper.Cd "device ctl" 38653e7d63SEnji Cooper.Cd "device iscsi" 39653e7d63SEnji Cooper.Ed 40653e7d63SEnji Cooper.Pp 41653e7d63SEnji CooperAlternatively, to load the driver as a 42653e7d63SEnji Coopermodule at boot time, place the following line in 43653e7d63SEnji Cooper.Xr loader.conf 5 : 44653e7d63SEnji Cooper.Bd -literal -offset indent 45653e7d63SEnji Coopercfiscsi_load="YES" 46653e7d63SEnji Cooper.Ed 47653e7d63SEnji Cooper.Sh DESCRIPTION 48653e7d63SEnji CooperThe 49653e7d63SEnji Cooper.Nm 504b2a6604SEdward Tomasz Napieralasubsystem provides the kernel component of an iSCSI target. 514b2a6604SEdward Tomasz NapieralaThe target is the iSCSI server, providing LUNs backed by local files 524b2a6604SEdward Tomasz Napieralaand volumes to remote initiators. 534b2a6604SEdward Tomasz NapieralaThe userspace component is provided by 544b2a6604SEdward Tomasz Napierala.Xr ctld 8 . 554b2a6604SEdward Tomasz Napierala.Nm 564b2a6604SEdward Tomasz Napieralais implemented as a 57653e7d63SEnji Cooper.Xr ctl 4 584b2a6604SEdward Tomasz Napieralafrontend and uses infrastructure provided by 59653e7d63SEnji Cooper.Xr iscsi 4 . 60653e7d63SEnji Cooper.Sh SYSCTL VARIABLES 61653e7d63SEnji CooperThe following variables are available as both 62653e7d63SEnji Cooper.Xr sysctl 8 63653e7d63SEnji Coopervariables and 64653e7d63SEnji Cooper.Xr loader 8 65653e7d63SEnji Coopertunables: 66653e7d63SEnji Cooper.Bl -tag -width indent 67653e7d63SEnji Cooper.It Va kern.cam.ctl.iscsi.debug 68653e7d63SEnji CooperVerbosity level for log messages from the kernel part of iSCSI target. 69653e7d63SEnji CooperSet to 0 to disable logging or 1 to warn about potential problems. 70653e7d63SEnji CooperLarger values enable debugging output. 71653e7d63SEnji CooperDefaults to 1. 72653e7d63SEnji Cooper.It Va kern.cam.ctl.iscsi.maxtags 73653e7d63SEnji CooperThe number of outstanding commands to advertise to each iSCSI initiator. 74653e7d63SEnji CooperCurrent implementation is not very accurate, so do not set this below 2. 75653e7d63SEnji CooperDefaults to 256. 76653e7d63SEnji Cooper.It Va kern.cam.ctl.iscsi.ping_timeout 77653e7d63SEnji CooperThe number of seconds to wait for the iSCSI initiator to respond to a NOP-In 78653e7d63SEnji CooperPDU. 79653e7d63SEnji CooperIn the event that there is no response within that time the session gets 80653e7d63SEnji Cooperforcibly terminated. 81653e7d63SEnji CooperSet to 0 to disable sending NOP-In PDUs. 82653e7d63SEnji CooperDefaults to 5. 83653e7d63SEnji Cooper.El 84653e7d63SEnji Cooper.Sh SEE ALSO 85653e7d63SEnji Cooper.Xr ctl 4 , 864b2a6604SEdward Tomasz Napierala.Xr iscsi 4 , 874b2a6604SEdward Tomasz Napierala.Xr ctl.conf 5 , 884b2a6604SEdward Tomasz Napierala.Xr ctld 8 89653e7d63SEnji Cooper.Sh HISTORY 90653e7d63SEnji CooperThe 91653e7d63SEnji Cooper.Nm 92653e7d63SEnji Coopersubsystem first appeared in 93653e7d63SEnji Cooper.Fx 10.0 94653e7d63SEnji Cooperas part of the 95653e7d63SEnji Cooper.Xr ctl 4 96653e7d63SEnji Cooperdriver. 97653e7d63SEnji CooperIt was split off of 98653e7d63SEnji Cooper.Xr ctl 4 99653e7d63SEnji Cooperin 100653e7d63SEnji Cooper.Fx 12.0 . 101653e7d63SEnji Cooper.Sh AUTHORS 102653e7d63SEnji Cooper.An -nosplit 103653e7d63SEnji CooperThe 104653e7d63SEnji Cooper.Nm 105653e7d63SEnji Coopersubsystem was developed by 106653e7d63SEnji Cooper.An Edward Tomasz Napierala Aq Mt trasz@FreeBSD.org 107653e7d63SEnji Cooperunder sponsorship from the FreeBSD Foundation. 108653e7d63SEnji CooperThis manual page was written by 109*da5069e1SEnji Cooper.An Enji Cooper Aq Mt ngie@FreeBSD.org . 110