'\" t
.\"     Title: iscsi-swp
.\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net>
.\"      Date: 03/22/2014
.\"    Manual: iscsi-swp: get/set software write protect
.\"    Source: iscsi-swp
.\"  Language: Persian
.\"
.TH "ISCSI\-SWP" "1" "03/22/2014" "iscsi\-swp" "iscsi\-swp: get/set software w"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
iscsi-swp \- ابزاری برای خواندن یا تنظیم حفاظت نرم‌افزاری در برابر نوشتن روی یک LUN در iSCSI
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBiscsi\-swp\ [\ OPTIONS\ ]\ <ISCSI\-PORTAL>\fR\ 'u
\fBiscsi\-swp [ OPTIONS ] <ISCSI\-PORTAL>\fR
.HP \w'\fBiscsi\-ls\fR\ 'u
\fBiscsi\-ls\fR [\-i\ \-\-initiator\-name=<IQN>] [\-s\ \-\-swp\ {on|off}] [\-d\ \-\-debug=<INTEGER>] [\-?\ \-\-help] [\-\-usage]
.SH "توضیحات (DESCRIPTION)"
.PP
دستور
.B iscsi\-swp
ابزاری برای دریافت یا تنظیم بیت حفاظت نرم‌افزاری در برابر نوشتن (software write protect) روی یک iSCSI LUN است\&.
.SH "قالب نشانی پرتال ISCSI (ISCSI PORTAL URL FORMAT)"
.PP
قالب نشانی پرتال iSCSI به صورت زیر است:
.PP
\*(Aqiscsi://[<username>[%<password>]@]<host>[:<port>]\*(Aq
.PP
نام کاربری و گذرواژه فقط در صورتی لازم هستند که تارگت نیاز به احراز هویت CHAP داشته باشد\&. به صورت اختیاری می‌توانید نام کاربری و گذرواژه را از طریق متغیرهای محیطی
.B LIBISCSI_CHAP_USERNAME
و
.B LIBISCSI_CHAP_PASSWORD
مشخص کنید\&.
.PP
میزبان (Host) را می‌توان به صورت نام میزبان (hostname)، آدرس IPv4 یا آدرس IPv6 تعیین کرد\&. مثال‌ها:
.sp
.if n \{\
.RS 4
.\}
.nf
	iscsi://192\&.0\&.2\&.1
	iscsi://[2001:DB8::1]:3261
	iscsi://ronnie%password@iscsi\&.example\&.com

.fi
.if n \{\
.RE
.\}
.PP
پورت (Port) درگاه TCP روی تارگت است که باید به آن متصل شد\&. مقدار پیش‌فرض 3260 است\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\-i \-\-initiator\-name=<IQN>
.RS 4
این گزینه نام آغازگر (initiator\-name) را مشخص می‌کند که هنگام ورود به تارگت استفاده خواهد شد\&.
.sp
نام پیش‌فرض \*(Aqiqn\&.2007\-10\&.com\&.github:sahlberg:libiscsi:iscsi\-ls\*(Aq است اما می‌توانید با استفاده از این آرگومان آن را تغییر دهید\&. این گزینه عمدتاً برای مواردی مورد نیاز است که تارگت با کنترل دسترسی پیکربندی شده باشد تا تنها اجازه ورودهای شناسایی (discovery logins) را از نام‌های آغازگر شناخته‌شده بدهد\&.
.RE
.PP
\-s \-\-swp {on|off}
.RS 4
به طور پیش‌فرض،
.B iscsi\-swp
تنها تنظیمات فعلی بیت حفاظت نرم‌افزاری در برابر نوشتن را چاپ می‌کند\&. با استفاده از این آرگومان،
.B iscsi\-swp
همچنین تلاش خواهد کرد تا این پرچم را روی LUN هدف تنظیم یا پاک کند\&.
.sp
.if n \{\
.RS 4
.\}
.nf
iscsi\-swp iscsi://127\&.0\&.0\&.1/iqn\&.ronnie\&.test/1
SWP:0

iscsi\-swp iscsi://127\&.0\&.0\&.1/iqn\&.ronnie\&.test/1 \-\-swp on
SWP:0
Turning SWP ON

iscsi\-swp iscsi://127\&.0\&.0\&.1/iqn\&.ronnie\&.test/1 \-\-swp off
SWP:0
Turning SWP OFF

.fi
.if n \{\
.RE
.\}
.RE
.PP
\-d \-\-debug=<INTEGER>
.RS 4
سطح اشکال‌زدایی (Debug level)\&.
.RE
.PP
\-? \-\-help
.RS 4
نمایش متن راهنمای پایه\&.
.RE
.PP
\-\-usage
.RS 4
نمایش متن نحوه استفاده پایه\&.
.RE
.SH "همچنین ببینید (SEE ALSO)"
.PP
iscsi\-inq(1), iscsi\-ls(1)
\m[blue]\fB\%http://github.com/sahlberg/libiscsi\fR\m[]