Добавление документации на русском языке, добавление системных директорий для конфигураций по умолчанию
All checks were successful
Build / Build project (push) Successful in 52s

This commit is contained in:
Alexander Zhirov 2025-05-08 02:36:34 +03:00
parent 7b0903d294
commit 40c3a0c815
Signed by: alexander
GPG key ID: C8D8BE544A27C511
13 changed files with 1164 additions and 4 deletions

View file

@ -0,0 +1 @@
InitiatorName=iqn.2025-05.local.open-iscsi:solus

View file

@ -0,0 +1,52 @@
.TH ISCSI_GEN_INITIATORNAME 8 "АПР 2022" "" "Руководство администратора Linux"
.SH НАЗВАНИЕ
iscsi-gen-initiatorname \- инструмент для умной генерации имени инициатора iSCSI
.SH СИНТАКСИС
.BI iscsi-gen-initiatorname
[ОПЦИИ]
.SH ОПИСАНИЕ
.B iscsi-gen-initiatorname
генерирует имя инициатора iSCSI в файле
.I initiatorname.iscsi\fR.
Попытка перезаписи существующего имени инициатора является ошибкой,
если не указана опция \fB-f\fP (\fIforce\fR).
.P
Имя инициатора будет взято из командной строки ядра,
если оно присутствует (из параметра \fIrd.initiatorname\fR), либо из
подсистемы iBFT (если она присутствует в \fIsysfs\fR), либо будет
сгенерировано с использованием команды \fBiscsi-iname\fR.
.P
Ошибка возникает, если имя инициатора из командной строки ядра
и имя инициатора iBFT оба установлены и различаются.
Также ошибка возникает при попытке перезаписи файла имени инициатора,
если он доступен только для чтения, или при создании файла,
если его каталог недоступен для записи.
.P
Для выполнения этой команды
.B необходимо
быть
.I root
.
.SH ОПЦИИ
.TP
.BI [-h]
Вывести справочное сообщение и выйти.
.TP
.BI [-f]
Принудительно перезаписать существующее имя инициатора, если оно присутствует.
.TP
.BI [-p] \fIПРЕФИКС-IQN\fP
Использовать \fIПРЕФИКС-IQN\fP в качестве префикса для сгенерированного IQN,
вместо значения по умолчанию \fBiqn.2025-05.local.open-iscsi:solus\fP.
.SH ФАЙЛЫ
.TP
/usr/share/defaults/etc/iscsi/initiatorname.iscsi или /etc/iscsi/initiatorname.iscsi
Файл, содержащий имя инициатора. Не редактируйте вручную.
.SH "СМ. ТАКЖЕ"
.BR iscsi-iname (8)
.SH АВТОРЫ
Проект Open-iSCSI <http://www.open-iscsi.com/>
.br
Hannes Reinecke <hare@suse.de>
.br
Lee Duncan <lduncan@suse.com>

View file

@ -0,0 +1,22 @@
.TH ISCSI_INAME 8 "Янв 2010" "" "Руководство администратора Linux"
.SH НАЗВАНИЕ
iscsi-iname \- инструмент для генерации имени инициатора iSCSI
.SH СИНТАКСИС
.BI iscsi-iname
[ОПЦИЯ]
.SH ОПИСАНИЕ
.B iscsi-iname
генерирует уникальное имя узла iSCSI при каждом вызове.
.SH ОПЦИИ
.TP
.BI [-h|--help]
Вывести справку
.TP
.BI [-p=]\fIпрефикс\fP
Использовать переданный префикс вместо значения по умолчанию "iqn.2025-05.local.open-iscsi:solus"
.SH АВТОРЫ
Проект Open-iSCSI <http://www.open-iscsi.com/>
.br
Mike Christie <mchristi@redhat.com>

View file

@ -0,0 +1,50 @@
.TH "iscsi_discovery" 8 "" "" "Руководство системного администратора"
.SH НАЗВАНИЕ
iscsi_discovery \- обнаружение целей iSCSI
.SH СИНТАКСИС
.B iscsi_discovery
.I <IP>
.RB [ -p
.IR <порт> ]
.RB [ -d ]
.RB [\ -t
.IR <tcp|iser>
.RB [ -f ]
]
.RB [ -m ]
.RB [ -l ]
.SH ОПИСАНИЕ
Выполняет обнаружение целей методом send-targets по указанному IP. Если создается запись обнаружения, пытается выполнить вход на портал с использованием предпочтительного транспорта (флаг \-t указывает запрошенный тип транспорта, по умолчанию TCP). Если вход с использованием определенного транспорта успешен, помечает портал для автоматического входа (если не используется флаг \-m) и отключается (если не используется флаг \-l).
Для работы обнаружения iSCSI должны быть запущены службы open-iscsi, т.е. iscsid должен быть активен, а модули iSCSI загружены. Это лучше всего выполняется с помощью скрипта запуска init.d.
.\" .SH ПАРАМЕТРЫ
.TP
.BI [-p=]\fIномер-порта\fP
устанавливает номер порта (по умолчанию 3260).
.TP
.BI [-d]
выводит отладочную информацию.
.TP
.BI [-t=]\fIтип-транспорта\fP
устанавливает транспорт (по умолчанию tcp).
.TP
.BI [-f]
принудительно задает конкретный транспорт -
отключает резервное использование tcp (по умолчанию резервное использование включено),
задает транспорт, указанный в аргументе флага \-t.
.TP
.BI [-m]
ручной запуск - устанавливает ручной запуск (по умолчанию автоматический запуск).
.TP
.BI [-l]
вход - выполняет вход на вновь обнаруженные узлы (по умолчанию false).
.SH АВТОР
Написано Dan Bar Dov
.SH "СООБЩЕНИЕ ОБ ОШИБКАХ"
Сообщайте об ошибках на <erezzi.list@gmail.com>.
.SH АВТОРСКОЕ ПРАВО
Copyright \(co Voltaire Ltd. 2006.

View file

@ -0,0 +1,16 @@
.TH "iscsi_fw_login" 8 "" "" "Руководство системного администратора"
.SH НАЗВАНИЕ
iscsi_fw_login \- Вход во все цели прошивки iSCSI
.SH СИНТАКСИС
.B iscsi_fw_login
.SH ОПИСАНИЕ
Эта вспомогательная функция выполняет вход во все известные цели прошивки iSCSI.
.P
Она предназначена как вспомогательная функция для вызова udev, когда новые
цели прошивки обнаруживаются асинхронно.
.SH АВТОР
Написано Lee Duncan
.SH "СООБЩЕНИЕ ОБ ОШИБКАХ"
Сообщайте об ошибках на <lduncan@suse.com>.
.SH АВТОРСКОЕ ПРАВО
Copyright \(co 2015 Lee Duncan <lduncan@suse.com>

599
files/man/ru/iscsiadm.8 Normal file
View file

@ -0,0 +1,599 @@
.TH ISCSIADM 8 "Март 2022" "" "Руководство администратора Linux"
.SH НАЗВАНИЕ
iscsiadm \- утилита администрирования open-iscsi
.SH СИНТАКСИС
.B iscsiadm
.B \-m discoverydb
.RB [ \-hV ]
.RB [ \-d
.IR debug_level ]
.RB [ \-P
.IR printlevel ]
.RB [ \-I
.I iface
.BI \-t\ type\ \-p\ ip:port
.RB [ \-lD ]
] | [
.RB [ \-p
.I ip:port
.B \-t
.IR type ]
.RB [ \-o
.IR operation ]
.RB [ \-n
.IR name ]
.RB [ \-v
.IR value ]
.RB [ \-lD ]
]
.PP
.B iscsiadm
.B \-m discovery
.RB [ \-hV ]
.RB [ \-d
.IR debug_level ]
.RB [ \-P
.IR printlevel ]
.RB [ \-I
.IR iface ]
.RB [ \-t
.IR type ]
.RB [ \-p
.IR ip:port ]
.RB [ \-l ]
.PP
.B iscsiadm
.B \-m node
.RB [ \-hV ]
.RB [ \-d
.IR debug_level ]
.RB [ \-P
.IR printlevel ]
.RB [ \-L
.IR all,manual,automatic,onboot ]
.RB [ \-W ]
.RB [ \-U
.IR all,manual,automatic,onboot ]
.RB [ \-S ]
[
.RB [ \-T
.IB targetname\ \-p\ ip:port\ \-I
.IR iface ]
.RB [ \-l | \-u | \-R | \-s ]
]
[
.RB [ \-o
.IR operation ]
.RB [ \-n
.IR name ]
.RB [ \-v
.IR value ]
.RB [ \-p
.IR ip:port ]
]
.PP
.B iscsiadm
.B \-m session
.RB [ \-hV ]
.RB [ \-d
.IR debug_level ]
.RB [ \-P
.IR printlevel ]
.RB [ \-r
.IR sessionid | sysfsdir
.RB [ \-R ]
.RB [ \-u | \-s | \-o
.IR new ]
]
.PP
.B iscsiadm
.B \-m iface
.RB [ \-hV ]
.RB [ \-d
.IR debug_level ]
.RB [ \-P
.IR printlevel ]
.RB [ \-I
.IR ifacename\ |
.B \-H
.IR hostno|MAC ]
[
.RB [ \-o
.IR operation ]
.RB [ \-n
.IR name ]
.RB [ \-v
.IR value ]
]
[
.BI \-C\ ping
.RB [ \-a
.IR ip ]
.RB [ \-b
.IR packetsize ]
.RB [ \-c
.IR count ]
.RB [ \-i
.IR interval ]
]
.PP
.B iscsiadm
.B \-m fw
.RB [ \-d
.IR debug_level ]
.RB [ \-l ]
.RB [ \-W ]
.RB [ \-n
.IR name ]
.RB [ \-v
.IR value ]
.PP
.B iscsiadm
.B \-m host
.RB [ \-P
.IR printlevel ]
.RB [ \-H
.IR hostno|MAC ]
[
.RB [ \-C
.I chap
.RB [ \-x
.IR chap_tbl_idx ]
] |
.RB [ \-C
.I flashnode
.RB [ \-A
.IR portal_type ]
.RB [ \-x
.IR flashnode_idx ]
] |
.RB [ \-C
.IR stats ]
]
[
.RB [ \-o
.IR operation ]
.RB [ \-n
.IR name ]
.RB [ \-v
.IR value ]
]
.PP
.B iscsiadm
.B \-k priority
.SH ОПИСАНИЕ
Утилита iscsiadm — это инструмент командной строки, позволяющий выполнять обнаружение и вход в цели iSCSI, а также доступ и управление базой данных open-iscsi.
.PP
Open-iscsi не использует термин \fInode\fR в значении, определённом в RFC iSCSI, где узел — это отдельный инициатор или цель iSCSI. Open-iscsi использует термин \fInode\fR для обозначения портала на цели.
.PP
В режиме \fIsession\fR используется идентификатор сессии (\fIsid\fR). Идентификатор сессии можно найти, выполнив \fIiscsiadm \-m session \-P 1\fR. Идентификатор сессии и путь sysfs не являются постоянными и частично зависят от времени настройки сессии.
.SH ЗАМЕЧАНИЯ
.PP
Многие операции с узлами и обнаружением требуют, чтобы демон iSCSI (iscsid) был запущен. Если система использует systemd, демон может автоматически запускаться, если он включён, при необходимости.
.PP
Open-iscsi использует две группы файлов для хранения или доступа во время работы: \fBHOMEDIR\fR и \fBDBROOT\fR. Описание этих групп:
.TP
.B Домашняя директория
\fIДомашняя директория\fR для open-iscsi — это /usr/share/defaults/etc/iscsi или /etc/iscsi. Здесь хранятся файлы конфигурации (\fIiscsid.conf\fR) и имя инициатора (\fIinitiatorname.iscsi\fR).
.TP
.B Корневая директория базы данных
\fIКорневая директория базы данных\fR для open-iscsi — это /var/lib/iscsi. Здесь хранятся плоские файлы базы данных, такие как список \fInode\fR (см. ниже).
.SH ОПЦИИ
.TP
\fB\-a\fR, \fB\-\-ip=\fIipaddr\fP
\fIipaddr\fR может быть IPv4 или IPv6.
.IP
Эта опция действительна только для подрежима \fIping\fR.
.TP
\fB\-A\fR, \fB\-\-portal_type=\fI[ipv4|ipv6]\fR
Указывает тип портала для создания новой записи flash node.
.IP
Эта опция действительна только для подрежима \fIflashnode\fR режима \fIhost\fR и только с операцией \fInew\fR.
.TP
\fB\-b\fR, \fB\-\-packetsize=\fIpacketsize\fP
Указывает размер пакета для ping \fIpacketsize\fR.
.IP
Эта опция действительна только для подрежима \fIping\fR.
.TP
\fB\-c\fR, \fB\-\-count=\fIcount\fP
\fIcount\fR указывает количество итераций ping.
.IP
Эта опция действительна только для подрежима \fIping\fR.
.TP
\fB\-C\fR, \fB\-\-submode=\fIop\fP
Указывает подрежим для режима. \fIop\fR должен быть названием подрежима.
.IP
В настоящее время iscsiadm поддерживает \fIping\fR как подрежим для \fIiface\fR. Например:
.IP
iscsiadm \-m iface \-I ifacename \-C ping \-a ipaddr \-b packetsize \-c count \-i interval
.IP
Для \fIhost\fR поддерживаются подрежимы \fIchap\fR, \fIflashnode\fR и \fIstats\fR. Например:
.IP
iscsiadm \-m host \-H hostno \-C chap \-x chap_tbl_idx \-o operation
.IP
iscsiadm \-m host \-H hostno \-C flashnode \-x flashnode_idx \-o operation
.IP
iscsiadm \-m host \-H hostno \-C stats
.TP
\fB\-d\fR, \fB\-\-debug=\fIdebug_level\fP
Выводит отладочную информацию. Допустимые значения для \fIdebug_level\fR — от 0 до 8.
.TP
\fB\-h\fR, \fB\-\-help\fR
Выводит справочный текст и завершает работу.
.TP
\fB\-H\fR, \fB\-\-host=\fI[hostno|MAC]\fR
Аргумент \fIhost\fR указывает хост SCSI для выполнения операции. Это может быть номер хоста SCSI, назначенный ядром, или MAC-адрес хоста SCSI.
.TP
\fB\-i\fR, \fB\-\-interval=\fIinterval\fP
\fIinterval\fP указывает задержку между итерациями ping.
.IP
Эта опция действительна только для подрежима \fIping\fR.
.TP
\fB\-I\fR, \fB\-\-interface=\fI[iface]\fR
Аргумент \fIinterface\fR указывает интерфейс iSCSI для выполнения операции.
Интерфейсы iSCSI (\fIiface\fR) определены в /var/lib/iscsi/ifaces. Для аппаратного iSCSI (например, qla4xxx) конфигурация \fIiface\fR должна содержать аппаратный адрес (\fIiface.hwaddress\fR = MAC-адрес порта) и имя драйвера/транспорта (\fIiface.transport_name\fR). Имя \fIiface\fR — это имя файла конфигурации интерфейса. Для программного iSCSI конфигурация \fIiface\fR должна содержать либо аппаратный адрес (\fIiface.hwaddress\fR), либо имя сетевого интерфейса (\fIiface.net_ifacename\fR), а также имя драйвера/транспорта.
.IP
Доступные драйверы/транспорты iSCSI: \fItcp\fR (программный iSCSI через TCP/IP), \fIiser\fR (программный iSCSI через InfiniBand), \fIqla4xxx\fR (Qlogic 4XXXX и 82XXX HBA), \fIcxgb3i\fR и \fIcxgb4i\fR (адаптеры Chelsio T3 и T4), \fIbnx2i\fR (адаптеры QLogic Netextreme II), \fIbe2iscsi\fR (адаптер Emulex 10G), \fIqedi\fR (адаптер QLogic QEDI 25/40/100Gb) и \fIocs\fR (Emulex One Connect storage).
Некоторые из них считаются экспериментальными, так как не полностью протестированы.
.IP
\fIhwaddress\fR — это MAC-адрес или, для программного iSCSI, специальное значение \fIdefault\fR, которое указывает инициатору не привязывать сессию к конкретному аппаратному ресурсу, позволяя сетевому уровню или InfiniBand самостоятельно принимать решение. Нет необходимости создавать конфигурацию \fIiface\fR с поведением по умолчанию. Если \fIiface\fR не указан, используется поведение по умолчанию.
.IP
Как упомянуто выше, существует специальное имя \fIiface\fR\fIdefault\fR. Также есть другие, которые не привязывают сессию к конкретной карте, а привязывают её к транспорту: \fIiser\fR, \fIcxgb3i\fR, \fIcxgb4i\fR и \fIbnx2i\fR.
.IP
В режиме \fIdiscovery\fR можно указать несколько интерфейсов, передавая несколько экземпляров \fI\-I/\-\-interface\fR. Например:
.IP
\fBsh#\fR iscsiadm \-m discoverydb \-t st \-p ip:port \-I iface0 \-I iface2 \-\-discover
.IP
Это укажет iscsiadm настроить базу данных узлов для создания записей, которые будут создавать сессии через два переданных интерфейса.
.IP
В режиме \fInode\fR в каждом вызове iscsiadm поддерживается только один интерфейс.
.IP
Эта опция действительна для режимов \fIdiscovery\fR, \fInode\fR и \fIiface\fR.
.TP
\fB\-k\fR, \fB\-\-killiscsid=\fI[priority]\fR
В настоящее время \fIpriority\fR должен быть равен нулю. Это немедленно останавливает все операции iscsid и завершает его работу. Сессии не завершаются. Выполнение этой команды эквивалентно \fIkillall iscsid\fR. Ни то, ни другое обычно не следует использовать, так как если iscsid выполняет восстановление после ошибки или происходит ошибка, пока iscsid не работает, система может не восстановиться. Эта команда и обработка SIGTERM в iscsid являются экспериментальными.
.TP
\fB\-D\fR, \fB\-\-discover\fR
Обнаруживает цели, используя запись обнаружения с \fIrecid\fR, соответствующую типу обнаружения и переданному порталу. Если соответствующей записи нет, она будет создана с использованием настроек обнаружения iscsid.conf.
Эта опция должна быть передана в режиме \fIdiscoverydb\fR, чтобы указать iscsiadm выполнить обнаружение.
.IP
Эта опция действительна только для режима обнаружения \fISendTargets\fR.
.TP
\fB\-l\fR, \fB\-\-login\fR
В режимах \fInode\fR и \fIfw\fR выполняет вход в указанную запись. В режиме \fIdiscovery\fR выполняет вход во все обнаруженные цели.
.IP
Эта опция действительна только для режимов \fIdiscovery\fR, \fInode\fR и \fIfw\fR. Для режима \fIfw\fR можно дополнительно передать пары \fIname\fR и \fIvalue\fR, которые будут использоваться для созданных сессий. В этом случае \fIop\fR не требуется, так как предполагается \fIupdate\fR.
.TP
\fB\-L\fR, \fB\-\-loginall=\fI[all|manual|automatic|onboot]\fR
В режиме \fInode\fR выполняет вход во все сессии с указанными значениями запуска узла или соединения, или во все активные сессии, кроме помеченных как \fIonboot\fR, если передано \fIall\fR.
.IP
Эта опция действительна только для режима \fInode\fR (она допустима, но не функциональна для режима \fIsession\fR).
.TP
\fB\-W\fR, \fB\-\-\-no_wait\fR
В режимах \fInode\fR, \fIdiscovery\fR или \fIfw\fR (прошивка) не ожидает ответа от цели(ей).
Это означает, что успех будет возвращён, если команде удалось отправить запросы на вход, независимо от их успешности. В этом случае вызывающей стороне придётся опрашивать результат (например, создание сессии).
.TP
\fB\-m\fR, \fB\-\-mode \fIop\fR
Указывает режим. \fIop\fR должен быть одним из: \fIdiscovery\fR, \fIdiscoverydb\fR, \fInode\fR, \fIfw\fR, \fIhost\fR, \fIiface\fR или \fIsession\fR.
.IP
Если другие опции не указаны: в режимах \fIdiscovery\fR, \fIdiscoverydb\fR и \fInode\fR отображаются все соответствующие записи; в режиме \fIsession\fR отображаются все активные сессии и соединения; в режиме \fIfw\fR отображаются все значения прошивки для загрузки; в режиме \fIhost\fR отображаются все хосты iSCSI; в режиме \fIiface\fR отображаются все интерфейсы, настроенные в /var/lib/iscsi/ifaces.
.TP
\fB\-n\fR, \fB\-\-name=\fIname\fR
В режиме \fInode\fR указывает поле \fIname\fR в записи. В подрежиме \fIflashnode\fR режима \fIhost\fR указывает имя параметра flash node.
.IP
Используется с оператором \fIupdate\fR.
.TP
\fB\-o\fR, \fB\-\-op=\fIop\fR
Указывает оператор базы данных \fIop\fR. \fIop\fR должен быть одним из: \fInew\fR, \fIdelete\fR, \fIupdate\fR, \fIshow\fR или \fInonpersistent\fR.
.IP
Для режима \fIiface\fR также применимы \fIapply\fR и \fIapplyall\fR.
.IP
Для подрежима \fIflashnode\fR режима \fIhost\fR также применимы \fIlogin\fR и \fIlogout\fR.
.IP
Эта опция действительна для всех режимов, кроме \fIfw\fR. Операцию \fIdelete\fR не следует использовать для активной сессии. Если это сделано, iscsiadm завершит сессию и затем удалит запись.
.IP
Операция \fInew\fR создаёт новую запись базы данных для указанного объекта. В режиме \fInode\fR \fIrecid\fR — это имя цели и портал (IP:port). В режиме \fIiface\fR \fIrecid\fR — это имя интерфейса. В режиме \fIdiscovery\fR \fIrecid\fR — это портал и тип обнаружения.
.IP
В режиме \fIsession\fR операция \fInew\fR выполняет вход в новую сессию, используя ту же базу данных узлов и информацию об интерфейсе, что и для указанной сессии.
.IP
В режиме \fIdiscovery\fR, если переданы \fIrecid\fR и операция \fInew\fR, но аргумент \fI\-\-discover\fR не передан, iscsiadm создаст только запись обнаружения (обнаружение не будет выполнено). Если аргумент \fI\-\-discover\fR передан с порталом и типом обнаружения, iscsiadm создаст запись обнаружения, если она необходима, и создаст записи для порталов, возвращённых целью, для которых ещё нет записи в базе данных узлов.
.IP
Установка \fIop\fR в \fIdelete\fR удаляет указанный \fIrecid\fR. В режиме \fIdiscovery\fR, если iscsiadm выполняет обнаружение, он удалит записи для порталов, которые больше не возвращаются.
.IP
Установка \fIop\fR в \fIupdate\fR обновляет \fIrecid\fR с \fIname\fR до указанного \fIvalue\fR. В режиме \fIdiscovery\fR, если iscsiadm выполняет обнаружение, аргументы \fIrecid\fR, \fIname\fR и \fIvalue\fR не нужны. Операция \fIupdate\fR будет работать с порталами, возвращёнными целью, и обновит записи узлов информацией из файла конфигурации и командной строки.
.IP
Значение \fIop\fR \fIshow\fR является поведением по умолчанию для режимов \fInode\fR, \fIdiscovery\fR и \fIiface\fR. Оно также используется, когда в режиме \fIsession\fR не передаются команды, но передан активный \fIsid\fR.
Если переданы \fIname\fR и \fIvalue\fR, они игнорируются в режиме \fIshow\fR.
.IP
Значение \fIop\fR \fInonpersistent\fR указывает iscsiadm не изменять базу данных узлов.
.IP
Значение \fIop\fR \fIapply\fR применяет сетевые настройки к указанному интерфейсу.
.IP
Значение \fIop\fR \fIapplyall\fR применяет сетевые настройки ко всем интерфейсам, чей MAC-адрес или номер хоста совпадает с указанным хостом.
.IP
Значение \fIop\fR \fIlogin\fR выполняет вход в указанную запись flash node.
.IP
Значение \fIop\fR \fIlogout\fR выполняет выход из указанной записи flash node.
.TP
\fB\-p\fR, \fB\-\-portal=\fIip[:port]\fR
Использует портал цели с IP-адресом \fIip\fR и портом \fIport\fR. Если \fIport\fR не передан, используется значение по умолчанию 3260.
.IP
IPv6-адреса можно указать как \fI[ddd.ddd.ddd.ddd]:port\fI или \fIddd.ddd.ddd.ddd\fR.
.IP
Также можно использовать имена хостов для аргумента \fIip\fI.
.IP
Эта опция действительна только для режима \fIdiscovery\fR или для операций \fInode\fR с оператором \fInew\fR.
.IP
Следует использовать вместе с \fI\-\-target\fR в режиме \fInode\fR, чтобы указать, что в документации open-iscsi называется узлом или записью узла. Примечание: использование термина "узел" в open-iscsi не соответствует термину iSCSI Node из RFC iSCSI.
.TP
\fB\-P\fR, \fB\-\-print=\fIprintlevel\fR
В режиме \fInode\fR отображает узлы в древовидном формате. В режиме \fIsession\fR отображает сессии в древовидном формате. В режиме \fIdiscovery\fR отображает узлы в древовидном формате.
.TP
\fB\-T\fR, \fB\-\-targetname=\fItargetname\fR
Использует цель \fItargetname\fR.
.IP
Следует использовать вместе с \fI\-\-portal\fR в режиме \fInode\fR, чтобы указать, что в документации open-iscsi называется узлом или записью узла. Примечание: использование термина "узел" в open-iscsi не соответствует термину iSCSI Node из RFC iSCSI.
.TP
\fB\-r\fR, \fB\-\-sid=\fIsid | sysfsdir\fR
Использует идентификатор сессии \fIsid\fR. Идентификатор сессии можно узнать, выполнив iscsiadm в режиме \fIsession\fR.
.IP
Вместо идентификатора сессии можно использовать путь sysfs, содержащий сессию.
Например, использование одного из следующих путей:
/sys/devices/platform/hostH/sessionS/targetH:B:I/H:B:I:L,
/sys/devices/platform/hostH/sessionS/targetH:B:I или
/sys/devices/platform/hostH/sessionS для аргумента \fIsysfsdir\fR приведёт к использованию сессии с идентификатором \fIS\fR.
.IP
\fIsid | sysfsdir\fR требуется только для режима \fIsession\fR.
.TP
\fB\-R\fR, \fB\-\-rescan\fR
В режиме \fIsession\fR, если также передан \fIsid\fR, выполняет повторное сканирование сессии.
Если \fIsid\fR не передан, выполняет повторное сканирование всех активных сессий.
.IP
В режиме \fInode\fR выполняет повторное сканирование сессии, работающей через переданную комбинацию цель, портал, интерфейс.
.TP
\fB\-s\fR, \fB\-\-stats\fR
Отображает статистику сессии.
Эта опция, используемая в режиме \fIhost\fR, отображает статистику хоста.
.TP
\fB\-S\fR, \fB\-\-show\fR
При отображении записей не скрывает замаскированные значения, такие как секрет CHAP (пароль).
.IP
Эта опция действительна только для режимов \fInode\fR и \fIsession\fR.
.TP
\fB\-t\fR, \fB\-\-type=\fItype\fR
\fItype\fR должен быть \fIsendtargets\fR (или сокращённо \fIst\fR), \fIisns\fR (если включено) или \fIfw\fR. См. раздел \fBТИПЫ ОБНАРУЖЕНИЯ\fR.
.IP
Эта опция действительна только для режима \fIdiscovery\fR.
.TP
\fB\-u\fR, \fB\-\-logout\fR
Выполняет выход для указанной записи.
.IP
Эта опция действительна только для режимов \fInode\fR и \fIsession\fR.
.TP
\fB\-U\fR, \fB\-\-logoutall=\fI[all,manual,automatic|onboot]\fR
Выполняет выход из всех сессий с указанными значениями запуска узла или соединения или из всех активных сессий, кроме помеченных как \fIonboot\fR, если передано \fIall\fR.
.IP
Эта опция действительна только для режима \fInode\fR (она допустима, но не функциональна для режима \fIsession\fR).
.TP
\fB\-v\fR, \fB\-\-value=\fIvalue\fR
Указывает \fIvalue\fR для использования с оператором \fIupdate\fR или для режима входа в прошивку.
.IP
Эта опция действительна только для режима \fInode\fR и подрежима \fIflashnode\fR режима \fIhost\fR.
.TP
\fB\-V\fR, \fB\-\-version\fR
Отображает версию и завершает работу.
.TP
\fB\-x\fR, \fB\-\-index=\fIindex\fR
Указывает \fIindex\fR сущности для выполнения операции.
.IP
Эта опция действительна только для подрежимов \fIchap\fR и \fIflashnode\fR режима \fIhost\fR.
.SH ТИПЫ ОБНАРУЖЕНИЯ
iSCSI определяет 3 типа обнаружения: \fISendTargets\fR, \fISLP\fR и \fIiSNS\fR.
\fISLP\fR не имеет широкой поддержки и не поддерживается этим пакетом.
Поддержка \fIiSNS\fR зависит от опций сборки, но по умолчанию включена.
.PP
Также поддерживается специальный тип обнаружения, называемый
.I fw
(для прошивки), для обнаружения интерфейсов прошивки и заполнения базы данных интерфейсов в процессе.
.TP
.B
SendTargets
Нативный протокол iSCSI, который позволяет каждой цели iSCSI отправлять инициатору список доступных целей.
.TP
.B
iSNS
iSNS (Internet Storage Name Service) записывает информацию о томах хранения в более крупной сети. Для использования iSNS передайте адрес и, при необходимости, порт сервера iSNS для выполнения обнаружения.
.TP
.B
fw
Режим прошивки.
Некоторые сетевые карты и системы содержат мини-инициатор iSCSI, который можно использовать для загрузки. Чтобы получить значения, используемые для загрузки, можно использовать опцию \fIfw\fR.
Обнаружение \fIfw\fR не сохраняет постоянные записи в базе данных узлов или обнаружения, поскольку значения хранятся в ресурсах системы или сетевой карты.
.IP
Выполнение обнаружения \fIfw\fR выводит порталы, как и в других методах обнаружения. Чтобы увидеть другие настройки, такие как значения CHAP и настройки инициатора, как в режиме \fInode\fR, выполните \fIiscsiadm \-m fw\fR.
.SH КОДЫ ВОЗВРАТА
При успешном выполнении возвращается 0. В случае ошибки возвращается один из кодов ниже.
.PP
Для команд, работающих с несколькими объектами (сессиями, записями и т.д.), iscsiadm/iscsistart вернёт первую встреченную ошибку.
iscsiadm/iscsistart попытается выполнить операцию над объектами, которые доступны. Если объекты не найдены, возвращается ISCSI_ERR_NO_OBJS_FOUND.
.TP
.B
0
ISCSI_SUCCESS — команда выполнена успешно.
.TP
.B
1
ISCSI_ERR — общий код ошибки.
.TP
.B
2
ISCSI_ERR_SESS_NOT_FOUND — сессия не найдена.
.TP
.B
3
ISCSI_ERR_NOMEM — не удалось выделить ресурсы для операции.
.TP
.B
4
ISCSI_ERR_TRANS — проблемы с соединением привели к сбою операции.
.TP
.B
5
ISCSI_ERR_LOGIN — общий сбой входа iSCSI.
.TP
.B
6
ISCSI_ERR_IDBM — ошибка доступа/управления базой данных iSCSI.
.TP
.B
7
ISCSI_ERR_INVAL — неверный аргумент.
.TP
.B
8
ISCSI_ERR_TRANS_TIMEOUT — истёк таймер соединения при попытке подключения.
.TP
.B
9
ISCSI_ERR_INTERNAL — общий внутренний сбой iscsid/ядра.
.TP
.B
10
ISCSI_ERR_LOGOUT — сбой выхода iSCSI.
.TP
.B
11
ISCSI_ERR_PDU_TIMEOUT — тайм-аут PDU iSCSI.
.TP
.B
12
ISCSI_ERR_TRANS_NOT_FOUND — модуль транспорта iSCSI не загружен в ядро или iscsid.
.TP
.B
13
ISCSI_ERR_ACCESS — отсутствуют необходимые разрешения ОС для доступа к iscsid или выполнения команды iscsiadm.
.TP
.B
14
ISCSI_ERR_TRANS_CAPS — модуль транспорта не поддерживает операцию.
.TP
.B
15
ISCSI_ERR_SESS_EXISTS — сессия уже вошла.
.TP
.B
16
ISCSI_ERR_INVALID_MGMT_REQ — неверный запрос IPC MGMT.
.TP
.B
17
ISCSI_ERR_ISNS_UNAVAILABLE — служба iSNS не поддерживается.
.TP
.B
18
ISCSI_ERR_ISCSID_COMM_ERR — сбой чтения/записи в iscsid.
.TP
.B
19
ISCSI_ERR_FATAL_LOGIN — фатальная ошибка входа iSCSI.
.TP
.B
20
ISCSI_ERR_ISCSID_NOTCONN — не удалось подключиться к iscsid.
.TP
.B
21
ISCSI_ERR_NO_OBJS_FOUND — не найдены записи/цели/сессии/порталы для выполнения операции.
.TP
.B
22
ISCSI_ERR_SYSFS_LOOKUP — не удалось найти объект в sysfs.
.TP
.B
23
ISCSI_ERR_HOST_NOT_FOUND — не удалось найти хост.
.TP
.B
24
ISCSI_ERR_LOGIN_AUTH_FAILED — вход не удался из-за ошибки авторизации.
.TP
.B
25
ISCSI_ERR_ISNS_QUERY — сбой запроса iSNS.
.TP
.B
26
ISCSI_ERR_ISNS_REG_FAILED — сбой регистрации/дерегистрации iSNS.
.TP
.B
27
ISCSI_ERR_OP_NOT_SUPP — операция не поддерживается.
.TP
.B
28
ISCSI_ERR_BUSY — устройство или ресурс занят.
.TP
.B
29
ISCSI_ERR_AGAIN — операция не удалась, но повторная попытка позже может быть успешной.
.TP
.B
30
ISCSI_ERR_UNKNOWN_DISCOVERY_TYPE — неизвестный тип обнаружения.
.TP
.B
31
ISCSI_ERR_CHILD_TERMINATED — дочерний процесс завершён.
.TP
.B
32
ISCSI_ERR_SESSION_NOT_CONNECTED — сессия, вероятно, не подключена.
.SH ПРИМЕРЫ
Обнаружение целей по заданному IP-адресу:
.IP
\fBsh#\fR iscsiadm \-\-mode discoverydb \-\-type sendtargets \-\-portal 192.168.1.10 \-\-discover
.PP
Вход, необходимо использовать идентификатор записи узла, найденный при обнаружении:
.IP
\fBsh#\fR iscsiadm \-\-mode node \-\-targetname iqn.2001-05.com.doe:test \-\-portal 192.168.1.1:3260 \-\-login
.PP
Выход:
.IP
\fBsh#\fR iscsiadm \-\-mode node \-\-targetname iqn.2001-05.com.doe:test \-\-portal 192.168.1.1:3260 \-\-logout
.PP
Список записей узлов:
.IP
\fBsh#\fR iscsiadm \-\-mode node
.PP
Отображение всех данных для заданной записи узла:
.IP
\fBsh#\fR iscsiadm \-\-mode node \-\-targetname iqn.2001-05.com.doe:test \-\-portal 192.168.1.1:3260
.PP
Список всех сессий:
.IP
\fBsh#\fR iscsiadm \-\-mode session
.PP
Список всех сессий в древовидном формате:
.IP
\fBsh#\fR iscsiadm \-\-mode session \-\-print
.SH ФАЙЛЫ
.TP
/usr/share/defaults/etc/iscsi/iscsid.conf или /etc/iscsi/iscsid.conf
Файл конфигурации, читаемый \fBiscsid\fR и \fBiscsiadm\fR при запуске.
.TP
/usr/share/defaults/etc/iscsi/initiatorname.iscsi или /etc/iscsi/initiatorname.iscsi
Файл, содержащий InitiatorName и InitiatorAlias iSCSI, читаемый \fBiscsid\fR и \fBiscsiadm\fR при запуске.
.TP
/var/lib/iscsi/nodes/
Эта директория содержит узлы с их целями.
.TP
/var/lib/iscsi/send_targets
Эта директория содержит порталы.
.SH "СМ. ТАКЖЕ"
.BR iscsid (8)
.SH АВТОРЫ
Проект Open-iSCSI <http://www.open-iscsi.com/>
.br
Alex Aizman <itn780@yahoo.com>
.br
Dmitry Yusupov <dmitry_yus@yahoo.com>

83
files/man/ru/iscsid.8 Normal file
View file

@ -0,0 +1,83 @@
.TH ISCSID 8 "Июль 2005" "" "Руководство администратора Linux"
.SH НАЗВАНИЕ
iscsid \- Демон Open-iSCSI
.SH СИНТАКСИС
.BI iscsid
[ОПЦИЯ]
.SH ОПИСАНИЕ
.B iscsid
реализует управляющий путь протокола iSCSI, а также некоторые функции управления.
Например, демон может быть настроен на автоматический перезапуск обнаружения при запуске
на основе содержимого постоянной базы данных iSCSI.
.SH ОПЦИИ
.TP
.BI [-c|--config=]\fIфайл-конфигурации\fP
Читает конфигурацию из \fIфайл-конфигурации\fR вместо файла по умолчанию
\fI/usr/share/defaults/etc/iscsi/iscsid.conf
или
\fI/etc/iscsi/iscsid.conf\fR.
.TP
.BI [-i|--initiatorname=]\fIфайл-имени-инициатора\fP
Читает имя инициатора из \fIфайл-имени-инициатора\fR вместо файла по умолчанию
\fI/usr/share/defaults/etc/iscsi/initiatorname.iscsi
или
\fI/etc/iscsi/initiatorname.iscsi\fR.
.TP
.BI [-f|--foreground]
Запускает
.B iscsid
в фоновом режиме. Подразумевает
.BR --no-pid-file .
.TP
.BI [-d|--debug=] уровень_отладки
Выводит отладочную информацию. Допустимые значения для \fIуровень_отладки\fR — от 0 до 8.
.TP
.BI [-u|--uid=] uid
Запускается под идентификатором пользователя \fIuid\fR (по умолчанию используется текущий идентификатор пользователя).
.TP
.BI [-g|--gid=] gid
Запускается под идентификатором группы пользователей \fIgid\fR (по умолчанию используется текущий идентификатор группы пользователей).
.TP
.BI [-n|--no-pid-file]
Не записывает файл идентификатора процесса. Конфликтует с опцией
.BI --pid= .
.TP
.BI [-p|--pid=] файл-pid
Записывает идентификатор процесса в \fIфайл-pid\fR вместо файла по умолчанию
\fI/run/iscsid.pid\fR. Конфликтует с опцией
.BI --no-pid-file .
.TP
.BI [-h|--help]
Выводит эту справку и завершает работу.
.TP
.BI [-v|--version]
Выводит версию и завершает работу.
.SH ФАЙЛЫ
.TP
/usr/share/defaults/etc/iscsi/iscsid.conf или /etc/iscsi/iscsid.conf
Файл конфигурации, читаемый
.B iscsid
и
.B iscsiadm
при запуске.
.TP
/usr/share/defaults/etc/iscsi/initiatorname.iscsi или /etc/iscsi/initiatorname.iscsi
Файл, содержащий имя инициатора iSCSI и псевдоним инициатора, читаемый
.B iscsid
и
.B iscsiadm
при запуске.
.TP
/var/lib/iscsi/nodes
Постоянная база данных конфигурации Open-iSCSI
.SH "СМ. ТАКЖЕ"
.BR iscsiadm (8)
.SH АВТОРЫ
Проект Open-iSCSI <http://www.open-iscsi.com/>
.br
Alex Aizman <itn780@yahoo.com>
.br
Dmitry Yusupov <dmitry_yus@yahoo.com>

72
files/man/ru/iscsistart.8 Normal file
View file

@ -0,0 +1,72 @@
.TH ISCSISTART 8 "Янв 2010" "" "Руководство администратора Linux"
.SH НАЗВАНИЕ
iscsistart \- Инструмент для загрузки iSCSI
.SH СИНТАКСИС
.BI iscsistart
[ОПЦИЯ]
.SH ОПИСАНИЕ
.B iscsistart
запускает сессию, используя переданные настройки или информацию о загрузке iBFT или Open Firmware [OF]. Эта программа не предназначена для управления сессиями. Её основное назначение — запуск сессий, используемых для загрузки корневой файловой системы iSCSI.
.SH ОПЦИИ
.TP
.BI [-c|--config=]\fIфайл-конфигурации\fP
Читает конфигурацию из \fIфайл-конфигурации\fR вместо файла по умолчанию
\fI/usr/share/defaults/etc/iscsi/iscsid.conf
или
\fI/etc/iscsi/iscsid.conf\fR.
.TP
.BI [-i|--initiatorname=]\fIимя\fP
Устанавливает InitiatorName в \fIимя\fP (обязательно, если не используется iBFT или OF).
.TP
.BI [-t|--targetname=]\fIимя\fP
Устанавливает TargetName в \fIимя\fP (обязательно, если не используется iBFT или OF).
.TP
.BI [-g|--tgpt=]\fIN\fP
Устанавливает тег группы портала цели в \fIN\fP (обязательно, если не используется iBFT или OF).
.TP
.BI [-a|--address=]\fIA.B.C.D\fP
Устанавливает IP-адрес в \fIA.B.C.D\fP (обязательно, если не используется iBFT или OF).
.TP
.BI [-p|--port=]\fIN\fP
Устанавливает порт в \fIN\fP (необязательно, по умолчанию 3260).
.TP
.BI [-u|--username=]\fIN\fP
Устанавливает имя пользователя в \fIN\fP (необязательно).
.TP
.BI [-w|--password=]\fIN\fP
Устанавливает пароль в \fIN\fP (необязательно).
.TP
.BI [-U|--username_in=]\fIN\fP
Устанавливает входящее имя пользователя в \fIN\fP (необязательно).
.TP
.BI [-W|--password_in=]\fIN\fP
Устанавливает входящий пароль в \fIN\fP (необязательно).
.TP
.BI [-d|--debug=]\fIуровень_отладки\fP
Выводит отладочную информацию.
.TP
.BI [-b|--fwparam_connect]
Создаёт сессию к цели, используя информацию iBFT или OF.
.TP
.BI [-N|--fwparam_network]
Настраивает сеть в соответствии с информацией iBFT или OF.
.TP
.BI [-f|--fwparam_print]
Выводит информацию iBFT или OF в STDOUT.
.TP
.BI [-P|--param=]\fIИМЯ=ЗНАЧЕНИЕ\fP
Устанавливает параметр с именем \fIИМЯ\fP в \fIЗНАЧЕНИЕ\fP. \fIИМЯ\fP — это одна из настроек в записи узла или iscsid.conf. Можно передать несколько параметров.
.TP
.BI [-h|--help]
Выводит эту справку и завершает работу.
.TP
.BI [-v|--version]
Выводит версию и завершает работу.
.SH "СМ. ТАКЖЕ"
.BR iscsiadm (8)
.SH АВТОРЫ
Проект Open-iSCSI <http://www.open-iscsi.com/>
.br
Mike Christie <mchristi@redhat.com>

75
files/man/ru/iscsiuio.8 Normal file
View file

@ -0,0 +1,75 @@
.TH iscsiuio 8 "12/10/2013" "QLogic Corporation" "Руководство системного администратора"
.\"
.\" Часть NAME
.\"
.SH ИМЯ
iscsiuio \- Драйвер ввода-вывода iSCSI в пользовательском пространстве
.\"
.\" Часть SYNOPSIS
.\"
.SH СИНТАКСИС
.B iscsiuio
.RB [ -d -f -v ]
.PP
.\"
.\" Часть DESCRIPTION
.\"
.SH ОПИСАНИЕ
iscsiuio — это драйвер ввода-вывода в пользовательском пространстве для сетевых интерфейсных карт (NIC) QLogic NetXtreme II
серии BCM5706/5708/5709 PCI/PCI-X Gigabit Ethernet и для сетевых интерфейсных карт QLogic NetXtreme II
серии BCM57710/57711/57712/57800/57810/57840 PCI-E 10 Gigabit Ethernet.
Драйвер протестирован на ядрах Linux версии 2.6.28 и выше.
.PP
Обратитесь к файлу README.TXT из пакета драйвера, чтобы узнать, как
скомпилировать и установить драйвер.
.PP
Обратитесь к различной документации по Linux,
чтобы узнать, как настроить сетевой протокол и адрес.
.\"
.\" Часть DRIVER DEPENDENCIES
.\"
.SH ЗАВИСИМОСТИ ДРАЙВЕРА
.\"
.\" Часть PARAMETER
.\"
.SH ПАРАМЕТРЫ
При запуске этого приложения используется очень мало параметров.
.TP
.BI -d|--debug <уровень отладки>
Включает режим отладки, при котором отладочные сообщения выводятся на стандартный вывод (stdout).
Поддерживаются следующие режимы отладки:
.P
.RS
DEBUG 4 - Вывод всех сообщений
.P
INFO 3 - Вывод сообщений, необходимых для отслеживания кода uIP (по умолчанию)
.P
WARN 2 - Вывод предупреждений
.P
ERROR 1 - Вывод только критических ошибок
.RE
.PP
.TP
.BI -f|--foreground
Включает режим работы на переднем плане, чтобы приложение не запускалось в фоновом режиме.
.PP
.TP
.BI -v|--version
Выводит версию приложения.
.PP
.TP
.BI -p|--pid <файл pid>
Использует указанный файл PID (по умолчанию /run/iscsiuio.pid).
.PP
.TP
.BI -h|--help
Отображает эту справку и завершает работу.
.\"
.\" Часть AUTHOR
.\"
.SH АВТОР
Бенджамин Ли \- benli@broadcom.com
.P
Эдди Вай \- eddie.wai@broadcom.com
.SH ПОДДЕРЖИВАЕТСЯ
QLogic-Storage-Upstream@qlogic.com

View file

@ -0,0 +1,63 @@
diff --git a/usr/initiator.h b/usr/initiator.h
index 97918cb..55bb630 100644
--- a/usr/initiator.h
+++ b/usr/initiator.h
@@ -35,11 +35,13 @@
#include "log.h"
#ifndef ISCSI_CONFIG_ROOT
-#define ISCSI_CONFIG_ROOT "/etc/iscsi/"
+#define ISCSI_CONFIG_ROOT "/etc/iscsi"
#endif
#define CONFIG_FILE ISCSI_CONFIG_ROOT"/iscsid.conf"
+#define CONFIG_FILE_STATELESS "/usr/share/defaults"CONFIG_FILE
#define INITIATOR_NAME_FILE ISCSI_CONFIG_ROOT"/initiatorname.iscsi"
+#define INITIATOR_NAME_FILE_STATELESS "/usr/share/defaults"INITIATOR_NAME_FILE
#define PID_FILE "/run/iscsid.pid"
diff --git a/usr/iscsid.c b/usr/iscsid.c
index c72ed5d..08f4f3b 100644
--- a/usr/iscsid.c
+++ b/usr/iscsid.c
@@ -390,6 +390,12 @@ int main(int argc, char *argv[])
bool pid_file_specified = false;
bool no_pid_file_specified = false;
+ if (access(config_file, R_OK) != 0)
+ config_file = CONFIG_FILE_STATELESS;
+
+ if (access(initiatorname_file, R_OK) != 0)
+ initiatorname_file = INITIATOR_NAME_FILE_STATELESS;
+
while ((ch = getopt_long(argc, argv, "c:i:fd:nu:g:p:vh", long_options,
&longindex)) >= 0) {
switch (ch) {
@@ -552,6 +558,9 @@ int main(int argc, char *argv[])
exit(ISCSI_ERR);
}
+ log_info("iSCSI configuration file: %s", config_file);
+ log_info("iSCSI initiator file: %s", initiatorname_file);
+
memset(&daemon_config, 0, sizeof (daemon_config));
daemon_config.pid_file = pid_file;
daemon_config.config_file = config_file;
diff --git a/usr/iscsistart.c b/usr/iscsistart.c
index df92d24..c6188aa 100644
--- a/usr/iscsistart.c
+++ b/usr/iscsistart.c
@@ -373,7 +373,11 @@ int main(int argc, char *argv[])
int control_fd, mgmt_ipc_fd, err;
pid_t pid;
- strcpy(config_file, CONFIG_FILE);
+ const char *config_file_stateless = CONFIG_FILE;
+ if (access(config_file_stateless, R_OK) != 0)
+ config_file_stateless = CONFIG_FILE_STATELESS;
+
+ strcpy(config_file, config_file_stateless);
idbm_node_setup_defaults(&config_rec);
config_rec.name[0] = '\0';
config_rec.conn[0].address[0] = '\0';

View file

@ -0,0 +1,105 @@
diff --git a/doc/iscsi-gen-initiatorname.8.template b/doc/iscsi-gen-initiatorname.8.template
index 97a6e21..2953c75 100644
--- a/doc/iscsi-gen-initiatorname.8.template
+++ b/doc/iscsi-gen-initiatorname.8.template
@@ -36,10 +36,10 @@ Force overwrite of existing initiator name, if present.
.TP
.BI [-p] \fIIQN-PREFIX\fP
Use \fIIQN-PREFIX\fP as the prefix to the IQN generated,
-instead of the default of \fBiqn.1996-04.de.suse:01\fP.
+instead of the default of \fBiqn.2025-05.local.open-iscsi:solus\fP.
.SH FILES
.TP
-@HOMEDIR@/initiatorname.iscsi
+/usr/share/defaults/etc/iscsi/initiatorname.iscsi or @HOMEDIR@/initiatorname.iscsi
The file containing the initiator name. Do not edit manually.
.SH "SEE ALSO"
.BR iscsi-iname (8)
diff --git a/doc/iscsi-iname.8.template b/doc/iscsi-iname.8.template
index b2d1c79..d1f1017 100644
--- a/doc/iscsi-iname.8.template
+++ b/doc/iscsi-iname.8.template
@@ -14,7 +14,7 @@ generates a unique iSCSI node name on every invocation.
Display help
.TP
.BI [-p=]\fIprefix\fP
-Use the prefix passed in instead of the default "@IQN_PREFIX@"
+Use the prefix passed in instead of the default "iqn.2025-05.local.open-iscsi:solus"
.SH AUTHORS
Open-iSCSI project <http://www.open-iscsi.com/>
diff --git a/doc/iscsiadm.8.template b/doc/iscsiadm.8.template
index 90e1f3f..2118e83 100644
--- a/doc/iscsiadm.8.template
+++ b/doc/iscsiadm.8.template
@@ -185,7 +185,7 @@ while running: the \fBHOMEDIR\fR and the \fBDBROOT\fR. The following
describes them:
.TP
.B Home Directory
-The \fIhome directory\fR for open-iscsi is @HOMEDIR@. This is
+The \fIhome directory\fR for open-iscsi is /usr/share/defaults/etc/iscsi or @HOMEDIR@. This is
where it keeps its configuration file (\fIiscsid.conf\fR) and its
initiator name file (\fIinitiatorname.iscsi\fR).
.TP
@@ -695,10 +695,10 @@ List all sessions in tree format:
\fBsh#\fR iscsiadm \-\-mode session \-\-print
.SH FILES
.TP
-@HOMEDIR@/iscsid.conf
+/usr/share/defaults/etc/iscsi/iscsid.conf or @HOMEDIR@/iscsid.conf
The configuration file read by \fBiscsid\fR and \fBiscsiadm\fR on startup.
.TP
-@HOMEDIR@/initiatorname.iscsi
+/usr/share/defaults/etc/iscsi/initiatorname.iscsi or @HOMEDIR@/initiatorname.iscsi
The file containing the iSCSI InitiatorName and InitiatorAlias read by
\fBiscsid\fR and \fBiscsiadm\fR on startup.
.TP
diff --git a/doc/iscsid.8.template b/doc/iscsid.8.template
index 0d122a0..3debe54 100644
--- a/doc/iscsid.8.template
+++ b/doc/iscsid.8.template
@@ -15,10 +15,14 @@ iSCSI database.
.TP
.BI [-c|--config=]\fIconfig\-file\fP
Read configuration from \fIconfig\-file\fR rather than the default
+\fI/usr/share/defaults/etc/iscsi/iscsid.conf
+or
\fI@HOMEDIR@/iscsid.conf\fR file.
.TP
.BI [-i|--initiatorname=]\fIiname\-file\fP
Read initiator name from \fIiname\-file\fR rather than the default
+\fI/usr/share/defaults/etc/iscsi/initiatorname.iscsi
+or
\fI@HOMEDIR@/initiatorname.iscsi\fR file.
.TP
.BI [-f|--foreground]
@@ -55,14 +59,14 @@ display version and exit.
.SH FILES
.TP
-@HOMEDIR@/iscsid.conf
+/usr/share/defaults/etc/iscsi/iscsid.conf or @HOMEDIR@/iscsid.conf
The configuration file read by
.B iscsid
and
.B iscsiadm
on startup.
.TP
-@HOMEDIR@/initiatorname.iscsi
+/usr/share/defaults/etc/iscsi/initiatorname.iscsi or @HOMEDIR@/initiatorname.iscsi
The file containing the iSCSI initiatorname
and initiatoralias read by
.B iscsid
diff --git a/doc/iscsistart.8.template b/doc/iscsistart.8.template
index 62fae4d..45cd78d 100644
--- a/doc/iscsistart.8.template
+++ b/doc/iscsistart.8.template
@@ -14,6 +14,8 @@ sessions used for iSCSI root boot.
.TP
.BI [-c|--config=]\fIconfig\-file\fP
Read configuration from \fIconfig\-file\fR rather than the default
+\fI/usr/share/defaults/etc/iscsi/iscsid.conf
+or
\fI@HOMEDIR@/iscsid.conf\fR file.
.TP
.BI [-i|--initiatorname=]\fIname\fP

2
files/series Normal file
View file

@ -0,0 +1,2 @@
patches/0001-stateless.patch
patches/0002-fix-paths-man-pages.patch

View file

@ -1,21 +1,41 @@
name : open-iscsi name : open-iscsi
version : 2.1.11 version : 2.1.11
release : 1 release : 2
source : source :
# Took the latest Git slice as the source since the fix logs contain more objective corrections.
- git|https://github.com/open-iscsi/open-iscsi.git : 0510644ac23386a6e2c986823a46c57e4ae64d4d - git|https://github.com/open-iscsi/open-iscsi.git : 0510644ac23386a6e2c986823a46c57e4ae64d4d
homepage : https://www.open-iscsi.com/ homepage : https://www.open-iscsi.com/
license : GPL-2.0-or-later license : GPL-2.0-or-later
component : system.utils component : network.util
summary : High performance, transport independent, multi-platform iSCSI initiator summary : High performance, transport independent, multi-platform iSCSI initiator
description: | description: |
High performance, transport independent, multi-platform iSCSI initiator The Open-iSCSI project provides a high-performance, transport independent, implementation of RFC 3720 iSCSI for Linux.
builddeps : builddeps :
- pkgconfig(libisns) - pkgconfig(libisns)
- pkgconfig(libkmod) - pkgconfig(libkmod)
setup : | setup : |
%apply_patches
%meson_configure -Discsi_sbindir=/usr/bin -Drulesdir=/usr/lib/udev/rules.d %meson_configure -Discsi_sbindir=/usr/bin -Drulesdir=/usr/lib/udev/rules.d
build : | build : |
%ninja_build %ninja_build
install : | install : |
%ninja_install %ninja_install
echo -n > $installdir/etc/iscsi/initiatorname.iscsi
# Install man pages
install -Dm 00644 $pkgfiles/man/ru/iscsiadm.8 $installdir/usr/share/man/ru/man8/iscsiadm.8
install -Dm 00644 $pkgfiles/man/ru/iscsid.8 $installdir/usr/share/man/ru/man8/iscsid.8
install -Dm 00644 $pkgfiles/man/ru/iscsi_discovery.8 $installdir/usr/share/man/ru/man8/iscsi_discovery.8
install -Dm 00644 $pkgfiles/man/ru/iscsi_fw_login.8 $installdir/usr/share/man/ru/man8/iscsi_fw_login.8
install -Dm 00644 $pkgfiles/man/ru/iscsi-gen-initiatorname.8 $installdir/usr/share/man/ru/man8/iscsi-gen-initiatorname.8
install -Dm 00644 $pkgfiles/man/ru/iscsi-iname.8 $installdir/usr/share/man/ru/man8/iscsi-iname.8
install -Dm 00644 $pkgfiles/man/ru/iscsistart.8 $installdir/usr/share/man/ru/man8/iscsistart.8
install -Dm 00644 $pkgfiles/man/ru/iscsiuio.8 $installdir/usr/share/man/ru/man8/iscsiuio.8
install -dm00755 $installdir/usr/share/defaults/etc/
mv $installdir/etc/iscsi $installdir/usr/share/defaults/etc/
install -Dm 00644 $pkgfiles/initiatorname.iscsi $installdir/usr/share/defaults/etc/iscsi/initiatorname.iscsi
# logrotate not used in Solus
rm $installdir/etc/logrotate.d/iscsiuiolog
rmdir $installdir/etc/logrotate.d
rmdir $installdir/etc