.\" -*- 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 "WAKEONLAN 1" .TH WAKEONLAN 1 2026-08-10 "perl v5.42.2" "User Contributed Perl 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)" wakeonlan \- اسکریپت Perl برای بیدار کردن رایانه‌ها .SH "خلاصه دستور (SYNOPSIS)" .IX Header "SYNOPSIS" wakeonlan [\-h|\-\-help] [\-v|\-\-version] [\-q|\-\-quiet] [\-n|\-\-dry\-run] [\-i|\-\-ip IP_address] [\-p|\-\-port port] [\-f|\-\-file file_name] [\-d|\-\-delay seconds] [[hardware_address] ...] .SH "توضیحات (DESCRIPTION)" .IX Header "DESCRIPTION" این اسکریپت «بسته‌های جادویی» (\*(Aqmagic packets\*(Aq) را به آداپتورهای اترنت و مادربوردهای با قابلیت wake\-on\-lan ارسال می‌کند تا رایانهٔ مورد نظر را روشن کند. در صورت لزوم، حتماً کارت شبکه (NIC) را به مادربورد متصل کرده و قابلیت WOL را در BIOS فعال کنید. .PP «بستهٔ جادویی» از ۶ بار مقدار 0xFF و سپس ۱۶ بار آدرس سخت‌افزاری کارت شبکه (NIC) تشکیل شده است. این توالی می‌تواند در هر نوع بسته‌ای کپسوله‌سازی شود. این اسکریپت از بسته‌های UDP استفاده می‌کند. .SH "گزینه‌ها (OPTIONS)" .IX Header "OPTIONS" .IP "\fB\-h, \-\-help\fR" 4 .IX Item "-h, --help" مستندات کامل POD را که شامل مثال‌های کاربردی است نمایش می‌دهد. .IP "\fB\-v, \-\-version\fR" 4 .IX Item "-v, --version" نسخهٔ اسکریپت را نمایش می‌دهد. .IP "\fB\-i, \-\-ip=IP_address\fR" 4 .IX Item "-i, --ip=IP_address" آدرس IP مقصد. مگر این‌که جدول‌های ARP ایستا داشته باشید، باید از نوعی آدرس برودکست (آدرس برودکست شبکه‌ای که رایانه در آن قرار دارد یا آدرس برودکست محدود) استفاده کنید. پیش‌فرض: 255.255.255.255 (آدرس برودکست محدود). .IP "\fB\-p, \-\-port=port\fR" 4 .IX Item "-p, --port=port" پورت مقصد. پیش‌فرض: 9 (پورت discard). .IP "\fB\-f, \-\-file=file_name\fR" 4 .IX Item "-f, --file=file_name" فایلی شامل آدرس‌های سخت‌افزاری رایانه‌های قابل بیدار کردن. برای دیدن یک مثال، فایل lab001.wol را در زیردایرکتوری examples بررسی کنید. .IP "\fB\-q, \-\-quiet\fR" 4 .IX Item "-q, --quiet" حالت بی‌صدا. .IP "\fB\-n, \-\-dry\-run\fR" 4 .IX Item "-n, --dry-run" دستورهایی را که قرار است اجرا شوند چاپ می‌کند، اما آن‌ها را اجرا نمی‌کند. .IP "\fB\-d, \-\-delay=seconds\fR" 4 .IX Item "-d, --delay=seconds" تاخیر (به ثانیه) بین ارسال بسته‌های جادویی. می‌تواند کسری از ثانیه باشد (مانند 0.5). .SH "وضعیت خروج (EXIT STATUS)" .IX Header "EXIT STATUS" .IP \fB0\fR 4 .IX Item "0" موفقیت‌آمیز. یا تمام بسته‌های جادویی در صف ارسال شدند، یا اطلاعات راهنما یا نسخه درخواستی نمایش داده شد. .IP \fB1\fR 4 .IX Item "1" گزینه‌های نامعتبر خط فرمان. .IP \fB2\fR 4 .IX Item "2" پورت مقصد پیش‌فرض نامعتبر (به \fB\-p, \-\-port\fR مراجعه کنید). .IP \fB3\fR 4 .IX Item "3" آدرس IP مقصد پیش‌فرض نامعتبر (به \fB\-i, \-\-ip\fR مراجعه کنید). .IP \fB4\fR 4 .IX Item "4" فایل ارائه‌شده به \fB\-f, \-\-file\fR موجود نیست یا یک فایل معمولی یا یک FIFO (لولهٔ نام‌گذاری‌شده) نمی‌باشد. .PP رکوردهای نامعتبر \-\- آدرس‌های سخت‌افزاری، آدرس‌های IP یا پورت‌هایی که اعتبارسنجی آن‌ها ناموفق است \-\- در خروجی خطای استاندارد گزارش شده و نادیده گرفته می‌شوند، و به خودیِ خود وضعیت خروج را تغییر نمی‌دهند: اجرایی که در آن همهٔ رکوردها رد شوند همچنان با وضعیت 0 خارج می‌شود. .PP هر وضعیت خروج غیرصفرِ دیگر نشان‌دهندهٔ یک خطای غیرمنتظره در زمان اجراست، مانند فایلی که باز نمی‌شود یا سوکتی که ایجاد نمی‌شود. این خرابی‌ها همراه با پیامی در خروجی خطای استاندارد گزارش می‌شوند و وضعیت خروج، شمارهٔ خطای سیستم پایه خواهد بود. .SH "مثال‌ها (EXAMPLES)" .IX Header "EXAMPLES" استفاده از آدرس برودکست محدود (255.255.255.255): .PP .Vb 2 \& $ wakeonlan 01:02:03:04:05:06 \& $ wakeonlan 01:02:03:04:05:06 01:02:03:04:05:07 .Ve .PP استفاده از آدرس برودکست یک زیرشبکه: .PP .Vb 1 \& $ wakeonlan \-i 192.168.1.255 01:02:03:04:05:06 .Ve .PP استفاده از یک پورت مقصد دیگر: .PP .Vb 1 \& $ wakeonlan \-i 192.168.1.255 \-p 1234 01:02:03:04:05:06 .Ve .PP استفاده از یک فایل به عنوان منبع آدرس‌های سخت‌افزاری و IP: .PP .Vb 2 \& $ wakeonlan \-f examples/lab001.wol \& $ wakeonlan \-f examples/lab001.wol 01:02:03:04:05:06 .Ve .SH "نویسندگان (AUTHORS)" .IX Header "AUTHORS" José Pedro Oliveira نگهداری و گسترش کد اصلی ایجادشده توسط Ico Doornekamp . .SH "کپی‌رایت و تکثیر (COPYRIGHT)" .IX Header "COPYRIGHT" حق نشر (c) 2000\-2026 متعلق به José Pedro Oliveira است. .PP این یک نرم‌افزار آزاد است. شما می‌توانید آن را تحت پروانهٔ Artistic License 2.0 زبان Perl تغییر داده و توزیع کنید. نسخه‌های تغییریافته باید به‌وضوح مشخص شوند. .SH "همچنین ببینید (SEE ALSO)" .IX Header "SEE ALSO" برای اطلاعات بیشتر در مورد این اسکریپت و فناوری Wakeonlan، صفحهٔ پروژه را در بررسی کنید.