sdl-freerdp3(1) sdl-freerdp3 sdl-freerdp3(1) نام (NAME) sdl-freerdp3 - کلاینت SDL برای FreeRDP خلاصه دستور (SYNOPSIS) sdl-freerdp3 [file] [options] [/v:server[:port]] توضیحات (DESCRIPTION) برنامهٔ sdl-freerdp3 یک کلاینت پروتکل میزکار از راه دور (RDP) مبتنی بر SDL است که بخشی از پروژهٔ FreeRDP محسوب می‌شود. یک سرور RDP به صورت پیش‌ساخته در بسیاری از نسخه‌های Windows تعبیه شده است. سرورهای جایگزین شامل ogon، gnome-remote-desktop، xrdp و VRDP (در VirtualBox) هستند. گزینه‌ها (OPTIONS) /a:addin[,options], /addin:addin[,options] افزونه (Addin) /azure:[tenantid:id],[use-tenantid[:[on|off]],[ad:url][avd-access:format string],[avd-token:format string],[avd-scope:format string] گزینه‌های AzureAD /action-script:file-name اسکریپت عملیات (پیش‌فرض: ~/.config/freerdp/action.sh) /admin, /console نشست مدیر سیستم (یا کنسول) +aero ترکیب‌بندی میزکار (desktop composition) (پیش‌فرض: off) /app:program:[path|||alias],cmd:command,file:filename,guid:guid,icon:filename,name:name,workdir:directory,hidef:[on|off] برنامهٔ کاربردی از راه دور /assistance:password گذرواژهٔ پشتیبانی از راه دور (Remote assistance) /auto-request-control: درخواست خودکار کنترل ورودی در پشتیبانی از راه دور +async-channels کانال‌های ناهمگام (آزمایشی) (پیش‌فرض: off) +async-update به‌روزرسانی ناهمگام (پیش‌فرض: off) /audio-mode:[[none|2]|[server|1]|[redirect|0]] حالت خروجی صدا +auth-only فقط احراز هویت (پیش‌فرض: off) /auth-pkg-list:[[none],]!ntlm,kerberos,!u2u فیلتر بسته‌های احراز هویت (فهرست جداشده با کاما، برای غیرفعال‌سازی از '!' استفاده کنید). به طور پیش‌فرض تمام روش‌ها فعال هستند. از مقدار صریح 'none' به عنوان آرگومان نخست برای غیرفعال کردن همهٔ روش‌ها و سپس فعال‌سازی انتخابی موارد پس از آن استفاده کنید. -authentication احراز هویت (آزمایشی) (پیش‌فرض: on) +auto-reconnect اتصال مجدد خودکار (پیش‌فرض: off) /auto-reconnect-max-retries:retries حداکثر دفعات تلاش برای اتصال مجدد خودکار، 0 برای نامحدود [0,1000] /bpp:depth عمق رنگ نشست (bpp) (پیش‌فرض: 16) /buildconfig چاپ پیکربندی ساخت برنامه /cache:[bitmap[:on|off],codec[:rfx|nsc],glyph[:on|off],offscreen[:on|off],persist,persist-file:filename] /cert:[deny,ignore,name:name,tofu,fingerprint:hash:hash as hex[,fingerprint:hash:another hash]] گزینه‌های پذیرش گواهی. با احتیاط استفاده کنید! * deny ... لغو خودکار اتصال در صورت عدم تطابق گواهی، بدون نیاز به تعامل کاربر. * ignore ... نادیده گرفتن کامل بررسی‌های گواهی (بر سایر گزینه‌ها اولویت دارد) * name ... استفاده از جایگزین به جای موضوع (subject) گواهی برای تطبیق با گواهی‌های ذخیره‌شده محلی * tofu ... پذیرش بدون قیدوشرط گواهی در اولین اتصال، و رد در اتصالات بعدی در صورت عدم تطابق گواهی * fingerprints ... فهرستی از درهم‌سازی‌های (هش‌های) گواهی که بدون قیدوشرط برای یک اتصال پذیرفته می‌شوند /client-build-number:number شماره ساخت کلاینت ارسالی به سرور (بر رفتار کارت هوشمند تأثیر می‌گذارد، [MS-RDPESC] را ببینید) /client-hostname:name نام میزبان کلاینت جهت ارسال به سرور /clipboard:[[use-selection:atom],[direction-to:[all|local|remote|off]],[files-to[:all|local|remote|off]]] تغییر مسیر کلیپ‌بورد: * use-selection: ... (در X11) مشخص می‌کند به کدام گزینش X دسترسی حاصل شود. پیش‌فرض CLIPBOARD است. گزینهٔ PRIMARY گزینش با کلیک وسط به سبک سامانه X است. * direction-to:[all|local|remote|off] جهت فعال کلیپ‌بورد را کنترل می‌کند * files-to:[all|local|remote|off] جهت فعال انتقال فایل از طریق کلیپ‌بورد را کنترل می‌کند (پیش‌فرض: on) -compression, -z فشرده‌سازی (پیش‌فرض: on) /compression-level:level سطح فشرده‌سازی (0، 1، 2) +credentials-delegation تفویض اعتبارنامه‌ها (پیش‌فرض: off) /d:domain دامنه (Domain) -decorations تزیینات پنجره (پیش‌فرض: on) /disp کنترل نمایشگر /drive:name,path تغییر مسیر دایرکتوری به عنوان یک اشتراک‌گذاری با نام . پشتیبانی از اتصال گرم با /drive:hotplug,* فعال می‌شود. این آرگومان عملکردی مشابه گزینهٔ "Drives that I plug in later" در MSTSC ارائه می‌دهد. +drives تغییر مسیر تمام نقاط اتصال به عنوان اشتراک‌گذاری (پیش‌فرض: off) /dump:record|replay,file:file[,nodelay] ضبط یا بازپخش دامپ /dvc:channel[,options] کانال مجازی پویا (DVC) +dynamic-resolution ارسال به‌روزرسانی‌های وضوح تصویر هنگام تغییر اندازهٔ پنجره (پیش‌فرض: off) /echo, /echo کانال Echo -encryption رمزنگاری (آزمایشی) (پیش‌فرض: فعال) /encryption-methods:[40,][56,][128,][FIPS] روش‌های رمزنگاری امنیت استاندارد RDP /endpointfedauth:token توکن Endpoint FedAuth برای سناریوهای اتصال به کنسول ماشین مجازی Hyper-V /f حالت تمام‌صفحه (++ وضعیت تمام‌صفحه را تغییر می‌دهد) +fipsmode حالت FIPS (پیش‌فرض: غیرفعال) /floatbar[:sticky:[on|off],default:[visible|hidden],show:[always|fullscreen|window]] نوار شناور floatbar به‌طور پیش‌فرض غیرفعال است (در صورت فعال‌سازی، در حالت تمام‌صفحه به‌طور پیش‌فرض روی sticky قرار می‌گیرد) -fonts هموارسازی فونت‌ها (ClearType) (پیش‌فرض: فعال) +force-console-callbacks استفاده از کال‌بک‌های پیش‌فرض (کنسول) برای گواهی/اعتبارنامه/... (پیش‌فرض: غیرفعال) /frame-ack:number تعداد تأیید دریافت فریم (frame acknowledgement) /args-from:file:file|stdin|fd:number|env:name خواندن خط فرمان از یک فایل، stdin یا توصیف‌گر فایل (file descriptor). این آرگومان نمی‌تواند با هیچ آرگومان دیگری ترکیب شود. در هر خط یک آرگومان ارائه دهید. /from-stdin[:force] خواندن اعتبارنامه‌ها از stdin. با اعلان دریافت اطلاعات پیش از برقراری اتصال صورت می‌گیرد، در غیر این صورت هنگام درخواست سرور انجام می‌شود. /gateway:g:gateway[:port],u:user,d:domain,p:password,usage-method:[direct|detect],access-token:token,type:[rpc|http[,no-websockets][,extauth-sspi-ntlm]|auto[,no-websockets][,extauth-sspi-ntlm]]|arm,url:wss://url,bearer:oauth2-bearer-token, /gw:g:gateway[:port],u:user,d:domain,p:password,usage-method:[direct|detect],access-token:token,type:[rpc|http[,no-websockets][,extauth-sspi-ntlm]|auto[,no-websockets][,extauth-sspi-ntlm]]|arm,url:wss://url,bearer:oauth2-bearer-token نام میزبان Gateway /gdi:sw|hw رندرینگ GDI /geometry کانال ردیابی هندسه (Geometry) +gestures پردازش ورودی لمس چندگانه به‌صورت محلی (پیش‌فرض: غیرفعال) /gfx[:[[progressive[:on|off]|RFX[:on|off]|AVC420[:on|off]AVC444[:on|off]],mask:value,small-cache[:on|off],thin-client[:on|off],progressive[:on|off],frame-ack[:on|off]] پایپ‌لاین گرافیکی RDP8 -grab-keyboard در دست گرفتن فوکوس صفحه‌کلید، ارسال تمام کلیدها به سیستم راه دور (پیش‌فرض: فعال) -grab-mouse در دست گرفتن فوکوس ماوس، ارسال تمام رویدادها به سیستم راه دور (پیش‌فرض: فعال) /h:height ارتفاع (پیش‌فرض: 768) -heartbeat پشتیبانی از PDUهای heartbeat (پیش‌فرض: فعال) /help, /? نمایش راهنما +home-drive هدایت پوشه خانگی کاربر به‌عنوان یک اشتراک (پیش‌فرض: غیرفعال) /ipv4[:[:force]], /4[:[:force]] ترجیح رکورد A در IPv4 بر رکورد AAAA در IPv6 /ipv6[:[:force]], /6[:[:force]] ترجیح رکورد AAAA در IPv6 بر رکورد A در IPv4 /jpeg پشتیبانی از کُدک JPEG /jpeg-quality:percentage کیفیت JPEG /kbd:[layout:[0xid|name],lang:0xid,fn-key:value,type:value,subtype:value,unicode[:on|off],remap:key1=value1,remap:key2=value2,pipe:filename] گزینه‌های مربوط به صفحه‌کلید: * layout: تنظیم چیدمان صفحه‌کلید اعلام‌شده به سرور * lang: تنظیم شناسه زبان صفحه‌کلید ارسال‌شده به سرور * fn-key: مقدار کلید عملیاتی (Function key) * remap: نگاشت یک scancode در RDP به دیگری. برای دریافت فهرست نگاشت‌ها از /list:kbd-scancode استفاده کنید. مثال: برای جابه‌جایی 'a' و 's' در یک صفحه‌کلید US: /kbd:remap:0x1e=0x1f,remap:0x1f=0x1e * pipe: نام یک pipe نام‌گذاری‌شده (named pipe) که می‌تواند برای تایپ متن درون نشست RDP استفاده شود /kerberos:[kdc-url:url,lifetime:time,start-time:time,renewable-lifetime:time,cache:path,armor:path,pkinit-anchors:path,pkcs11-module:name] گزینه‌های Kerberos /load-balance-info:info-string اطلاعات موازنه بار (Load balance info) /list:[kbd|kbd-scancode|kbd-lang[:value]|smartcard[:[pkinit-anchors:path][,pkcs11-module:name]]|monitor|tune|timezones] فهرست کردن گزینه‌های موجود برای زیرفرمان (پیش‌فرض: فهرست کردن گزینه‌های موجود برای زیرفرمان) /log-filters:tag:level[,tag:level[,...]] تنظیم فیلترهای ثبت‌کننده وقایع، برای جزئیات به wLog(7) مراجعه کنید /log-level:[OFF|FATAL|ERROR|WARN|INFO|DEBUG|TRACE] تنظیم سطح پیش‌فرض گزارش‌گیری، برای جزئیات به wLog(7) مراجعه کنید /max-fast-path-size:size مشخص کردن حداکثر اندازه به‌روزرسانی fast-path /max-loop-time:time مشخص کردن حداکثر زمان بر حسب میلی‌ثانیه برای پردازش بسته‌ها +menu-anims پویانمایی‌های منو (پیش‌فرض: غیرفعال) /microphone[:[sys:sys,][dev:dev,][format:format,][rate:rate,][channel:channel]], /mic[:[sys:sys,][dev:dev,][format:format,][rate:rate,][channel:channel]] ورودی صدا (میکروفون) /monitors:id[,id[,...]] [آزمایشی] انتخاب نمایشگرها جهت استفاده (تنها در حالت تمام‌صفحه یا چندنمایشگره مؤثر است) -mouse-motion ارسال رویدادهای حرکت ماوس (پیش‌فرض: on) +mouse-relative ارسال حرکت ماوس با آدرس‌دهی نسبی (پیش‌فرض: off) /mouse:[relative:[on|off],grab:[on|off]] گزینه‌های مربوط به ماوس: * relative: ارسال حرکات نسبی ماوس در صورت پشتیبانی توسط سرور * grab: تسخیر ماوس در صورت قرارگیری درون پنجره /multimon[:force] استفاده از چند نمایشگر +multitouch بازهدایت ورودی چندلمسی (پیش‌فرض: off) -multitransport پشتیبانی از پروتکل multitransport (پیش‌فرض: on) -nego مذاکره امنیتی پروتکل (پیش‌فرض: on) /network:[invalid|modem|broadband|broadband-low|broadband-high|wan|lan|auto] نوع اتصال شبکه /nsc, /nscodec پشتیبانی از NSCodec /orientation:[0|90|180|270] جهت‌گیری نمایشگر بر حسب درجه +old-license استفاده از روال مجوزدهی قدیمی (بدون CAL و با تنظیم hwId روی 0) (پیش‌فرض: off) /p[:password] گذرواژه. اگر برای اتصال نیازی به اطلاعات کاربری نباشد، ارسال /p بدون آرگومان باعث جلوگیری از نمایش اعلان‌های تعاملی گذرواژه می‌شود. /parallel[:name[,path]] بازهدایت دستگاه موازی (parallel) /parent-window:window-id شناسه پنجره والد /pcb:blob داده باینری پیش‌اتصال (Preconnection Blob) /pcid:id شناسه پیش‌اتصال (Preconnection Id) /pheight:height ارتفاع فیزیکی نمایشگر (به میلی‌متر) /play-rfx:pcap-file بازپخش فایل pcap پروتکل rfx /port:number پورت سرور -suppress-output متوقف کردن ارسال خروجی هنگام کمینه‌شدن پنجره (پیش‌فرض: on) +print-reconnect-cookie چاپ کوکی اتصال مجدد در قالب base64 پس از برقراری اتصال (پیش‌فرض: off) /printer[:name[,driver[,default]]] بازهدایت دستگاه چاپگر /proxy:[proto://][user:password@]host[:port] تنظیمات پروکسی: بازنویسی متغیر محیطی (همچنین بخش متغیرهای محیطی در زیر را ببینید). پروتکل "socks5" باید به‌طور صریح مشخص شود، در حالی که "http" پیش‌فرض است. /pth:password-hash, /pass-the-hash:password-hash روش Pass the hash (حالت مدیر محدودشده) /pwidth:width عرض فیزیکی نمایشگر (به میلی‌متر) /rdp2tcp:executable path[:arg...] بازهدایت TCP /reconnect-cookie:base64-cookie ارسال کوکی اتصال مجدد base64 به اتصال /redirect-prefer:FQDN|IP|NETBIOS,[...] بازنویسی ترتیب ترجیحی بازهدایت /relax-order-checks, /relax-order-checks عدم بررسی اینکه آیا دستور RDP در حین تبادل قابلیت‌ها اعلان شده است یا خیر؛ فقط هنگام اتصال به یک سرور دارای باگ استفاده شود /restricted-admin, /restrictedAdmin حالت مدیر محدودشده (Restricted admin) /rfx پروتکل RemoteFX /rfx-mode:[image|video] حالت RemoteFX /scale:[100|140|180] ضریب مقیاس‌بندی نمایشگر (پیش‌فرض: 100) /scale-desktop:percentage ضریب مقیاس‌بندی برنامه‌های دسکتاپ (مقداری بین 100 و 500) (پیش‌فرض: 100) /scale-device:100|140|180 ضریب مقیاس‌بندی برای برنامه‌های فروشگاه برنامه (پیش‌فرض: 100) /sec:rdp[:[on|off]]|tls[:[on|off]]|nla[:[on|off]]|ext[:[on|off]]|aad[:[on|off]] اجبار استفاده از یک پروتکل امنیتی خاص. برای مثال /sec:nla پروتکل NLA را فعال و سایر پروتکل‌ها را غیرفعال می‌کند، در حالی که /sec:nla:[on|off] صرفاً وضعیت NLA را تغییر می‌دهد /serial[:name[,path[,driver[,permissive]]]], /tty[:name[,path[,driver[,permissive]]]] بازهدایت دستگاه سریال /server-name:name نام سرور تعیین‌شده توسط کاربر جهت استفاده در اعتبارسنجی (TLS، Kerberos) /shell:shell پوسته جایگزین /shell-dir:dir دایرکتوری کاری پوسته /size:widthxheight یا percent%[wh] اندازه صفحه نمایش (پیش‌فرض: 1024x768) /smart-sizing[:widthxheight] مقیاس‌بندی میزکار دوردست به اندازه پنجره /smartcard[:str[,str...]] بازهدایت دستگاه‌های کارت هوشمند که نام آن‌ها حاوی هر یک از باشد. /smartcard-logon[:[[cert:path|cert:base64(PEM)],[key:path|key:base64(PEM)],pin:pin,csp:csp name,reader:reader,card:card]] احراز هویت ورود با کارت هوشمند (گواهی اختیاری) را فعال می‌کند. /sound[:[sys:sys,][dev:dev,][format:format,][rate:rate,][channel:channel,][latency:latency,][quality:quality]], /audio[:[sys:sys,][dev:dev,][format:format,][rate:rate,][channel:channel,][latency:latency,][quality:quality]] خروجی صوتی (صدا) /span گسترش صفحه نمایش روی چندین نمایشگر /spn-class:service-class کلاس سرویس احراز هویت SPN /ssh-agent, /ssh-agent کانال بازفرستی SSH Agent /sspi-module:SSPI module path مسیر فایل ماژول کتابخانه اشتراکی SSPI /winscard-module:WinSCard module path مسیر فایل ماژول کتابخانه اشتراکی WinSCard /disable-output غیرفعال‌سازی تمام رمزگشایی‌های گرافیکی در نشست کلاینت. مفید برای آزمون‌های بار با اتصالات هم‌زمان بسیار /t:title, /title:title عنوان پنجره -themes پوسته‌ها (پیش‌فرض: on) /timeout:time in ms, /timeout:time in ms تنظیمات پیشرفته برای پیوندهای با تأخیر زیاد: تنظیم مهلت زمانی اتصال؛ اگر در اتصال خود با خطاهای اتمام مهلت مواجه شدید از این گزینه استفاده کنید (پیش‌فرض: 9000) /timezone:windows timezone استفاده از منطقه زمانی ویندوزی ارائه‌شده برای اتصال (نیازمند پشتیبانی سرور)، برای مقادیر مجاز /list:timezones را ببینید /tls:[ciphers|seclevel|secrets-file|enforce] گزینه‌های پیکربندی TLS: * ciphers:[netmon|ma|] * seclevel:, پیش‌فرض: 1, محدوده: [0-5] بازنویسی سطح امنیت پیش‌فرض TLS؛ ممکن است برای سرورهای مقصد قدیمی‌تر مورد نیاز باشد. جزئیات در https://docs.openssl.org/3.0/man3/SSL_CTX_set_security_level * secrets-file: * enforce[:[ssl3|1.0|1.1|1.2|1.3]] اجبار به استفاده از نسخه مشخصی از SSL/TLS برای یک اتصال. برخی سرورها در مذاکره نسخه TLS نقص دارند و ممکن است بدون این گزینه اتصال برقرار نشود. در صورت عدم ارائه آرگومان، مقدار پیش‌فرض TLS 1.2 است. برای windows 7 از 1.0 استفاده کنید -toggle-fullscreen کلیدهای Alt+Ctrl+Enter برای تغییر وضعیت حالت تمام‌صفحه (پیش‌فرض: on) /tune:setting:value,setting:value [آزمایشی] دستکاری مستقیم تنظیمات freerdp، با احتیاط بسیار زیاد استفاده شود! (پیش‌فرض:) /u:[[domain]user|user[@domain]] نام کاربری +unmap-buttons اجازه به سرور برای مشاهده دکمه فیزیکی واقعی نشانگر (پیش‌فرض: off) /usb:[dbg,][id:vid:pid#...,][addr:bus:addr#...,][auto] بازهدایت دستگاه USB /v:server[:port] نام میزبان سرور|URL|IPv4|IPv6 یا vsock:// یا /some/path/to/pipe یا |:1234 برای ارسال سوکت TCP جهت استفاده /vc:channel[,options] کانال مجازی ایستا /version چاپ نسخه /video کانال ریموت بهینه‌سازی‌شده برای ویدیو /prevent-session-lock[:time in sec] جلوگیری از قفل شدن نشست با تزریق رویدادهای ساختگی حرکت ماوس به سرور در زمان بیکاری اتصال (بازه زمانی پیش‌فرض: 180 ثانیه) /vmconnect[:vmid] کنسول Hyper-V (استفاده از درگاه 2179، غیرفعال‌سازی مذاکره) /w:width عرض (پیش‌فرض: 1024) -wallpaper تصویر پس‌زمینه (پیش‌فرض: on) +window-drag کشیدن کامل پنجره (پیش‌فرض: off) /window-position:xposxypos موقعیت پنجره /wm-class:class-name تنظیم اعلان WM_CLASS برای نمونه پنجره /workarea استفاده از فضای کاری در دسترس متغیرهای محیطی wlog برنامه sdl-freerdp3 از wLog به عنوان امکانات لاگ‌گیری خود استفاده می‌کند؛ برای اطلاعات بیشتر می‌توانید به صفحه راهنمای مربوطه (wlog(7)) مراجعه کنید. آرگومان‌های ارسال‌شده از طریق /log-level یا /log-filters بر متغیرهای محیطی اولویت دارند. FREERDP_ASKPASS برنامه‌ای را برای درخواست گذرواژه‌ها، مشابه SSH_ASKPASS تعیین می‌کند. FREERDP_WLROOTS_HACK در صورت تعریف به صورت 0، ترفند تشخیص چندنمایشگره را کاملاً غیرفعال می‌کند. برای فعال‌سازی آن در نشست‌های تمام‌صفحه روی 1 تنظیم کنید. برای فعال‌سازی در تمام نشست‌ها روی force تنظیم کنید. هشدار: تنظیم مقدار force تنها برای نشست‌های تمام‌صفحه یا چندنمایشگره کار می‌کند؛ نشست‌های پنجره‌ای رفتار نادرستی از خود نشان خواهند داد! به طور پیش‌فرض، با ارزیابی XDG_SESSION_DESKTOP و XDG_CURRENT_DESKTOP به تشخیص sway یا سایر کامپوزیتورهای مبتنی بر wlroots رجوع می‌شود. دلیل منطقی: کامپوزیتورهای مبتنی بر wlroots اطلاعات نمایشگر را به پنجره‌های نامرئی ارائه نمی‌دهند، بنابراین روش مناسبی برای استعلام چیدمان فعلی مانیتورها وجود ندارد. با فعال بودن این ترفند، روش جایگزین در پیش گرفته شده و تلاش می‌شود تفکیک‌پذیری‌ها از طریق استعلام جزئیات مقیاس‌بندی و تفکیک‌پذیری نمایشگر که قابلیت اطمینان کمتری دارند، تعیین شوند. فایل پیکربندی (CONFIGURATION FILE) قالب و مکان: فایل پیکربندی به ازای هر کاربر ذخیره می‌شود. متغیر محیطی XDG_CONFIG_HOME می‌تواند برای تغییر دایرکتوری پایه استفاده شود. مقدار پیش‌فرض آن ~/.config است. مکان فایل نسبت به XDG_CONFIG_HOME برابر است با $XDG_CONFIG_HOME/freerdp/sdl-freerdp.json پیکربندی در قالب JSON ذخیره می‌شود. گزینه‌های پشتیبانی‌شده: SDL_KeyModMask ترکیب کلیدهای مورد نیاز برای کلیدهای میانبر کلاینت SDL را تعریف می‌کند. پیش‌فرض KMOD_RSHIFT آرایه‌ای از رشته‌های SDL_Keymod همان‌طور که در https://wiki.libsdl.org/SDL3/SDL_Keymod تعریف شده است. برای غیرفعال کردن کلیدهای میانبر از KEYMOD_NONE استفاده کنید SDL_Fullscreen حالت تمام‌صفحه کلاینت را تغییر می‌دهد. پیش‌فرض SDL_SCANCODE_RETURN. رشته‌ای همان‌طور که در https://wiki.libsdl.org/SDL3/SDL_Scancode تعریف شده است. SDL_Minimize پنجره کلاینت را کمینه می‌کند پیش‌فرض SDL_SCANCODE_M. رشته‌ای همان‌طور که در https://wiki.libsdl.org/SDL3/SDL_Scancode تعریف شده است. SDL_Resizeable وضعیت تغییرپذیری اندازه پنجره محلی را تغییر می‌دهد. پیش‌فرض SDL_SCANCODE_R. رشته‌ای همان‌طور که در https://wiki.libsdl.org/SDL3/SDL_Scancode تعریف شده است. SDL_Grab وضعیت تصاحب صفحه‌کلید و موشواره را تغییر می‌دهد. اگر صفحه‌کلید تصاحب شود، کلیدهای میانبر سیستم محلی دیگر کار نکرده و به سیستم راه دور ارسال می‌شوند. اگر موشواره تصاحب شود (اختیاری)، تشخیص اشاره‌های حرکتی محلی کار نمی‌کند و ممکن است موشواره نتواند از پنجره RDP خارج شود. رویدادهای موشواره دست‌نخورده باقی می‌مانند. پیش‌فرض SDL_SCANCODE_G. رشته‌ای همان‌طور که در https://wiki.libsdl.org/SDL3/SDL_Scancode تعریف شده است. SDL_Disconnect اتصال از نشست RDP را قطع می‌کند. پیش‌فرض SDL_SCANCODE_D. رشته‌ای همان‌طور که در https://wiki.libsdl.org/SDL3/SDL_Scancode تعریف شده است. قالب و مکان: فایل‌های پیکربندی در پیکربندی سراسری سیستم ذخیره می‌شوند. مکان تنظیمات مشترک گواهی عبارت است از: /etc/FreeRDP/certificates.json قالب فایل JSON است گزینه‌های پشتیبانی‌شده: deny JSON boolean رد گواهی در صورتی که بررسی در مخزن SSL سیستم موفقیت‌آمیز نباشد ignore JSON boolean نادیده گرفتن خطاهای گواهی، صرفاً نادیده گرفتن گواهی deny-userconfig JSON boolean اگر بررسی‌ها در پیکربندی سراسری گواهی را تأیید نکنند، از کاربر سؤال پرسیده نشود certificate-db JSON array آرایه‌ای از JSON objects شامل: type JSON string رشته‌ای برای تعیین الگوریتم درهم‌سازی (هش) استفاده‌شده، به عنوان مثال sha256 hash JSON string رشته‌ای از مقادیر صحیح هگزادسیمال نمایانگر هش گواهی، به عنوان مثال 0123456789abcdef پیکربندی سراسری (کلاینت SDL3) (GLOBAL CONFIGURATION (SDL3 client)) مکان پیکربندی کلاینت SDL3 عبارت است از: /etc/FreeRDP/sdl-freerdp.json قالب فایل JSON است گزینه‌های پشتیبانی‌شده: isUserConfigEnabled JSON boolean مجاز یا مسدود کردن پشتیبانی از فایل پیکربندی به ازای هر کاربر. تمام گزینه‌های سطح کاربر از CONFIGURATION FILE نیز می‌توانند در اینجا تنظیم شوند مثال‌ها (EXAMPLES) sdl-freerdp3 connection.rdp /p:Pwd123! /f اتصال در حالت تمام‌صفحه با استفاده از پیکربندی ذخیره‌شدهٔ connection.rdp و گذرواژهٔ Pwd123! sdl-freerdp3 /u:USER /size:50%h /v:rdp.contoso.com اتصال به میزبان rdp.contoso.com با کاربر USER و اندازه‌ای برابر با 50 درصد از ارتفاع. اگر به جای ارتفاع (h)، عرض (w) مانند /size:50%w تنظیم شود. 50 درصد از عرض استفاده می‌شود. sdl-freerdp3 /u:CONTOSO\\JohnDoe /p:Pwd123! /v:rdp.contoso.com اتصال به میزبان rdp.contoso.com با کاربر CONTOSO\\JohnDoe و گذرواژهٔ Pwd123! sdl-freerdp3 /u:JohnDoe /p:Pwd123! /w:1366 /h:768 /v:192.168.1.100:4489 اتصال به میزبان 192.168.1.100 روی درگاه 4489 با کاربر JohnDoe، گذرواژهٔ Pwd123!. عرض صفحه روی 1366 و ارتفاع روی 768 تنظیم شده است sdl-freerdp3 /u:JohnDoe /p:Pwd123! /vmconnect:C824F53E-95D2-46C6-9A18-23A5BB403532 /v:192.168.1.100 برقراری اتصال به میزبان 192.168.1.100 با کاربر JohnDoe، گذرواژهٔ Pwd123! و اتصال به کنسول Hyper-V (استفاده از درگاه 2179، غیرفعال‌سازی مذاکره) با شناسه ماشین مجازی (VMID) C824F53E-95D2-46C6-9A18-23A5BB403532 +clipboard فعال‌سازی بازهدایت کلیپ‌بورد /drive:home,/home/user فعال‌سازی بازهدایت درایو /home/user به عنوان درایو خانه (home) /smartcard: فعال‌سازی بازهدایت کارت هوشمند برای دستگاه device /printer:, فعال‌سازی بازهدایت چاپگر برای چاپگر device با استفاده از درایور driver /serial: فعال‌سازی بازهدایت درگاه سریال برای درگاه device /parallel: فعال‌سازی بازهدایت درگاه موازی برای درگاه device /sound:sys:alsa فعال‌سازی بازهدایت خروجی صوتی با استفاده از دستگاه sys:alsa /microphone:sys:alsa فعال‌سازی تغییرمسیر ورودی صدا با استفاده از دستگاه sys:alsa /multimedia:sys:alsa فعال‌سازی تغییرمسیر چندرسانه‌ای با استفاده از دستگاه sys:alsa /usb:id,dev:054c:0268 فعال‌سازی تغییرمسیر دستگاه USB برای دستگاه مشخص‌شده با 054c:0268 پیوندها (LINKS) http://www.freerdp.com نویسندگان (AUTHORS) تیم FreeRDP freerdp 2026-09-03 sdl-freerdp3(1)