11072c68cSEdward Tomasz Napierala.\" Copyright (c) 2015, Mellanox Technologies, Inc. All rights reserved. 21072c68cSEdward Tomasz Napierala.\" 31072c68cSEdward Tomasz Napierala.\" Redistribution and use in source and binary forms, with or without 41072c68cSEdward Tomasz Napierala.\" modification, are permitted provided that the following conditions 51072c68cSEdward Tomasz Napierala.\" are met: 61072c68cSEdward Tomasz Napierala.\" 1. Redistributions of source code must retain the above copyright 71072c68cSEdward Tomasz Napierala.\" notice, this list of conditions and the following disclaimer. 81072c68cSEdward Tomasz Napierala.\" 2. Redistributions in binary form must reproduce the above copyright 91072c68cSEdward Tomasz Napierala.\" notice, this list of conditions and the following disclaimer in the 101072c68cSEdward Tomasz Napierala.\" documentation and/or other materials provided with the distribution. 111072c68cSEdward Tomasz Napierala.\" 121072c68cSEdward Tomasz Napierala.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 131072c68cSEdward Tomasz Napierala.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 141072c68cSEdward Tomasz Napierala.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 151072c68cSEdward Tomasz Napierala.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 161072c68cSEdward Tomasz Napierala.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 171072c68cSEdward Tomasz Napierala.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 181072c68cSEdward Tomasz Napierala.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 191072c68cSEdward Tomasz Napierala.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 201072c68cSEdward Tomasz Napierala.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 211072c68cSEdward Tomasz Napierala.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 221072c68cSEdward Tomasz Napierala.\" SUCH DAMAGE. 231072c68cSEdward Tomasz Napierala.\" 241072c68cSEdward Tomasz Napierala.\" 251072c68cSEdward Tomasz Napierala.\" $FreeBSD$ 261072c68cSEdward Tomasz Napierala.Dd June 6, 2016 271072c68cSEdward Tomasz Napierala.Dt ISER 4 281072c68cSEdward Tomasz Napierala.Os 291072c68cSEdward Tomasz Napierala.Sh NAME 301072c68cSEdward Tomasz Napierala.Nm iser 31*8cf995b3SEdward Tomasz Napierala.Nd iSCSI Extensions for RDMA (iSER) driver 321072c68cSEdward Tomasz Napierala.Sh SYNOPSIS 331072c68cSEdward Tomasz NapieralaTo compile this driver into the kernel, 341072c68cSEdward Tomasz Napieralaplace the following line in the 351072c68cSEdward Tomasz Napieralakernel configuration file: 361072c68cSEdward Tomasz Napierala.Bd -ragged -offset indent 371072c68cSEdward Tomasz Napierala.Cd "device iser" 381072c68cSEdward Tomasz Napierala.Ed 391072c68cSEdward Tomasz Napierala.Pp 401072c68cSEdward Tomasz NapieralaAlternatively, to load the driver as a 411072c68cSEdward Tomasz Napieralamodule at boot time, place the following line in 421072c68cSEdward Tomasz Napierala.Xr loader.conf 5 : 431072c68cSEdward Tomasz Napierala.Bd -literal -offset indent 441072c68cSEdward Tomasz Napieralaiser_load="YES" 451072c68cSEdward Tomasz Napierala.Ed 461072c68cSEdward Tomasz Napierala.Sh DESCRIPTION 471072c68cSEdward Tomasz NapieralaThe 481072c68cSEdward Tomasz Napierala.Nm 491072c68cSEdward Tomasz Napierala(iSCSI Extensions for RDMA) initiator driver extends the iSCSI protocol to RDMA. 501072c68cSEdward Tomasz NapieralaIt permits data to be transferred directly into and out of SCSI buffers 511072c68cSEdward Tomasz Napieralawithout intermediate data copies. 521072c68cSEdward Tomasz NapieralaiSER uses the RDMA protocol suite to supply higher bandwidth for 53*8cf995b3SEdward Tomasz Napieralablock storage transfers (zero copy behavior). 54*8cf995b3SEdward Tomasz NapieralaTo that fact, it eliminates the 551072c68cSEdward Tomasz NapieralaTCP/IP processing overhead while preserving the compatibility with iSCSI protocol. 561072c68cSEdward Tomasz NapieralaThe initiator is the iSCSI/iSER client, which connects to an iSCSI/iSER target, 571072c68cSEdward Tomasz Napieralaproviding local access to a remote block device. 581072c68cSEdward Tomasz NapieralaThe userland component is provided by 591072c68cSEdward Tomasz Napierala.Xr iscsid 8 601072c68cSEdward Tomasz Napieralaand both the kernel and userland are configured using 611072c68cSEdward Tomasz Napierala.Xr iscsictl 8 . 621072c68cSEdward Tomasz Napierala.Sh SYSCTL VARIABLES 631072c68cSEdward Tomasz NapieralaThe following variables are available as both 641072c68cSEdward Tomasz Napierala.Xr sysctl 8 651072c68cSEdward Tomasz Napieralavariables and 661072c68cSEdward Tomasz Napierala.Xr loader 8 671072c68cSEdward Tomasz Napieralatunables: 681072c68cSEdward Tomasz Napierala.Bl -tag -width indent 691072c68cSEdward Tomasz Napierala.It Va kern.iser.debug 701072c68cSEdward Tomasz NapieralaVerbosity level for log messages from the 711072c68cSEdward Tomasz Napierala.Nm 721072c68cSEdward Tomasz Napieraladriver. 731072c68cSEdward Tomasz NapieralaSet to 0 to disable logging or 1 to warn about potential problems. 741072c68cSEdward Tomasz NapieralaLarger values enable info and debugging output. 751072c68cSEdward Tomasz NapieralaDefaults to 0. 761072c68cSEdward Tomasz Napierala.El 771072c68cSEdward Tomasz Napierala.Sh SEE ALSO 781072c68cSEdward Tomasz Napierala.Xr iscsi 4 , 791072c68cSEdward Tomasz Napierala.Xr iscsi.conf 5 , 801072c68cSEdward Tomasz Napierala.Xr iscsictl 8 , 811072c68cSEdward Tomasz Napierala.Xr iscsid 8 821072c68cSEdward Tomasz Napierala.Sh HISTORY 831072c68cSEdward Tomasz NapieralaThe 841072c68cSEdward Tomasz Napierala.Nm 851072c68cSEdward Tomasz Napieralasubsystem first appeared in 861072c68cSEdward Tomasz Napierala.Fx 11.0 . 871072c68cSEdward Tomasz Napierala.Sh AUTHORS 881072c68cSEdward Tomasz NapieralaThe 891072c68cSEdward Tomasz Napierala.Nm 901072c68cSEdward Tomasz Napieralasubsystem was developed by 911072c68cSEdward Tomasz Napierala.An Max Gurtovoy Aq Mt maxg@mellanox.com 921072c68cSEdward Tomasz Napieralaand 931072c68cSEdward Tomasz Napierala.An Sagi Grimberg Aq Mt sagig@mellanox.com 941072c68cSEdward Tomasz Napieralaunder sponsorship from Mellanox Technologies. 95