.TH SQ 1 1.4.0 "Sequoia PGP" "User Commands"
.SH "نام (NAME)"
sq\-packet \- دستکاری سطح پایین بسته‌ها
.SH "خلاصه دستور (SYNOPSIS)"
.br
\fBsq packet armor\fR [\fIOPTIONS\fR] \fIFILE\fR
.br
\fBsq packet dearmor\fR [\fIOPTIONS\fR] \fIFILE\fR
.br
\fBsq packet dump\fR [\fIOPTIONS\fR] \fIFILE\fR
.br
\fBsq packet decrypt\fR [\fIOPTIONS\fR] \fIFILE\fR
.br
\fBsq packet split\fR [\fIOPTIONS\fR] \fIFILE\fR
.br
\fBsq packet join\fR [\fIOPTIONS\fR] \fIFILE\fR
.SH "توضیحات (DESCRIPTION)"
دستکاری سطح پایین بسته‌ها.
.PP
یک جریان داده OpenPGP از بسته‌ها تشکیل شده است. این ابزارها امکان کار با جریان‌های بسته را فراهم می‌کنند. این ابزارها بیشتر مورد توجه توسعه‌دهندگان هستند، اما \fBsq packet dump\fR می‌تواند برای مخاطبان گسترده‌تر، هم برای ارائه اطلاعات ارزشمند در گزارش‌های اشکال نرم‌افزارهای مرتبط با OpenPGP و هم به عنوان یک ابزار آموزشی، مفید باشد.
.PP

.SH "زیردستورها (SUBCOMMANDS)"
.SS "sq packet armor"
تبدیل باینری به ASCII.
.PP
برای تسهیل مدیریت و انتقال داده‌های رمزگذاری‌شده، می‌توان داده‌های OpenPGP را به یک بازنمایی متنی ASCII موسوم به زره اسکی (ASCII Armor) تبدیل کرد. دستور sq به‌طور پیش‌فرض داده‌های زره‌پوش (armored) تولید می‌کند، اما این زیردستور می‌تواند برای تبدیل داده‌های موجود OpenPGP به بازنمایی کدگذاری‌شده با ASCII آن‌ها استفاده شود.
.PP
عملیات معکوس این دستور، \fBsq packet dearmor\fR است.
.PP


.SS "sq packet dearmor"
تبدیل ASCII به باینری.
.PP
برای تسهیل مدیریت و انتقال داده‌های رمزگذاری‌شده، می‌توان داده‌های OpenPGP را به یک بازنمایی متنی ASCII موسوم به زره اسکی (ASCII Armor) تبدیل کرد. دستور sq داده‌های زره‌پوش را به‌صورت شفاف مدیریت می‌کند، اما این زیردستور می‌تواند برای تبدیل صریح داده‌های موجود OpenPGP کدگذاری‌شده با ASCII به قالب باینری آن‌ها استفاده شود.
.PP
عملیات معکوس این دستور، \fBsq packet armor\fR است.
.PP


.SS "sq packet dump"
فهرست کردن بسته‌ها.
.PP
یک توصیف خوانا برای انسان از توالی بسته‌ها ایجاد می‌کند. علاوه بر این، می‌تواند مصنوعات رمزنگاری را چاپ کند و جریان بایت خام را مشابه hexdump(1) با حاشیه‌نویسی دقیق درباره اینکه کدام بایت‌ها به مقادیر OpenPGP تجزیه شده‌اند نمایش دهد.
.PP
اگر جریان بسته شامل یک کانتینر رمزگذاری باشد، \fBsq\fR تلاش خواهد کرد آن را رمزگشایی کند.
.PP


.SS "sq packet decrypt"
باز کردن کانتینر رمزگذاری.
.PP
یک پیام را رمزگشایی کرده و محتوای کانتینر رمزگذاری را بدون پردازش بیشتر استخراج می‌کند. نتیجه، یک پیام معتبر OpenPGP است که می‌تواند در کنار موارد دیگر، با استفاده از \fBsq packet dump\fR بازرسی شود.
.PP


.SS "sq packet split"
تقسیم یک پیام به بسته‌ها.
.PP
تقسیم یک توالی بسته به بسته‌های جداگانه و سپس ترکیب دوبارهٔ آزادانهٔ آن‌ها با \fBsq packet join\fR روشی عالی برای آزمایش داده‌های OpenPGP است.
.PP
به‌طور پیش‌فرض، بسته‌ها به عنوان توالی‌ای از بلوک‌های زره‌پوش ASCII در خروجی استاندارد (stdout) نوشته می‌شوند. امکان ویرایش مستقیم این فایل (برای نمونه جابه‌جایی، افزودن یا حذف بسته‌ها) و سپس استفاده از \fBsq packet join\fR برای سرهم‌بندی جریان وجود دارد.
.PP
در غیر این صورت، اگر یک \fB\-\-output\-prefix\fR داده شود، بسته‌ها در فایل‌های جداگانه‌ای که با پیشوند مورد نظر آغاز می‌شوند نوشته خواهند شد و می‌توان دوباره آن‌ها را با \fBsq packet join\fR سرهم‌بندی کرد.
.PP
عملیات معکوس این دستور، \fBsq packet join\fR است.
.PP


.SS "sq packet join"
اتصال بسته‌های تقسیم‌شده در چند فایل.
.PP
تقسیم یک توالی بسته به بسته‌های جداگانه و سپس ترکیب دوبارهٔ آزادانهٔ آن‌ها با \fBsq packet join\fR روشی عالی برای آزمایش داده‌های OpenPGP است.
.PP
عملیات معکوس این دستور، \fBsq packet split\fR است.
.PP


.SH "مثال‌ها (EXAMPLES)"
.SS "sq packet armor"
.PP

.PP
تبدیل یک پیام OpenPGP باینری به یک پیام OpenPGP با زره اسکی (ASCII armored).
.PP
.nf
.RS
sq packet armor message.bin
.RE
.PP
.fi

.PP
تبدیل یک پیام OpenPGP باینری به یک پیام OpenPGP با زره اسکی
با انتخاب صریح برچسب زره (armor label).
.PP
.nf
.RS
sq packet armor \-\-label=message message.bin
.RE
.fi
.PP
.SS "sq packet dearmor"
.PP

.PP
تبدیل یک پیام OpenPGP با زره اسکی به یک پیام OpenPGP باینری.
.PP
.nf
.RS
sq packet dearmor \-\-output=message.bin message.pgp
.RE
.fi
.PP
.SS "sq packet dump"
.PP

.PP
چاپ بسته‌های یک گواهی.
.PP
.nf
.RS
sq packet dump juliet.pgp
.RE
.PP
.fi

.PP
چاپ بسته‌ها شامل مصنوعات رمزنگاری یک گواهی.
.PP
.nf
.RS
sq packet dump \-\-mpis juliet.pgp
.RE
.PP
.fi

.PP
چاپ بسته‌ها شامل تخلیه (dump) تک‌تک بایت‌های یک گواهی.
.PP
.nf
.RS
sq packet dump \-\-hex juliet.pgp
.RE
.PP
.fi

.PP
چاپ بسته‌های یک پیام رمزگذاری‌شده و رمزگشایی آن با استفاده از یک فایل
کلید خصوصی (secret key).
.PP
.nf
.RS
sq packet dump \-\-recipient\-file bob\-secret.pgp message.pgp
.RE
.fi
.PP
.SS "sq packet decrypt"
.PP

.PP
باز کردن رمزگذاری و آشکارسازی پیام امضاشده.
.PP
.nf
.RS
sq packet decrypt \-\-recipient\-file bob\-secret.pgp message.pgp
.RE
.fi
.PP
.SS "sq packet split"
.PP

.PP
تقسیم یک گواهی به بسته‌های جداگانه‌ای که در خروجی استاندارد (stdout) چاپ می‌شوند.
.PP
.nf
.RS
sq packet split \-\-output=\- juliet.pgp
.RE
.PP
.fi

.PP
تقسیم یک پیام با امضای درون‌خطی به بسته‌های مجزایی که در فایل‌های
جداگانه با پیشوند 'packet' نوشته می‌شوند.
.PP
.nf
.RS
sq packet split \-\-output\-prefix packet document.pgp
.RE
.PP
.fi

.PP
سپس سرهم‌بندی مجدد پیام، و تبدیل آن به یک پیام امضاشده به سبک قدیمی
با امضای پیشوندی.
.PP
.nf
.RS
sq packet join \-\-output prefix\-signature.pgp \-\-label message \
.RE
.RS
.RS
packet\-2\-Signature\-Packet packet\-1\-Literal\-Data\-Packet
.RE
.RE
.fi
.PP
.SS "sq packet join"
.PP

.PP
تقسیم یک پیام با امضای درون‌خطی به بسته‌های مجزایی که در فایل‌های
جداگانه با پیشوند 'packet' نوشته می‌شوند.
.PP
.nf
.RS
sq packet split \-\-output\-prefix packet document.pgp
.RE
.PP
.fi

.PP
سپس سرهم‌بندی مجدد پیام، و تبدیل آن به یک پیام امضاشده به سبک قدیمی
با امضای پیشوندی.
.PP
.nf
.RS
sq packet join \-\-output prefix\-signature.pgp \-\-label message \
.RE
.RS
.RS
packet\-2\-Signature\-Packet packet\-1\-Literal\-Data\-Packet
.RE
.RE
.fi
.SH "همچنین ببینید (SEE ALSO)"
.nh
\fBsq\fR(1), \fBsq\-packet\-armor\fR(1), \fBsq\-packet\-dearmor\fR(1), \fBsq\-packet\-dump\fR(1), \fBsq\-packet\-decrypt\fR(1), \fBsq\-packet\-split\fR(1), \fBsq\-packet\-join\fR(1).
.hy
.PP
برای مستندات کامل <https://book.sequoia\-pgp.org> را ببینید.
.SH "نسخه (VERSION)"
1.4.0