'\" t
.TH "NEWUIDMAP" "1" "مه ۲۰۲۵" "shadow" "دستورات کاربر"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.SH "نام (NAME)"
newuidmap \- تنظیم نگاشت شناسههای کاربری (UID) در فضای نام کاربر
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBnewuidmap\fR\ 'u
\fBnewuidmap\fR \fIpid\fR \fIuid\fR \fIloweruid\fR \fIcount\fR [\fIuid\fR\ \fIloweruid\fR\ \fIcount\fR\ [\ \fI\&.\&.\&.\fR\ ]]
.SH "توضیحات (DESCRIPTION)"
دستور \fBnewuidmap\fR نگاشت شناسههای UID را برای فرآیندی که در یک فضای نام کاربری (user namespace) اجرا میشود تنظیم میکند.
.PP
دستور
\fBnewuidmap\fR
فایل
/proc/[pid]/uid_map
را بر اساس آرگومان‌های خط فرمان خود و UIDهای مجاز تنظیم می‌کند. تفویض Subuid را می‌توان از طریق
/etc/subuid
یا از طریق ماژول پیکربندی‌شده NSS subid مدیریت کرد. این گزینه‌ها ناسازگار با یکدیگر (mutually exclusive) هستند.
.PP
توجه داشته باشید که کاربر ریشه (root) نیز از الزام داشتن یک مدخل معتبر در
/etc/subuid
مستثنی نیست.
.PP
پس از آرگومان pid، دستور
\fBnewuidmap\fR
مجموعه‌هایی از ۳ عدد صحیح را انتظار دارد:
.PP
uid
.RS 4
شروع محدوده UIDها در داخل فضای نام کاربری.
.RE
.PP
loweruid
.RS 4
شروع محدوده UIDها در خارج از فضای نام کاربری.
.RE
.PP
count
.RS 4
طول محدوده‌ها (هم در داخل و هم در خارج فضای نام کاربری).
.RE
.PP
دستور
\fBnewuidmap\fR
پیش از تنظیم
/proc/[pid]/uid_map
بررسی و تایید می‌کند که فراخواننده، مالک فرآیند مشخص‌شده توسط
\fBpid\fR
است و برای هر یک از مجموعه‌های بالا، تک‌تک UIDها در محدوده [loweruid, loweruid+count) طبق
/etc/subuid
برای فراخواننده مجاز هستند.
.PP
توجه داشته باشید که newuidmap برای یک فرآیند معین تنها یک بار قابل استفاده است.
.PP
به‌جای شناسه فرآیند (pid) عددی، آرگومان نخست می‌تواند به صورت
\fIfd:N\fR
مشخص شود، که در آن عدد صحیح N شماره توصیف‌گر فایل (file descriptor) فرآیند فراخواننده برای دایرکتوری
/proc/[pid]
است. در این حالت،
\fBnewuidmap\fR
از
openat(2)
برای باز کردن فایل
uid_map
در آن دایرکتوری استفاده می‌کند تا از شرایط مسابقه TOCTTOU در صورت خاتمه فرآیند و استفاده مجدد فوری از pid جلوگیری شود.
.SH "گزینه‌ها (OPTIONS)"
.PP
در حال حاضر هیچ گزینه‌ای برای دستور
\fBnewuidmap\fR
وجود ندارد.
.SH "فایل‌ها (FILES)"
.PP
/etc/subuid
.RS 4
فهرست شناسه‌های کاربری فرعی (subordinate user IDs) کاربر.
.RE
.PP
/proc/[pid]/uid_map
.RS 4
نگاشت UIDها بین فضاهای نام کاربری.
.RE
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBlogin.defs\fR(5),
\fBnewusers\fR(8),
\fBsubuid\fR(5),
\fBuseradd\fR(8),
\fBusermod\fR(8),
\fBuserdel\fR(8)\&.