.TH SSH-PING "1" "March 2024" "SSH-TOOLS" "User Commands"
.SH "نام (NAME)"
ssh-ping \- بررسی در دسترس بودن میزبان با استفاده از ssh_config
.SH "خلاصه دستور (SYNOPSIS)"
ssh\-ping [OPTIONS] [user@]hostname
.SH "توضیحات (DESCRIPTION)"
بررسی این‌که آیا میزبان با استفاده از ssh_config در دسترس است یا خیر.
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-4\fR
تنها استفاده از IPv4
.TP
\fB\-6\fR
تنها استفاده از IPv6
.TP
\fB\-c\fR count
توقف پس از ارسال <count> بستهٔ درخواست
.TP
\fB\-C\fR
اتصال به محض پاسخ‌دهی میزبان
.br
و تلاش برای اتصال مجدد پس از پایان نشست SSH (برای نمونه راه‌اندازی مجدد).
.br
همچنین برای دستگاه‌های IDRAC، IPMI، ILO، سوییچ‌ها و غیره
.br
که فاقد یک محیط شل کامل هستند بسیار مفید است.
.br
کلیدهای ترکیبی CTRL+C تلاش‌ها برای اتصال مجدد را متوقف می‌کند.
.TP
\fB\-E\fR
خروج بلافاصله پس از نخستین پینگ موفق
.br
(می‌تواند برای آغاز یک کار دیگر مانند rsync استفاده شود)
.TP
\fB\-F\fR configfile
مشخص کردن یک فایل پیکربندی جایگزین برای هر کاربر.
.br
اگر فایل پیکربندی در خط فرمان مشخص شود،
.br
فایل پیکربندی سراسری سیستم ( \fI\,/etc/ssh/ssh_config\/\fP ) نادیده گرفته خواهد شد.
.br
پیش‌فرض برای فایل پیکربندی کاربری ~/.ssh/config است.
.TP
\fB\-h\fR
نمایش این پیام
.TP
\fB\-i\fR interval
درنگ به مدت <interval> ثانیه میان ارسال هر درخواست.
.br
مقدار پیش‌فرض ۱ ثانیه است.
.TP
\fB\-l\fR user
تلاش برای ورود با نام کاربری <user>. مقدار پیش‌فرض، مقدار کنونی $USER است.
.TP
\fB\-D\fR
چاپ برچسب زمانی (زمان یونیکس + میکروثانیه همانند gettimeofday) پیش از هر خط
.TP
\fB\-H\fR
چاپ برچسب زمانی (خوانا برای انسان) پیش از هر خط
.TP
\fB\-W\fR timeout
زمان انتظار برای دریافت پاسخ، به ثانیه
.TP
\fB\-p\fR port
درگاه (پورت) برای اتصال به میزبان دوردست.
.br
این مورد می‌تواند در فایل پیکربندی بر اساس هر میزبان مشخص شود.
.TP
\fB\-q\fR
خروجی بی‌صدا.
.br
هیچ چیزی به جز خطوط خلاصه در زمان شروع و هنگام پایان نمایش داده نمی‌شود
.TP
\fB\-n\fR
بدون رنگ.
.br
(برای نمونه برای پایانه‌های سیاه روی سفید)
.TP
\fB\-v\fR
خروجی با جزئیات بیشتر
.TP
\fB\--version\fR
نمایش اطلاعات نگارش
.SH "تکمیل تب (TAB COMPLETIONS)"
اوبونتو (و شاید توزیع‌های دیگر) به طور پیش‌فرض
.br
تکمیل شل را برای ssh ارائه می‌دهند که می‌تواند مورد استفاده قرار گیرد:
.TP
\fBBash\fR
complete \fB\-F\fR _known_hosts ssh\-ping
.TP
\fBZsh\fR
compdef _ssh_hosts ssh\-ping
.TP
\fBFish\fR
complete \fB\-c\fR ssh\-ping \fB\-a\fR "(__fish_print_hostnames)"
.SH "محیط (ENVIRONMENT)"
.TP
SSH_PING_NO_COLORS
در صورت تنظیم، هیچ رنگی نمایش داده نمی‌شود (مشابه \fB\-n\fR)
.SH "وضعیت خروج (EXIT STATUS)"
.TP
0
هیچ درخواستی از دست نرفت
.TP
1
بیش از ۱ درخواست از دست رفت
.TP
2
تمام درخواست‌ها از دست رفتند
.SH "مثال‌ها (EXAMPLES)"
.TP
ssh\-ping \fB\-E\fR hostname && echo "First successful ping. Starting rsync..."
.TP
ssh\-ping \fB\-q\fR \fB\-c\fR 1 hostname >/dev/null && echo "Host is up!"
.TP
ssh\-ping \fB\-q\fR \fB\-c\fR 1 hostname >/dev/null || echo "Host is down!"
.TP
SSH_PING_NO_COLORS=true ssh\-ping \fB\-c\fR 1 hostname