.\" SPDX-License-Identifier: 0BSD
.\"
.\" Authors: Lasse Collin
.\"          Jia Tan
.\"
.TH "XZGREP" "1" "مه ۲۰۲۵" "xz" "دستورات کاربر"
.SH "نام (NAME)"
xzgrep \- جستجو در پروندههای فشردهشده با فرمتهای xz، lzma، gzip و bzip2
.
.SH "خلاصه دستور (SYNOPSIS)"
.B xzgrep
.RI [ گزینه... ]
.RI [ فهرست_الگو ]
.RI [ پرونده... ]
.br
.B xzegrep
\&...
.br
.B xzfgrep
\&...
.br
.B lzgrep
\&...
(منسوخ‌شده)
.br
.B lzegrep
\&...
(منسوخ‌شده)
.br
.B lzfgrep
\&...
(منسوخ‌شده)
.
.SH "توضیحات (DESCRIPTION)"
دستور \fBxzgrep\fR ابزار grep را بر روی پروندههای فشرده بدون نیاز به استخراج دستی اولیه آنها بر روی دیسک اجرا میکند.
.PP
دستور
.B xzgrep
ابزار
.BR grep (1)
را بر روی محتوای از فشرده‌سازی خارج‌شدهٔ پرونده‌ها اجرا می‌کند.
قالب‌های
.I پرونده‌ها
از روی پسوند نام پرونده تشخیص داده می‌شوند.
هر
.I پرونده
با پسوندی که توسط
.BR xz (1)،
.BR gzip (1)،
.BR bzip2 (1)،
.BR lzop (1)،
.BR zstd (1)
یا
.BR lz4 (1)
پشتیبانی شود، از حالت فشرده خارج خواهد شد؛
برای سایر پرونده‌ها فرض می‌شود که از ابتدا غیرفشرده هستند.
.PP
اگر هیچ
.I پرونده‌ای
مشخص نشود یا نام
.I پرونده
برابر با
.B \-
باشد، ورودی استاندارد خوانده می‌شود.
هنگام خواندن از ورودی استاندارد، تنها پرونده‌های پشتیبانی‌شده توسط
.BR xz (1)
از حالت فشرده خارج می‌شوند.
برای سایر پرونده‌ها فرض می‌شود که از قبل در قالب غیرفشرده هستند.
.PP
بیشتر
.I گزینه‌های
.BR grep (1)
پشتیبانی می‌شوند.
با این حال، گزینه‌های زیر پشتیبانی نمی‌شوند:
.IP "" 4
.BR \-r ,
.B \-\-recursive
.IP "" 4
.BR \-R ,
.B \-\-dereference\-recursive
.IP "" 4
.BR \-d ,
.BI \-\-directories= action
.IP "" 4
.BR \-Z ,
.B \-\-null
.IP "" 4
.BR \-z ,
.B \-\-null\-data
.IP "" 4
.BI \-\-include= glob
.IP "" 4
.BI \-\-exclude= glob
.IP "" 4
.BI \-\-exclude\-from= file
.IP "" 4
.BI \-\-exclude\-dir= glob
.PP
دستور
.B xzegrep
یک نام مستعار برای
.BR "xzgrep \-E"
است.
دستور
.B xzfgrep
یک نام مستعار برای
.BR "xzgrep \-F"
است.
.PP
دستورات
.BR lzgrep ،
.BR lzegrep
و
.B lzfgrep
برای سازگاری عقبروی با LZMA Utils ارائه شده‌اند.
این دستورات منسوخ شده‌اند و در نسخه‌های آینده حذف خواهند شد.
.
.SH "وضعیت خروج (EXIT STATUS)"
.TP
0
حداقل یک تطابق در حداقل یکی از پرونده‌های ورودی پیدا شد.
هیچ خطایی رخ نداد.
.TP
1
هیچ تطابقی در هیچ‌یک از پرونده‌های ورودی پیدا نشد.
هیچ خطایی رخ نداد.
.TP
>1
یک یا چند خطا رخ داد.
مشخص نیست که آیا تطابقی پیدا شده است یا خیر.
.
.SH "متغیرهای محیطی (ENVIRONMENT)"
.TP
.B GREP
اگر
.B GREP
روی مقداری غیرخالی تنظیم شده باشد، به جای
.BR "grep" ،
.BR "grep \-E"
یا
.BR "grep \-F"
استفاده می‌شود.
.
.SH "همچنین ببینید (SEE ALSO)"
.BR grep (1),
.BR xz (1),
.BR gzip (1),
.BR bzip2 (1),
.BR lzop (1),
.BR zstd (1),
.BR lz4 (1),
.BR zgrep (1)