.Dd November 17, 2000
.Dt NETCONFIG 5
.Os
.Sh "نام (NAME)"
.Nm netconfig
.Nd پایگاه داده پیکربندی شبکه
.Sh "خلاصه دستور (SYNOPSIS)"
.Pa /etc/netconfig
.Sh "توضیحات (DESCRIPTION)"
پرونده‌ی
.Nm
فهرستی از
.Dq نام‌های انتقال
را تعریف می‌کند و معناشناسی و پروتکل آن‌ها را شرح می‌دهد.
در
.Fx ،
این پرونده فقط توسط کد کتابخانهٔ RPC استفاده می‌شود.
.Pp
ورودی‌ها دارای قالب زیر هستند:
.Pp
.Ar network_id semantics flags family protoname device libraries
.Pp
ورودی‌ها از فیلدهای زیر تشکیل شده‌اند:
.Bl -tag -width network_id
.It Ar network_id
نام انتقال شرح‌داده‌شده.
.It Ar semantics
معناشناسی انتقال را شرح می‌دهد.
این مقدار می‌تواند یکی از موارد زیر باشد:
.Bl -tag -width tpi_cots_ord -offset indent
.It Sy tpi_clts
انتقال بدون اتصال.
.It Sy tpi_cots
انتقال مبتنی بر اتصال.
.It Sy tpi_cots_ord
انتقال مبتنی بر اتصال و مرتب‌شده.
.It Sy tpi_raw
یک اتصال خام.
.El
.It Ar flags
این فیلد یا خالی است (که با
.Dq Li -
مشخص می‌شود)، یا حاوی یک
.Dq Li v
است، به این معنی که برای تابع
.Xr getnetconfig 3
قابل مشاهده است.
.It Ar family
خانوادهٔ پروتکل لایه انتقال.
در حال حاضر می‌تواند یکی از موارد زیر باشد:
.Bl -tag -width loopback -offset indent
.It Sy inet6
خانوادهٔ پروتکل‌های IPv6
.Pq Dv PF_INET6 .
.It Sy inet
خانوادهٔ پروتکل‌های IPv4
.Pq Dv PF_INET .
.It Sy loopback
خانوادهٔ پروتکل
.Dv PF_LOCAL .
.El
.It Ar protoname
نام پروتکل استفاده‌شده برای این انتقال.
در حال حاضر می‌تواند
.Sy udp ,
.Sy tcp
یا خالی باشد.
.It Ar device
این فیلد در
.Fx
همیشه خالی است.
.It Ar libraries
این فیلد در
.Fx
همیشه خالی است.
.El
.Pp
ترتیب ورودی‌ها در این پرونده مشخص می‌کند که در صورت تطابق با یک نوع شبکهٔ معین، کدام انتقال توسط کد کتابخانهٔ RPC ترجیح داده خواهد شد.
برای نمونه، اگر یک پروندهٔ نمونهٔ پیکربندی شبکه به این صورت باشد:
.Bd -literal -offset indent
udp6       tpi_clts      v     inet6    udp     -       -
tcp6       tpi_cots_ord  v     inet6    tcp     -       -
udp        tpi_clts      v     inet     udp     -       -
tcp        tpi_cots_ord  v     inet     tcp     -       -
rawip      tpi_raw       -     inet      -      -       -
local      tpi_cots_ord  -     loopback  -      -       -
.Ed
.Pp
در این صورت، استفاده از نوع شبکهٔ
.Sy udp
در فراخوانی‌های تابع کتابخانهٔ RPC (به
.Xr rpc 3
مراجعه کنید) باعث می‌شود که کد ابتدا
.Sy udp6
و سپس
.Sy udp
را بیازماید.
.Pp
تابع
.Xr getnetconfig 3
و توابع مرتبط با آن، این پرونده را تجزیه کرده و ساختارهایی با قالب زیر را بازمی‌گردانند:
.Bd -literal
struct netconfig {
    char *nc_netid;              /* شناسه شبکه */
    unsigned long nc_semantics;  /* معناشناسی (به زیر مراجعه کنید) */
    unsigned long nc_flag;       /* پرچم‌ها (به زیر مراجعه کنید) */
    char *nc_protofmly;          /* خانواده پروتکل */
    char *nc_proto;              /* نام پروتکل */
    char *nc_device;             /* نام مسیر دستگاه شبکه (استفاده‌نشده) */
    unsigned long nc_nlookups;   /* تعداد کتابخانه‌های جستجو (استفاده‌نشده) */
    char **nc_lookups;           /* نام‌های کتابخانه‌ها (استفاده‌نشده) */
    unsigned long nc_unused[9];  /* رزرو شده */
};
.Ed
.Sh "فایل‌ها (FILES)"
.Bl -tag -width /etc/netconfig -compact
.It Pa /etc/netconfig
.El
.Sh "همچنین ببینید (SEE ALSO)"
.Xr getnetconfig 3 ,
.Xr getnetpath 3