'\" t
.\"
.\" Copyright (c) 2000 Silicon Graphics, Inc.  All Rights Reserved.
.\"
.\" This program is free software; you can redistribute it and/or modify it
.\" under the terms of the GNU General Public License as published by the
.\" Free Software Foundation; either version 2 of the License, or (at your
.\" option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful, but
.\" WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
.\" or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
.\" for more details.
.\"
.\"
.TH PMHOSTNAME 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
pmhostname \- گزارش نام میزبان
.SH "خلاصه دستور (SYNOPSIS)"
\fBpmhostname\fR
[\f3\-D\f1 \f2debug\f1]
[\fB\-?\fR]
[\fIhostname\fR]
.SH "توضیحات (DESCRIPTION)"
دستور
.B pmhostname
نام میزبان
.I hostname
را همان‌طور که توسط
.BR gethostbyname (3)
بازگردانده می‌شود، گزارش می‌دهد.
.PP
اگر
.I hostname
مشخص نشده باشد، نام میزبان محلی با استفاده از
.BR gethostname (2)
دریافت شده و سپس به
.BR gethostbyname (3)
ارسال می‌شود.
.PP
دستور
.B pmhostname
سرویسی برای اسکریپت‌های پوسته ارائه می‌دهد که منطق پیشین مورد استفاده در برنامه‌های Performance Co-Pilot را هنگام تلاش برای تعیین نام رسمی یک میزبان شبیه‌سازی می‌کند. برنامه‌های PCP دیگر از روش‌های اکتشافی مبتنی بر DNS استفاده نمی‌کنند، بنابراین این دستور
.IR "منسوخ شده" " است."
.PP
اگر
.BR gethostbyname (3)
با شکست مواجه شود، نام میزبان ورودی (خواه
.I hostname
باشد یا نتیجه حاصل از فراخوانی
.BR gethostname (2))
گزارش می‌شود.
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های خط فرمان موجود عبارتند از:
.TP 5
\fB\-?\fR, \fB\-\-help\fR
نمایش پیام راهنما و خروج.
.SH "محیط PCP (PCP ENVIRONMENT)"
متغیرهای محیطی با پیشوند \fBPCP_\fP برای تعیین پارامترهای نام فایل‌ها و دایرکتوری‌های مورد استفاده توسط PCP به کار می‌روند. در هر نصب، فایل \fI/etc/pcp.conf\fP حاوی مقادیر محلی برای این متغیرها است. متغیر \fB$PCP_CONF\fP می‌تواند برای تعیین یک فایل پیکربندی جایگزین استفاده شود، همان‌طور که در \fBpcp.conf\fP(5) شرح داده شده است.
.SH "گزینه‌های اشکال‌زدایی (DEBUGGING OPTIONS)"
گزینه
.B \-D
یا
.B \-\-debug
خروجی اطلاعات تشخیصی اضافی را در
.I stderr
جهت کمک به عیب‌یابی و ریشه‌یابی مشکلات فعال می‌کند؛ هرچند این اطلاعات گاهی پیچیده بوده و در درجه اول به جای کاربران نهایی، برای راهنمایی توسعه‌دهندگان در نظر گرفته شده است.
.I debug
فهرستی از گزینه‌های اشکال‌زدایی است که با کاما از هم جدا شده‌اند؛ از
.BR pmdbg (1)
همراه با گزینه
.B \-l
برای دریافت فهرستی از گزینه‌های اشکال‌زدایی موجود و معانی آن‌ها استفاده کنید.
.PP
گزینه‌های اشکال‌زدایی مختص
.B pmhostname
به شرح زیر هستند:
.TS
box;
lf(B) | lf(B)
lf(B) | lxf(R) .
گزینه	توضیحات
_
appl0	T{
اطلاعات تشخیصی دقیق، برای نمونه نتیجه فراخوانی \fBgethostname\fP(2)
و توابع PMAPI
T}
.TE
.SH "همچنین ببینید (SEE ALSO)"
.BR nslookup (1),
.BR gethostname (2),
.BR gethostbyname (3),
.BR pcp.conf (5),
.BR pcp.env (5)
و
.BR resolver (5).