'\" t
.\"     Title: bits
.\"    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 "BITS" "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)"
bits \- ابزار بررسی و کار با مقادیر بیتی
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBbits\fP [\fB\-h\fP] [\fB\-V\fP] [\fB\-w\fP \fInumber\fP] [\fImode\fP] [\fImask\fP|\fIlist\fP].\|.\|.
.SH "توضیحات (DESCRIPTION)"
.sp
ابزار \fBbits\fP میان ماسک‌های بیتی و فهرست‌های بیتی تبدیل انجام می‌دهد.
این ابزار از ترکیب چندین ماسک یا فهرست با استفاده از عملیات بیتی پشتیبانی می‌کند.
.SH "آرگومان‌های موقعیتی (POSITIONAL ARGUMENTS)"
.sp
\fImask\fP
.RS 4
مجموعه‌ای از بیت‌ها که به‌صورت یک مقدار ماسک هگزادسیمال مشخص شده‌اند
(برای نمونه: \fB0xeec2\fP).
.RE
.sp
\fIlist\fP
.RS 4
مجموعه‌ای از بیت‌ها که به‌صورت فهرستی از شناسه‌های بیت جداشده با کاما مشخص شده‌اند
(برای نمونه: \fB1,5,29,32\fP).
.RE
.sp
اگر هیچ آرگومانی مشخص نشود، مجموعه‌های بیت از ورودی استاندارد، یک گروه در هر خط خوانده خواهند شد.
.sp
شناسه‌های متوالی را می‌توان به‌صورت بازه‌ها فشرده کرد
(برای نمونه: \fB5,6,7,8,9,10\fP \(-> \fB5\-10\fP).
.sp
به‌صورت اختیاری، اگر یک آرگومان با یک کاما آغاز شود، به‌صورت یک ماسک هگزادسیمال تکی که به گروه‌های ۳۲ بیتی تقسیم شده است تجزیه خواهد شد
(برای نمونه: \fB,00014000,00000000,00020000\fP \(-> \fB17,78,80\fP).
.sp
به‌طور پیش‌فرض، تمام گروه‌ها با یکدیگر OR بیتی می‌شوند. اگر گروهی دارای یکی از پیشوندهای \fB&\fP، \fB^\fP یا \fB~\fP باشد، با استفاده از یک عملیات باینری متفاوت با ماسک حاصل ترکیب خواهد شد:
.sp
\fB&\fP\fImask\fP|\fB&\fP\fIlist\fP
.RS 4
گروه با یک عملیات AND باینری ترکیب خواهد شد.
بدین معنا که: تمام بیت‌هایی که در گروه برابر با ۱ بوده و در گروه‌های ترکیب‌شده تا اینجا نیز ۱ هستند، به‌صورت ۱ حفظ می‌شوند. تمام بیت‌های دیگر به ۰ بازنشانی خواهند شد.
.RE
.sp
\fB^\fP\fImask\fP|\fB^\fP\fIlist\fP
.RS 4
گروه با یک عملیات XOR باینری ترکیب خواهد شد.
بدین معنا که: تمام بیت‌هایی که در گروه ۱ و در گروه‌های ترکیب‌شده تا اینجا ۰ هستند (یا برعکس)، برابر با ۱ قرار خواهند گرفت.
بیت‌هایی که هر دو ۱ یا هر دو ۰ هستند، به ۰ بازنشانی می‌شوند.
.RE
.sp
\fB~\fP\fImask\fP|\fB~\fP\fIlist\fP
.RS 4
تمام بیت‌هایی که در گروه برابر با ۱ هستند، در گروه‌های ترکیب‌شده تا اینجا پاک (به ۰ بازنشانی) خواهند شد.
.RE
.SH "گزینه‌ها (OPTIONS)"
.sp
\fB\-w\fP \fInumber\fP, \fB\-\-width\fP \fInumber\fP
.RS 4
حداکثر تعداد بیت‌ها در ماسک‌های مدیریت‌شده توسط \fBbits\fP.
مقدار پیش‌فرض \fB8192\fP است. هر بیتی بزرگ‌تر از این عدد بریده خواهد شد.
.RE
.sp
\fB\-h\fP, \fB\-\-help\fP
.RS 4
نمایش متن راهنما و خروج.
.RE
.sp
\fB\-V\fP, \fB\-\-version\fP
.RS 4
نمایش نسخه و خروج.
.RE
.SH "حالت تبدیل (CONVERSION MODE)"
.sp
یکی از حالت‌های تبدیل زیر می‌تواند مشخص شود. در صورت عدم تعیین، به‌طور پیش‌فرض بر روی \fB\-m\fP, \fB\-\-mask\fP قرار دارد.
.sp
\fB\-b\fP, \fB\-\-binary\fP
.RS 4
چاپ آرگومان‌های ترکیب‌شده به‌صورت یک مقدار ماسک دودویی (باینری).
.RE
.sp
\fB\-g\fP, \fB\-\-grouped\-mask\fP
.RS 4
چاپ آرگومان‌های ترکیب‌شده به‌صورت یک مقدار ماسک هگزادسیمال در گروه‌های ۳۲ بیتی جداشده با کاما.
.RE
.sp
\fB\-l\fP, \fB\-\-list\fP
.RS 4
چاپ آرگومان‌های ترکیب‌شده به‌صورت فهرستی از شناسه‌های بیت.
شناسه‌های متوالی به بازه‌ها فشرده می‌شوند.
.RE
.sp
\fB\-m\fP, \fB\-\-mask\fP
.RS 4
چاپ آرگومان‌های ترکیب‌شده به‌صورت یک مقدار ماسک هگزادسیمال (پیش‌فرض).
.RE
.SH "مثال‌ها (EXAMPLES)"
.sp
.if n .RS 4
.nf
.fam C
~$ bits \-\-mask 4,5\-8 16,30
0x400101f0

~$ bits \-\-list 0xeec2
1,6,7,9\-11,13\-15

~$ bits \-\-binary 4,5\-8 16,30
0b100_0000_0000_0001_0000_0001_1111_0000

~$ bits \-\-list ,00300000,03000000,30000003
0,1,28,29,56,57,84,85

~$ bits \-\-list 1,2,3,4 ~3\-10
1,2

~$ bits \-\-list 1,2,3,4 ^3\-10
1,2,5\-10

~$ bits \-\-grouped\-mask 2,22,74,79
8400,00000000,00400004

~$ bits \-\-width 64 \-\-list 2,22,74,79
2,22
.fam
.fi
.if n .RE
.SH "نویسندگان (AUTHORS)"
.sp
Robin Jarry.
.SH "گزارش باگ‌ها (REPORTING BUGS)"
.sp
برای گزارش باگ‌ها، از \c
.URL "https://github.com/util\-linux/util\-linux/issues" "سامانه پیگیری مشکلات" "."
.SH "دسترسی (AVAILABILITY)"
.sp
دستور \fBbits\fP بخشی از بسته util\-linux است که می‌توان آن را از \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux" "بایگانی هسته لینوکس" "."