.\" Generated by scdoc 1.11.3
.\" Complete documentation for this program is not available as a GNU info page
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.\" Begin generated content:
.TH "pipectl" "1" "2024-10-13"
.PP
.SH "نام (NAME)"
.PP
pipectl \- ابزاری ساده برای مدیریت لوله‌های نام‌گذاری‌شده
.PP
.SH "خلاصه دستور (SYNOPSIS)"
.PP
\fBpipectl\fR [-h,-o,-i,-n N,-p P,-f,-l]
.PP
.SH "توضیحات (DESCRIPTION)"
.PP
\fBpipectl\fR ابزاری برای ایجاد و مدیریت لوله‌های نام‌گذاری‌شده کوتاه‌مدت است که می‌توان از آن برای هدایت ورودی استاندارد (stdin) به یک برنامه بلندمدت‌تر از هر نقطه دیگری از سیستم بدون نیاز به سازوکارهای پیچیده IPC مانند UNIX domain sockets استفاده کرد.\&
.PP
\fBpipectl\fR برای استفاده به‌صورت جفتی در نظر گرفته شده است؛ یک فراخوانی \fBpipectl\fR لوله را باز می‌کند (\fB-o\fR) و آن را به یک فرایند متصل می‌سازد، و تمام فراخوانی‌های دیگر با همان نام یا مسیر، درون stdin آن فرایند می‌نویسند:
.PP
.RS 4
$ pipectl -o | daemon-process
.PP
$ echo "do-the-thing --color red" | pipectl -i
.PP
$ echo "quit" | pipectl -i
.PP
.RE
فرایند دیمن هرگز با EOF روی stdin خود مواجه نخواهد شد.\& در عوض، \fBpipectl\fR تا زمان باز شدن یک لوله ورودی دیگر (\fB-i\fR) مسدود می‌شود و سپس stdin آن فرایند را به‌صورت ناهمگام به فرایند دیمن هدایت می‌کند.\&
.PP
هنگامی که فرایند دیمن خارج شود یا stdin خود را ببندد، \fBpipectl\fR به‌طور خودکار پاک‌سازی کرده و لوله نام‌گذاری‌شده ایجادشده را حذف می‌کند.\&
.PP
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB-h, --help\fR
.RS 4
نمایش پیام راهنما و خروج.\&
.PP
.RE
\fB-o, --out\fR
.RS 4
ایجاد یک لوله نام‌گذاری‌شده و چاپ محتوای آن در stdout.\&
.PP
.RE
\fB-i, --in\fR
.RS 4
نوشتن stdin درون یک لوله نام‌گذاری‌شده باز که با \fB-o\fR ایجاد شده است.\&
.PP
.RE
\fB-n N, --name N\fR
.RS 4
ایجاد لوله نام‌گذاری‌شده با نام سفارشی.\& بخش \fBمسیرها (PATHS)\fR را ببینید.\&
.PP
.RE
\fB-p P, --path P\fR
.RS 4
ایجاد یک لوله نام‌گذاری‌شده در یک مسیر سفارشی.\& بخش \fBمسیرها (PATHS)\fR را ببینید.\&
.PP
.RE
\fB-f, --force\fR
.RS 4
جایگزینی اجباری لوله نام‌گذاری‌شده حتی اگر از قبل وجود داشته باشد (تنها با \fB-o\fR قابل استفاده است).\&
.PP
.RE
\fB-l, --lock\fR
.RS 4
استفاده از \fBflock\fR(2) برای همگام‌سازی عملیات نوشتن در لوله (تنها با \fB-i\fR قابل استفاده است).\&
.PP
.RE
.SH "مسیرها (PATHS)"
.PP
به‌طور پیش‌فرض، \fBpipectl\fR لوله نام‌گذاری‌شده را در یک دایرکتوری موقت (\fBTMP\fR) ایجاد خواهد کرد.\& اولین دایرکتوری دردسترس از میان موارد زیر استفاده خواهد شد:
.PP
.PD 0
.IP \(bu 4
\fB$XDG_RUNTIME_DIR\fR
.IP \(bu 4
\fB$TMPDIR\fR
.IP \(bu 4
/tmp
.PD
.PP
مسیر نهایی لوله نام‌گذاری‌شده به شرح زیر است:
.PP
\fBپیش‌فرض\fR
.RS 4
\fBTMP\fR/pipectl.\&\fBUID\fR.\&pipe
.PP
.RE
\fBبا --name NAME\fR
.RS 4
\fBTMP\fR/pipectl.\&\fBUID\fR.\&\fBNAME\fR.\&pipe
.PP
.RE
\fBبا --path PATH\fR
.RS 4
\fBPATH\fR
.PP
.RE
که در آن \fBUID\fR شناسه کاربری واقعی فرایند \fBpipectl\fR است (به \fBgetuid\fR(3) مراجعه کنید).\&
.PP
.SH "نویسندگان (AUTHORS)"
.PP
توسعه و نگهداری توسط Ferdinand Bachmann <ferdinand.bachmann@yrlf.at>.\& اطلاعات بیشتر پیرامون \fBpipectl\fR را می‌توانید در <https://github.com/Ferdi265/pipectl> بیابید.\&
.PP
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBpipectl\fR(1) \fBmkfifo\fR(1) \fBflock\fR(2) \fBgetuid\fR(3)