'\" t
.\"     Title: lslogins
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-09-02
.\"    Manual: User Commands
.\"    Source: util-linux 2.42.3
.\"  Language: Persian
.\"
.TH "LSLOGINS" "1" "2026-09-02" "util\-linux 2.42.3" "User Commands"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "نام (NAME)"
lslogins \- نمایش اطلاعات حساب‌های کاربری و مشخصات ورود به سیستم
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBlslogins\fP [options] [\fB\-s\fP|\fB\-u\fP[\fB=\fP\fIUID\fP]] [\fB\-g\fP \fIgroups\fP] [\fB\-l\fP \fIlogins\fP] [\fIusername\fP]
.SH "توضیحات (DESCRIPTION)"
.sp
بررسی گزارش‌های wtmp و btmp، فایل \fI/etc/shadow\fP (در صورت نیاز) و \fI/passwd\fP و نمایش داده‌های مورد نظر.
.sp
آرگومان اختیاری \fIusername\fP، دستور \fBlslogins\fP را وادار می‌کند تا تمام جزئیات موجود را تنها برای کاربر مشخص‌شده چاپ کند. در این حالت، قالب خروجی با حالت \fB\-l\fP یا \fB\-g\fP متفاوت است و نام کاربری ناشناخته (\fIusername\fP) به عنوان یک خطا گزارش می‌شود.
.sp
عملکرد پیش‌فرض، فهرست کردن اطلاعات تمام کاربران موجود در سیستم است.
.SH "گزینه‌ها (OPTIONS)"
.sp
آرگومان‌های اجباری برای گزینه‌های طولانی، برای گزینه‌های کوتاه نیز اجباری هستند.
.sp
\fB\-a\fP, \fB\-\-acc\-expiration\fP
.RS 4
نمایش داده‌های مربوط به تاریخ آخرین تغییر گذرواژه و تاریخ انقضای حساب کاربری (برای اطلاعات بیشتر به \fBshadow\fP(5) مراجعه کنید). (نیازمند دسترسی ریشه/root است.)
.RE
.sp
\fB\-\-btmp\-file\fP \fIpath\fP
.RS 4
مسیر جایگزین برای btmp.
.RE
.sp
\fB\-c\fP, \fB\-\-colon\-separate\fP
.RS 4
جداسازی اطلاعات مربوط به هر کاربر با دونقطه (:) به‌جای خط جدید.
.RE
.sp
\fB\-e\fP, \fB\-\-export\fP
.RS 4
خروجی دادن داده‌ها در قالب NAME=VALUE. گزینهٔ \fB\-\-shell\fP را نیز ببینید.
.RE
.sp
\fB\-f\fP, \fB\-\-failed\fP
.RS 4
نمایش داده‌های مربوط به آخرین تلاش‌های ناموفق ورود کاربران.
.RE
.sp
\fB\-G\fP, \fB\-\-supp\-groups\fP
.RS 4
نمایش اطلاعات دربارهٔ گروه‌های تکمیلی (supplementary groups).
.RE
.sp
\fB\-g\fP, \fB\-\-groups\fP \fIgroups\fP
.RS 4
تنها نمایش داده‌های کاربرانی که متعلق به \fIgroups\fP هستند. بیش از یک گروه را می‌توان مشخص کرد؛ فهرست باید با کاما جدا شده باشد. نام‌های گروه ناشناخته نادیده گرفته می‌شوند.
.sp
توجه داشته باشید که رابطه بین کاربر و گروه ممکن است برای گروه اصلی دیده نشود، در صورتی که کاربر به صراحت به عنوان عضو گروه مشخص نشده باشد (برای نمونه در \fI/etc/group\fP). اگر دستور \fBlslogins\fP برای گروه‌ها جستجو کند، تنها از پایگاه‌دادهٔ گروه‌ها استفاده می‌کند و پایگاه‌دادهٔ کاربر با GID اصلی اصلاً استفاده نمی‌شود.
.RE
.sp
\fB\-L\fP, \fB\-\-last\fP
.RS 4
نمایش داده‌های حاوی اطلاعات دربارهٔ آخرین نشست‌های ورود کاربران.
.RE
.sp
\fB\-l\fP, \fB\-\-logins\fP \fIlogins\fP
.RS 4
تنها نمایش داده‌های کاربرانی که ورود آن‌ها در \fIlogins\fP مشخص شده است (نام‌های کاربری یا شناسه‌های کاربری UID). بیش از یک شناسهٔ ورود را می‌توان مشخص کرد؛ فهرست باید با کاما جدا شود. نام‌های ورود ناشناخته نادیده گرفته می‌شوند.
.RE
.sp
\fB\-n\fP, \fB\-\-newline\fP
.RS 4
نمایش هر بخش از اطلاعات در یک خط جداگانه.
.RE
.sp
\fB\-\-noheadings\fP
.RS 4
سربرگ ستون‌ها چاپ نشود.
.RE
.sp
\fB\-\-notruncate\fP
.RS 4
خروجی کوتاه/بریده نشود.
.RE
.sp
\fB\-o\fP, \fB\-\-output\fP \fIlist\fP
.RS 4
مشخص کردن ستون‌های خروجی برای چاپ. در صورتی که \fIlist\fP در قالب \fI+list\fP مشخص شود، فهرست پیش‌فرض ستون‌ها می‌تواند گسترش یابد.
.RE
.sp
\fB\-\-output\-all\fP
.RS 4
چاپ تمام ستون‌های موجود. برای دریافت فهرست تمام ستون‌های پشتیبانی‌شده از \fB\-\-list\-columns\fP استفاده کنید.
.RE
.sp
\fB\-H\fP, \fB\-\-list\-columns\fP
.RS 4
فهرست کردن ستون‌هایی که می‌توان با گزینهٔ \fB\-\-output\fP تعیین کرد.
می‌تواند همراه با \fB\-\-json\fP یا \fB\-\-raw\fP برای دریافت فهرست در قالبی خوانا برای ماشین استفاده شود.
.RE
.sp
\fB\-p\fP, \fB\-\-pwd\fP
.RS 4
نمایش اطلاعات مربوط به ورود با گذرواژه (همچنین \fB\-afL\fP را ببینید).
.RE
.sp
\fB\-r\fP, \fB\-\-raw\fP
.RS 4
خروجی خام (بدون ستون‌بندی).
.RE
.sp
\fB\-J\fP, \fB\-\-json\fP
.RS 4
خروجی در قالب JSON.
.RE
.sp
\fB\-s\fP, \fB\-\-system\-accs\fP
.RS 4
نمایش حساب‌های سیستمی. این‌ها به‌طور پیش‌فرض تمام حساب‌های با UID بین ۱۰۱ تا ۹۹۹ (شامل هر دو) هستند، به استثنای nobody یا nfsnobody (با UID ۶۵۵۳۴). این مقدار پیش‌فرض ثابت می‌تواند با پارامترهای \fBSYS_UID_MIN\fP و \fBSYS_UID_MAX\fP در فایل \fI/etc/login.defs\fP بازنویسی شود.
.RE
.sp
\fB\-\-time\-format\fP \fItype\fP
.RS 4
نمایش تاریخ‌ها در قالب short (کوتاه)، full (کامل) یا iso. مقدار پیش‌فرض short است؛ این قالب زمانی به‌گونه‌ای طراحی شده که از نظر فضا بهینه و برای انسان خوانا باشد.
.RE
.sp
\fB\-u\fP, \fB\-\-user\-accs\fP
.RS 4
نمایش حساب‌های کاربری عادی. این‌ها به‌طور پیش‌فرض تمام حساب‌های با UID بالاتر از ۱۰۰۰ (شامل ۱۰۰۰) هستند، به استثنای nobody یا nfsnobody (با UID ۶۵۵۳۴). این مقدار پیش‌فرض ثابت می‌تواند با پارامترهای \fBUID_MIN\fP و \fBUID_MAX\fP در فایل \fI/etc/login.defs\fP بازنویسی شود.
.RE
.sp
\fB\-h\fP, \fB\-\-help\fP
.RS 4
نمایش متن راهنما و خروج.
.RE
.sp
\fB\-V\fP, \fB\-\-version\fP
.RS 4
نمایش نسخه و خروج.
.RE
.sp
\fB\-\-wtmp\-file\fP \fIpath\fP
.RS 4
مسیر جایگزین برای wtmp.
.RE
.sp
\fB\-\-lastlog\-file\fP \fIpath\fP
.RS 4
مسیر جایگزین برای \fBlastlog\fP(8).
.RE
.sp
\fB\-y\fP, \fB\-\-shell\fP
.RS 4
نام ستون تغییر خواهد کرد تا تنها شامل نویسه‌های مجاز برای شناسه‌های متغیر پوسته باشد. این قابلیت، برای نمونه، همراه با \fB\-\-export\fP قابل استفاده است. توجه داشته باشید که این ویژگی در نسخهٔ 2.37 به‌طور خودکار برای \fB\-\-export\fP فعال شده بود، اما به دلیل مشکلات سازگاری، اکنون درخواست این رفتار با \fB\-\-shell\fP لازم است.
.RE
.sp
\fB\-Z\fP, \fB\-\-context\fP
.RS 4
نمایش بافتار امنیتی (security context) کاربران.
.RE
.sp
\fB\-z\fP, \fB\-\-print0\fP
.RS 4
جداسازی ورودی‌های کاربر با نویسهٔ null (پوچ)، به‌جای خط جدید.
.RE
.SH "وضعیت خروج (EXIT STATUS)"
.sp
0
.RS 4
در صورت موفقیت (OK)،
.RE
.sp
1
.RS 4
در صورت مشخص شدن آرگومان‌های نادرست،
.RE
.sp
2
.RS 4
در صورت وقوع خطای جدی (برای نمونه خرابی گزارش لاگ).
.RE
.SH "نکات (NOTES)"
.sp
آستانه‌های پیش‌فرض UID از فایل \fI/etc/login.defs\fP خوانده می‌شوند.
.SS "وضعیت گذرواژه (Password status)"
.sp
چندین فیلد وضعیت گذرواژه را توصیف می‌کنند.
.sp
\fB"Password is locked"\fP
.RS 4
گذرواژه دارای پیشوند \*(Aq!!\*(Aq است و کاربر با وجود تنظیم بودن یا خالی بودن گذرواژه نمی‌تواند وارد سیستم شود. این مورد برای حساب‌های کاربری جدید بدون گذرواژهٔ تنظیم‌شده رایج است.
.RE
.sp
\fB"Password not required (empty)"\fP
.RS 4
گذرواژه تنظیم نشده است (هش وجود ندارد)؛ این مورد برای حساب‌های سیستمی قفل‌شده رایج است. عدم نیاز به گذرواژه به این معنی نیست که کاربر می‌تواند بدون گذرواژه وارد سیستم شود؛ بلکه این موضوع به وضعیت قفل بودن گذرواژه بستگی دارد.
.RE
.sp
\fB"Login by password disabled"\fP
.RS 4
مقدار \*(Aqyes\*(Aq به این معنی است که گذرواژهٔ معتبری وجود ندارد. هش گذرواژه موجود نیست، یا روش درهم‌سازی (هش) ناشناخته است یا شامل نویسه‌های نامعتبر است.
.RE
.SH "محیط (ENVIRONMENT)"
.sp
\fBLIBSMARTCOLS_DEBUG\fP=all
.RS 4
خروجی اشکال‌زدایی libsmartcols را فعال می‌کند.
.RE
.sp
\fBLIBSMARTCOLS_DEBUG_PADDING\fP=on
.RS 4
استفاده از نویسه‌های فاصله‌گذاری مرئی.
.RE
.sp
\fBLIBSMARTCOLS_JSON\fP=compact|lines
.RS 4
قالب خروجی JSON را هنگام استفاده از \fB\-\-json\fP کنترل می‌کند. مقادیر پشتیبانی‌شده عبارتند از \fBcompact\fP برای خروجی JSON با کمترین فضای خالی، و \fBlines\fP برای قالب JSON Lines (یک شیء JSON در هر خط). اگر مقداردهی نشده باشد یا روی هر مقدار دیگری تنظیم شود، از JSON با فرمت‌بندی خوانا (pretty\-printed) استفاده می‌شود.
.RE
.SH "تاریخچه (HISTORY)"
.sp
ابزار \fBlslogins\fP از ابزار \fBlogins\fP الهام گرفته شده است که اولین بار در FreeBSD 4.10 ظاهر شد.
.SH "نویسندگان (AUTHORS)"
.sp
.MTO "ooprala\(atredhat.com" "Ondrej Oprala" ","
.MTO "kzak\(atredhat.com" "Karel Zak" ""
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBgroup\fP(5),
\fBpasswd\fP(5),
\fBshadow\fP(5),
\fButmp\fP(5)
.SH "گزارش باگ‌ها (REPORTING BUGS)"
.sp
برای گزارش باگ‌ها، از \c
.URL "https://github.com/util\-linux/util\-linux/issues" "سامانه پیگیری مشکلات" "."
.SH "در دسترس بودن (AVAILABILITY)"
.sp
دستور \fBlslogins\fP بخشی از بستهٔ util\-linux است که می‌تواند از \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux" "بایگانی هسته لینوکس" "."
دریافت شود.