.\" -*- mode: troff; coding: utf-8 -*- .\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie n \{\ . ds C` "" . ds C' "" 'br\} .el\{\ . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" .\" Required to disable full justification in groff 1.23.0. .if n .ds AD l .\" ======================================================================== .\" .IX Title "SPICE-CLIENT 1" .TH SPICE-CLIENT 1 2025-12-07 "perl v5.42.0" "Spice-GTK Documentation" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "نام (NAME)" Spice\-GTK \- کتابخانه‌ای سمت کلاینت برای دسترسی به نمایشگرهای راه دور SPICE .SH "توضیحات (DESCRIPTION)" .IX Header "DESCRIPTION" کتابخانهٔ Spice\-GTK امکان دسترسی به نمایشگرهای راه دور را از طریق پروتکل SPICE فراهم می‌کند. در حال حاضر کاربرد اصلی آن دسترسی به ماشین‌های مجازی راه دور است. .PP کتابخانهٔ Spice\-GTK مجموعه‌ای از گزینه‌های خط فرمان را ارائه می‌دهد که می‌توان از آن‌ها برای سفارشی‌سازی برخی تنظیمات خاص SPICE استفاده کرد. .SH "نشانی اینترنتی (URI)" .IX Header "URI" برای برقراری یک اتصال معمولی SPICE (اتصال رمزگذاری‌نشده خواهد بود) به hostname.example.com و پورت 5900، از URI زیر استفاده کنید: .PP .Vb 1 \& spice://hostname.example.com:5900 .Ve .PP برای آغاز یک اتصال TLS، باید از این ساختار استفاده شود: .PP .Vb 1 \& spice+tls://hostname.example.com:5900 .Ve .PP نکته: پروتکل \*(Aqspice+tls\*(Aq از نسخهٔ v0.35 در دسترس است؛ پیش از آن باید از رشته پرس‌وجوی spice:// به همراه پارامتر \*(Aqtls\-port\*(Aq استفاده کنید. .SH "رشته پرس‌وجوی نشانی (URI query string)" .IX Header "URI query string" نشانی spice رشته‌های پرس‌وجو (query string) را می‌پذیرد. در صورت جداسازی با & یا ; می‌توان چندین پارامتر را هم‌زمان مشخص کرد: .PP .Vb 1 \& spice://hostname.example.com?port=5900;tls\-port=5901 .Ve .PP هنگام استفاده از \*(Aqtls\-port\*(Aq، توصیه می‌شود هیچ پورت غیر TLS مشخص نشود. در صورتی که هر دو گزینهٔ \*(Aqport\*(Aq و \*(Aqtls\-port\*(Aq را مشخص می‌کنید، حتماً از گزینهٔ \-\-spice\-secure\-channels برای تعیین کانال‌هایی که باید امن باشند استفاده نمایید. در غیر این صورت، Spice\-GTK ابتدا تلاش می‌کند به پورت غیر TLS متصل شود و سپس پورت TLS را امتحان می‌کند. این بدان معناست که یک حمله‌کنندهٔ میانی (man\-in\-the\-middle) می‌تواند بدون توجه به تنظیمات TLS سرور SPICE، کل نشست SPICE را وادار به ارسال متن رمزنشده (clear text) کند. .PP سایر پارامترهای معتبر URI عبارتند از \*(Aqusername\*(Aq و \*(Aqpassword\*(Aq. توجه داشته باشید که ارسال گذرواژه از طریق URI در SPICE ممکن است باعث شود گذرواژه برای هر کاربر محلی دیگری از طریق دستور \*(Aqps\*(Aq قابل مشاهده باشد. .SH "گزینه‌ها (OPTIONS)" .IX Header "OPTIONS" هنگام اجرای یک کلاینت SPICE که از گزینه‌های پیش‌فرض Spice\-GTK استفاده می‌کند، گزینه‌های زیر پذیرفته می‌شوند: .IP \-\-spice\-secure\-channels= 4 .IX Item "--spice-secure-channels=" اجبار کانال‌های مشخص‌شده به برقراری ارتباط امن .Sp این گزینه به کلاینت SPICE اعلام می‌کند که برای این کانال‌ها الزاماً باید از یک اتصال TLS استفاده کند. اگر سرور برای این کانال‌ها تنها اتصالات غیر TLS ارائه دهد، کلاینت از آن‌ها استفاده نخواهد کرد. مقدار ویژهٔ «all» مشخص می‌کند که تمامی کانال‌های SPICE باید رمزگذاری شوند. .Sp کانال‌های فعلی SPICE عبارتند از: main، display، inputs، cursor، playback، record، smartcard، usbredir. .IP \-\-spice\-disable\-effects= 4 .IX Item "--spice-disable-effects=" غیرفعال‌سازی جلوه‌های بصری سیستم‌عامل مهمان .Sp این گزینه به کلاینت SPICE اعلام می‌کند که برای کاهش مصرف پهنای باند، تلاش کند برخی از قابلیت‌های سیستم‌عامل مهمان را غیرفعال کند. این قابلیت نیاز به پشتیبانی در سیستم‌عامل مهمان دارد که معمولاً از طریق یک SPICE agent فراهم می‌شود. در حال حاضر این قابلیت تنها در مهمان‌های Windows پشتیبانی می‌شود. .Sp مقدار «wallpaper» تصویر پس‌زمینهٔ مهمان را غیرفعال می‌کند، «font\-smooth» سیستم یکدست‌سازی قلم‌ها (antialiasing) را خاموش می‌کند، و «animation» تلاش می‌کند برخی پویانمایی‌های محیط میزکار را غیرفعال سازد. مقدار «all» تلاش می‌کند هر آنچه قابلیت غیرفعال‌سازی دارد را غیرفعال کند. .IP \-\-spice\-color\-depth=<16,32> 4 .IX Item "--spice-color-depth=<16,32>" عمق رنگ نمایشگر مهمان \- منسوخ‌شده .Sp این گزینه به کلاینت SPICE می‌گوید که تلاش کند عمق رنگ سیستم‌عامل مهمان را اجبار کند. عمق رنگ کمتر مصرف پهنای باند را کاهش می‌دهد. این مورد نیاز به پشتیبانی در مهمان دارد که معمولاً از طریق یک SPICE agent مهیا می‌شود. در حال حاضر این قابلیت تنها در ویندوز ۷ و نسخه‌های قدیمی‌تر پشتیبانی می‌شود. .IP \-\-spice\-ca\-file= 4 .IX Item "--spice-ca-file=" فایل مخزن گواهی‌های معتبر (Truststore) برای اتصالات امن .Sp این گزینه برای مشخص کردن یک فایل .crt حاوی گواهی CA که گواهی‌های TLS سرور SPICE با آن امضا شده‌اند استفاده می‌شود. این گزینه هنگام استفاده از گواهی‌های TLS خودامضاشده (self\-signed) به جای گواهی‌های صادرشده توسط مراجع رسمی CA بسیار کاربردی است. .IP \-\-spice\-host\-subject= 4 .IX Item "--spice-host-subject=" موضوع (Subject) گواهی میزبان (جفت‌های field=value تفکیک‌شده با کاما) .Sp هنگام استفاده از گواهی‌های خودامضاشده، یا هنگامی که سیستم‌عامل مهمان میان میزبان‌های مختلف جابه‌جا (migrate) می‌شود، subject یا altSubject گواهی TLS که توسط سرور SPICE ارائه می‌شود لزوماً با نام میزبانی (hostname) که به آن متصل می‌شویم یکسان نخواهد بود. این گزینه امکان بازنویسی موضوع مورد انتظار گواهی TLS را فراهم می‌کند. .Sp موضوع باید مطابق با خط «Subject:» باشد که توسط دستور زیر خروجی داده می‌شود: openssl x509 \-noout \-text \-in server\-cert.pem .IP \-\-spice\-debug 4 .IX Item "--spice-debug" فعال‌سازی اشکال‌زدایی در Spice\-GTK. این حالت را می‌توان از طریق متغیر محیطی SPICE_DEBUG یا با استفاده از G_MESSAGES_DEBUG=all نیز فعال کرد. .IP \-\-spice\-disable\-audio 4 .IX Item "--spice-disable-audio" غیرفعال‌سازی پشتیبانی از صدا .IP \-\-spice\-disable\-usbredir 4 .IX Item "--spice-disable-usbredir" غیرفعال‌سازی پشتیبانی از هدایت مجدد USB .IP \-\-spice\-usbredir\-auto\-redirect\-filter= 4 .IX Item "--spice-usbredir-auto-redirect-filter=" فیلتر انتخاب دستگاه‌های USB برای هدایت خودکار هنگام اتصال .Sp این فیلتر مشخص می‌کند در زمان فعال بودن نشست SPICE، کدام دستگاه‌های USB باید به محض اتصال به‌طور خودکار هدایت مجدد شوند. .Sp قالب یک قاعده به صورت زیر است: \&\f(CW\*(C`class,vendor,product,version,allow\*(C'\fR .Sp می‌توان از مقدار \-1 به جای class، vendor، product یا version برای پذیرش هر مقداری استفاده کرد. می‌توان چندین قاعده را با نویسهٔ \*(Aq|\*(Aq ادغام نمود: \&\f(CW\*(C`rule1|rule2|rule3\*(C'\fR .IP \-\-spice\-usbredir\-redirect\-on\-connect= 4 .IX Item "--spice-usbredir-redirect-on-connect=" فیلتر انتخاب دستگاه‌های USB برای هدایت مجدد هنگام برقراری اتصال .Sp این فیلتر مشخص می‌کند پس از برقراری موفق اتصال SPICE به یک نمایشگر راه دور، کدام دستگاه‌های USB باید فوراً بازهدایت شوند. .IP \-\-spice\-gtk\-version 4 .IX Item "--spice-gtk-version" نمایش اطلاعات نسخهٔ Spice\-GTK .IP \-\-spice\-smartcard 4 .IX Item "--spice-smartcard" فعال‌سازی پشتیبانی از کارت هوشمند .IP \-\-spice\-smartcard\-db= 4 .IX Item "--spice-smartcard-db=" مسیر پایگاه‌دادهٔ محلی گواهی برای استفاده در گواهی‌های نرم‌افزاری کارت هوشمند .Sp این گزینه تنها برای مقاصد آزمایشی سودمند است. به جای داشتن یک کارت‌خوان سخت‌افزاری و یک کارت هوشمند فیزیکی، می‌توانید فایلی حاوی ۳ گواهی را مشخص کنید که برای شبیه‌سازی کارت هوشمند در سطح نرم‌افزار استفاده خواهد شد. برای جزئیات بیشتر در خصوص نحوهٔ ساخت این گواهی‌ها به نشانی \&\f(CW\*(C`http://www.spice\-space.org/page/SmartcardUsage#Using_a_software_smartcard\*(C'\fR مراجعه نمایید. .IP \-\-spice\-smartcard\-certificates= 4 .IX Item "--spice-smartcard-certificates=" گواهی‌های مورد استفاده برای کارت‌های هوشمند نرم‌افزاری (جفت‌های field=values تفکیک‌شده با کاما) .Sp این گزینه تنها برای مقاصد آزمایشی مفید است و امکان تعیین این را می‌دهد که کدام گواهی‌ها از پایگاه‌دادهٔ گواهی مشخص‌شده توسط \-\-spice\-smartcard\-db برای شبیه‌سازی کارت هوشمند استفاده شوند. .IP \-\-spice\-cache\-size= 4 .IX Item "--spice-cache-size=" اندازهٔ حافظهٔ موقت (کَش) تصویر \- منسوخ‌شده .Sp از این گزینه تنها باید برای آزمون و اشکال‌زدایی استفاده شود. .IP \-\-spice\-glz\-window\-size= 4 .IX Item "--spice-glz-window-size=" اندازهٔ تاریخچه فشرده‌سازی Glz \- منسوخ‌شده .Sp از این گزینه تنها باید برای آزمون و اشکال‌زدایی استفاده شود. .SH "گزارش باگ‌ها (BUGS)" .IX Header "BUGS" باگ‌ها را به فهرست پستی \f(CW\*(C`http://lists.freedesktop.org/mailman/listinfo/spice\-devel\*(C'\fR گزارش دهید. .SH "کپی‌رایت و تکثیر (COPYRIGHT)" .IX Header "COPYRIGHT" حق نشر (C) ۲۰۱۱، ۲۰۱۴ شرکت .Red Hat, Inc و مشارکت‌کنندگان مختلف. این برنامه یک نرم‌افزار آزاد است؛ شما می‌توانید رونوشت‌های آن را تحت شرایط «مجوز عمومی همگانی کاهش‌یافته گنو» (GNU Lesser General Public License) \&\f(CW\*(C`https://www.gnu.org/licenses/old\-licenses/lgpl\-2.1.html\*(C'\fR بازتوزیع نمایید. تا جایی که قانون مجاز می‌داند، هیچ‌گونه ضمانتی برای آن وجود ندارد. .SH "همچنین ببینید (SEE ALSO)" .IX Header "SEE ALSO" \&\f(CW\*(C`virt\-viewer(1)\*(C'\fR، وبگاه پروژه \f(CW\*(C`http://spice\-space.org\*(C'\fR