نام (NAME)

wakeonlan - اسکریپت Perl برای بیدار کردن رایانه‌ها

خلاصه دستور (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] ...]

توضیحات (DESCRIPTION)

این اسکریپت «بسته‌های جادویی» ('magic packets') را به آداپتورهای اترنت و مادربوردهای با قابلیت wake-on-lan ارسال می‌کند تا رایانهٔ مورد نظر را روشن کند. در صورت لزوم، حتماً کارت شبکه (NIC) را به مادربورد متصل کرده و قابلیت WOL را در BIOS فعال کنید.

«بستهٔ جادویی» از ۶ بار مقدار 0xFF و سپس ۱۶ بار آدرس سخت‌افزاری کارت شبکه (NIC) تشکیل شده است. این توالی می‌تواند در هر نوع بسته‌ای کپسوله‌سازی شود. این اسکریپت از بسته‌های UDP استفاده می‌کند.

گزینه‌ها (OPTIONS)

-h, --help

مستندات کامل POD را که شامل مثال‌های کاربردی است نمایش می‌دهد.

-v, --version

نسخهٔ اسکریپت را نمایش می‌دهد.

-i, --ip=IP_address

آدرس IP مقصد. مگر این‌که جدول‌های ARP ایستا داشته باشید، باید از نوعی آدرس برودکست (آدرس برودکست شبکه‌ای که رایانه در آن قرار دارد یا آدرس برودکست محدود) استفاده کنید. پیش‌فرض: 255.255.255.255 (آدرس برودکست محدود).

-p, --port=port

پورت مقصد. پیش‌فرض: 9 (پورت discard).

-f, --file=file_name

فایلی شامل آدرس‌های سخت‌افزاری رایانه‌های قابل بیدار کردن. برای دیدن یک مثال، فایل lab001.wol را در زیردایرکتوری examples بررسی کنید.

-q, --quiet

حالت بی‌صدا.

-n, --dry-run

دستورهایی را که قرار است اجرا شوند چاپ می‌کند، اما آن‌ها را اجرا نمی‌کند.

-d, --delay=seconds

تاخیر (به ثانیه) بین ارسال بسته‌های جادویی. می‌تواند کسری از ثانیه باشد (مانند 0.5).

وضعیت خروج (EXIT STATUS)

0

موفقیت‌آمیز. یا تمام بسته‌های جادویی در صف ارسال شدند، یا اطلاعات راهنما یا نسخه درخواستی نمایش داده شد.

1

گزینه‌های نامعتبر خط فرمان.

2

پورت مقصد پیش‌فرض نامعتبر (به -p, --port مراجعه کنید).

3

آدرس IP مقصد پیش‌فرض نامعتبر (به -i, --ip مراجعه کنید).

4

فایل ارائه‌شده به -f, --file موجود نیست یا یک فایل معمولی یا یک FIFO (لولهٔ نام‌گذاری‌شده) نمی‌باشد.

رکوردهای نامعتبر -- آدرس‌های سخت‌افزاری، آدرس‌های IP یا پورت‌هایی که اعتبارسنجی آن‌ها ناموفق است -- در خروجی خطای استاندارد گزارش شده و نادیده گرفته می‌شوند، و به خودیِ خود وضعیت خروج را تغییر نمی‌دهند: اجرایی که در آن همهٔ رکوردها رد شوند همچنان با وضعیت 0 خارج می‌شود.

هر وضعیت خروج غیرصفرِ دیگر نشان‌دهندهٔ یک خطای غیرمنتظره در زمان اجراست، مانند فایلی که باز نمی‌شود یا سوکتی که ایجاد نمی‌شود. این خرابی‌ها همراه با پیامی در خروجی خطای استاندارد گزارش می‌شوند و وضعیت خروج، شمارهٔ خطای سیستم پایه خواهد بود.

مثال‌ها (EXAMPLES)

استفاده از آدرس برودکست محدود (255.255.255.255):

$ wakeonlan 01:02:03:04:05:06
$ wakeonlan 01:02:03:04:05:06 01:02:03:04:05:07

استفاده از آدرس برودکست یک زیرشبکه:

$ wakeonlan -i 192.168.1.255 01:02:03:04:05:06

استفاده از یک پورت مقصد دیگر:

$ wakeonlan -i 192.168.1.255 -p 1234 01:02:03:04:05:06

استفاده از یک فایل به عنوان منبع آدرس‌های سخت‌افزاری و IP:

$ wakeonlan -f examples/lab001.wol
$ wakeonlan -f examples/lab001.wol 01:02:03:04:05:06

نویسندگان (AUTHORS)

José Pedro Oliveira <jose.p.oliveira.oss@gmail.com> نگهداری و گسترش کد اصلی ایجادشده توسط Ico Doornekamp <ico@edd.dhs.org>.

کپی‌رایت و تکثیر (COPYRIGHT)

حق نشر (c) 2000-2026 متعلق به José Pedro Oliveira است.

این یک نرم‌افزار آزاد است. شما می‌توانید آن را تحت پروانهٔ Artistic License 2.0 زبان Perl تغییر داده و توزیع کنید. نسخه‌های تغییریافته باید به‌وضوح مشخص شوند.

همچنین ببینید (SEE ALSO)

برای اطلاعات بیشتر در مورد این اسکریپت و فناوری Wakeonlan، صفحهٔ پروژه را در https://github.com/jpoliv/wakeonlan بررسی کنید.