'\" t
.\"     Title: secret-tool
.\"    Author: Stef Walter <stefw@gnome.org>
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 03/18/2025
.\"    Manual: User Commands
.\"    Source: XDG
.\"  Language: Persian
.\"
.TH "SECRET\-TOOL" "1" "" "XDG" "User Commands"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
secret-tool \- ذخیره و بازیابی گذرواژه‌ها
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBsecret\-tool\ store\ \fR\fB\-\-label=\*(AqLabel\*(Aq\fR\fB\ \fR\fB{attribute}\fR\fB\ \fR\fB{value}\fR\fB\ \&.\&.\&.\fR\ 'u
\fBsecret\-tool store \fR\fB\-\-label=\*(AqLabel\*(Aq\fR\fB \fR\fB{attribute}\fR\fB \fR\fB{value}\fR\fB \&.\&.\&.\fR
.HP \w'\fBsecret\-tool\ lookup\ \fR\fB{attribute}\fR\fB\ \fR\fB{value}\fR\fB\ \&.\&.\&.\fR\ 'u
\fBsecret\-tool lookup \fR\fB{attribute}\fR\fB \fR\fB{value}\fR\fB \&.\&.\&.\fR
.HP \w'\fBsecret\-tool\ clear\ \fR\fB{attribute}\fR\fB\ \fR\fB{value}\fR\fB\ \&.\&.\&.\fR\ 'u
\fBsecret\-tool clear \fR\fB{attribute}\fR\fB \fR\fB{value}\fR\fB \&.\&.\&.\fR
.HP \w'\fBsecret\-tool\ search\ \fR\fB[\-\-all]\fR\fB{attribute}\fR\fB\ \fR\fB{value}\fR\fB\ \&.\&.\&.\fR\ 'u
\fBsecret\-tool search \fR\fB[\-\-all]\fR\fB{attribute}\fR\fB \fR\fB{value}\fR\fB \&.\&.\&.\fR
.SH "توضیحات (DESCRIPTION)"
.PP
\fBsecret\-tool\fR
ابزاری در خط فرمان است که می‌توان از آن برای ذخیره و بازیابی گذرواژه‌ها استفاده کرد\&.
.PP
هر گذرواژه درون یک آیتم ذخیره می‌شود\&. آیتم‌ها به‌طور یکتا با مجموعه‌ای از کلیدها و مقادیر مشخصه‌ها شناسایی می‌شوند\&. هنگام ذخیرهٔ یک گذرواژه باید جفت‌های یکتایی از نام و مقدار مشخصه‌ها را مشخص کنید، و هنگام جستجوی یک گذرواژه، همان جفت‌های نام و مقدار مشخصه را ارائه دهید\&.
.SH "STORE"
.PP
برای ذخیرهٔ یک گذرواژه،
\fBsecret\-tool\fR
را با آرگومان
store
اجرا کنید\&. همچنین باید با آرگومان
\-\-label
یک برچسب برای گذرواژه تعیین کنید\&. این برچسب در مدیر گذرواژه نمایش داده خواهد شد\&.
.PP
هنگام ذخیره کردن یک گذرواژه، اطمینان حاصل کنید که مجموعه‌ای یکتا از نام‌ها و مقادیر مشخصه‌ها را ارسال می‌کنید\&. اگر این مشخصه‌ها با موردی که از قبل موجود است مطابقت داشته باشند، به‌جای ایجاد یک مورد جدید، آن مورد به‌روزرسانی خواهد شد\&.
.PP
اگر از یک ترمینال یا tty فراخوانی شود، گذرواژه برای ذخیره‌سازی درخواست خواهد شد و تنها یک خط پذیرفته می‌شود\&.
.PP
همچنین می‌توان گذرواژه‌ای را که قرار است ذخیره شود از طریق stdin هدایت (pipe) کرد\&. گذرواژه، محتویات stdin تا رسیدن به EOF خواهد بود\&. اگر از طریق stdin یک خط جدید وارد کنید، به عنوان بخشی از گذرواژه ذخیره خواهد شد\&.
.SH "LOOKUP"
.PP
برای جستجوی یک گذرواژه،
\fBsecret\-tool\fR
را با آرگومان
lookup
اجرا کنید\&. همان جفت‌های نام و مقدار مشخصه‌ای را که هنگام ذخیره گذرواژه ارسال کرده بودید، مشخص کنید\&.
.PP
اگر چندین مورد با مشخصه ارائه شده مطابقت داشته باشند، اولین گذرواژه‌ای که از قبل قفل‌گشایی شده است بازگردانده می‌شود\&. در صورت لزوم، یک مورد قفل‌گشایی خواهد شد\&.
.PP
هنگام چاپ گذرواژه در یک ترمینال یا tty، یک خط جدید اضافی پس از گذرواژه افزوده خواهد شد\&.
.SH "CLEAR"
.PP
برای حذف یک گذرواژه،
\fBsecret\-tool\fR
را با آرگومان
clear
اجرا کنید\&. همان جفت‌های نام و مقدار مشخصه‌ای را که هنگام ذخیره گذرواژه ارسال کرده بودید، مشخص کنید\&.
.PP
تمام موارد قفل‌گشایی‌شده‌ای که با مشخصه‌ها مطابقت دارند حذف خواهند شد\&.
.SH "SEARCH"
.PP
این دستور، موارد منطبق را در secret service جستجو کرده و جزئیات آن‌ها را چاپ می‌کند\&. همان جفت‌های مشخصه و مقداری را که هنگام ذخیره گذرواژه ارسال کرده بودید، مشخص کنید\&. می‌توانید از گزینه‌های زیر استفاده کنید:
.PP
\fB\-\-all\fR
.RS 4
بازگرداندن تمام نتایج منطبق، به جای فقط یکی از موارد منطبق\&. بدون این گزینه، نخستین مورد منطبق قفل‌گشایی‌شده که از سرویس بازگردانده شود، چاپ خواهد شد\&.
.RE
.PP
\fB\-\-unlock\fR
.RS 4
قفل‌گشایی مواردی که قفل هستند و سپس چاپ جزئیات آن‌ها\&. بدون این گزینه، از موارد قفل‌شده صرف‌نظر می‌شود\&.
.RE
.SH "کدهای خروج (EXIT CODES)"
.PP
در صورت موفقیت 0 بازگردانده می‌شود، در غیر این صورت یک کد خطای غیر صفر بازگردانده خواهد شد\&.
.SH "مثالها (EXAMPLES)"
.PP
\fBمثال\ \&1.\ \&ذخیره‌سازی، بازیابی و پاک کردن یک گذرواژه\fR
.sp
.if n \{\
.RS 4
.\}
.nf
$ secret\-tool store \-\-label=\*(AqMy password\*(Aq key1 value1 key2 value2
Password: hunter2
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
$ secret\-tool lookup key1 value1 key2 value2
hunter2
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
$ secret\-tool clear key1 value1 key2 value2
.fi
.if n \{\
.RE
.\}
.SH "باگها (BUGS)"
.PP
سامانه پیگیری باگ‌ها با مراجعه به وب‌سایت
\m[blue]\fBhttps://gitlab\&.gnome\&.org/GNOME/libsecret/issues\fR\m[]\& در دسترس است\&. پیش از ارسال گزارش باگ، لطفاً مطمئن شوید که آخرین نسخهٔ secret\-tool را دارید\&. بسیاری از باگ‌ها (بزرگ و کوچک) در هر انتشار برطرف می‌شوند و اگر نسخهٔ شما قدیمی باشد، ممکن است مشکل پیش‌تر حل شده باشد\&.