'\" t
.\"     Title: subuid
.\"    Author: Eric Biederman
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 07/30/2026
.\"    Manual: قالب‌های فایل و فایل‌های پیکربندی
.\"    Source: shadow-utils 4.20.0
.\"  Language: Persian
.\"
.TH "SUBUID" "5" "07/30/2026" "shadow\-utils 4\&.20\&.0" "قالب‌های فایل و فایل‌های پیکربندی"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
subuid \- پرونده شناسههای کاربری فرعی
.SH "توضیحات (DESCRIPTION)"
.PP
پرونده
\fBsubuid\fR
به یک شناسه کاربری مجوز می‌دهد تا محدوده‌هایی از شناسه‌های کاربری را از فضای نام خود به فضاهای نام فرزند نگاشت کند\&.
.PP
تفویض شناسه‌های کاربری فرعی (subordinate uids) را می‌توان از طریق فیلد
\fIsubid\fR
در فایل
/etc/nsswitch\&.conf
پیکربندی کرد\&. تنها یک مقدار می‌تواند به عنوان منبع تفویض تعیین شود\&. تنظیم این فیلد روی
\fIfiles\fR
تفویض شناسه‌های کاربری را به
/etc/subuid
پیکربندی می‌کند\&. تنظیم هر مقدار دیگری باعث می‌شود این تفویض به عنوان یک افزونه با نامی به فرم
\fIlibsubid_$value\&.so\fR
در نظر گرفته شود\&. اگر مقدار یا افزونه مفقود باشد، تفویض شناسه‌های کاربری فرعی به حالت
\fIfiles\fR
بازمی‌گردد\&.
.PP
توجه داشته باشید که
\fBnewusers\fR،
\fBuseradd\fR
و
\fBusermod\fR
تنها در صورتی مدخل‌هایی در
/etc/subuid
ایجاد خواهند کرد که تفویض subid از طریق پرونده‌های subid مدیریت شود\&.
.SH "تفویض محلی شناسه‌های فرعی (LOCAL SUBORDINATE DELEGATION)"
.PP
هر خط در
/etc/subuid
شامل یک نام کاربری و محدوده‌ای از شناسه‌های کاربری فرعی است که آن کاربر مجاز به استفاده از آن‌ها است\&. این مورد با سه فیلد مشخص می‌شود که با دونقطه (\(lq:\(rq) از یکدیگر جدا شده‌اند\&. این فیلدها عبارتند از:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
نام ورود (login name) یا UID
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
شناسه کاربری فرعی عددی
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
تعداد شناسه‌های کاربری فرعی عددی
.RE
.PP
این فایل شناسه‌های کاربری‌ای را مشخص می‌کند که کاربران عادی می‌توانند با استفاده از دستور
\fBnewuidmap\fR
جهت پیکربندی نگاشت uid در یک فضای نام کاربری از آن‌ها استفاده کنند\&.
.PP
می‌توان چندین محدوده را برای هر کاربر مشخص کرد\&.
.PP
هنگامی که تعداد زیادی ورودی (10000\-100000 یا بیشتر) در
/etc/subuid
تعریف شده باشد، افت کارایی در تجزیه فایل محسوس خواهد شد\&. در این حالت توصیه می‌شود به جای نام‌های کاربری از UIDها استفاده شود\&. بنچمارک‌ها نشان داده‌اند که این کار سرعت را تا 20 برابر افزایش می‌دهد\&.
.SH "فایل‌ها (FILES)"
.PP
/etc/subuid
.RS 4
شناسه‌های کاربری فرعی به ازای هر کاربر\&.
.RE
.PP
/etc/subuid\-
.RS 4
فایل پشتیبان برای /etc/subuid\&.
.RE
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBlogin.defs\fR(5),
\fBnewgidmap\fR(1),
\fBnewuidmap\fR(1),
\fBnewusers\fR(8),
\fBsubgid\fR(5),
\fBuseradd\fR(8),
\fBuserdel\fR(8),
\fBusermod\fR(8),
\fBuser_namespaces\fR(7)\&.