6fea88c26e
- debug log is now using syslog - seperate options for log level and foreground mode - writes a pidfile so that /etc/rc.d/iscsid works Now links with libutil for pidfile(), the functions login() and logout() needed to be renamed to avoid a conflict. - drops the nothreads option - handles signals to shut down gracefully - the driver may also shut down the daemon when it terminates Currently this cannot work as the driver can only terminate when the daemon has closed the driver file handle.
102 lines
3.0 KiB
Groff
102 lines
3.0 KiB
Groff
.\" $NetBSD: iscsid.8,v 1.13 2016/05/29 13:35:45 mlelstv Exp $
|
|
.\"
|
|
.\" Copyright (c) 2011 Alistair Crooks <agc@NetBSD.org>
|
|
.\" 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.
|
|
.\" 2. Redistributions in binary form must reproduce the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer in the
|
|
.\" documentation and/or other materials provided with the distribution.
|
|
.\"
|
|
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
|
|
.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
|
|
.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
|
|
.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
|
|
.\" INCIDENTAL, 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 DAMAGE.
|
|
.\"
|
|
.Dd November 10, 2015
|
|
.Dt ISCSID 8
|
|
.Os
|
|
.Sh NAME
|
|
.Nm iscsid
|
|
.Nd interface to kernel iSCSI driver
|
|
.Sh SYNOPSIS
|
|
.Nm
|
|
.Op Fl D
|
|
.Op Fl d Ar lvl
|
|
.Sh DESCRIPTION
|
|
The iSCSI initiator runs as a kernel driver, and provides access
|
|
to iSCSI targets running across a network using the iSCSI protocol,
|
|
RFC 3720.
|
|
The
|
|
.Nm
|
|
utility itself interfaces to the kernel iSCSI driver, and also
|
|
communicates, using
|
|
.Xr isns 3 ,
|
|
with the iSCSI name service running on other hosts
|
|
to locate services and iSCSI instances.
|
|
In normal operation,
|
|
.Nm
|
|
is a standard daemon, and will detach from the controlling
|
|
terminal using
|
|
.Xr daemon 3
|
|
and then loops, reading requests, processing them,
|
|
and sending responses.
|
|
Communication takes place over a
|
|
Unix domain socket.
|
|
.Nm
|
|
exits on receiving a terminate message,
|
|
(no response to one that is sent to the kernel),
|
|
or when an error occurs reading from or writing to the socket.
|
|
.Pp
|
|
The
|
|
.Fl d
|
|
flag increases the log level to
|
|
.Ar lvl .
|
|
At level 0 only start and stop messages are logged.
|
|
The
|
|
.Fl D
|
|
flag causes
|
|
.Nm
|
|
to remain in the foreground and to write log output to stdout.
|
|
.Pp
|
|
It is envisaged that user-level communication take place with
|
|
.Nm
|
|
using the
|
|
.Xr iscsictl 8
|
|
utility, rather than directly over its communication socket.
|
|
An example of setting up the in-kernel iSCSI initiator
|
|
is shown in
|
|
.Xr iscsictl 8 .
|
|
.Pp
|
|
.Nm
|
|
requires
|
|
.Xr scsibus 4
|
|
and
|
|
.Xr sd 4
|
|
compiled in the kernel to load the iscsi kernel module.
|
|
.Sh SEE ALSO
|
|
.Xr daemon 3 ,
|
|
.Xr isns 3 ,
|
|
.Xr iscsictl 8
|
|
.Sh HISTORY
|
|
The
|
|
.Nm
|
|
utility appeared in
|
|
.Nx 6.0 .
|
|
.Sh AUTHORS
|
|
.An Alistair Crooks Aq Mt agc@NetBSD.org
|
|
wrote this manual page.
|
|
The
|
|
.Nm
|
|
utility was contributed by Wasabi Systems, Inc.
|