.\" Copyright 2011 The Poppler Developers - http://poppler.freedesktop.org
.TH pdfsig 1 "28 October 2015"
.SH "نام (NAME)"
pdfsig \- ابزار امضاهای دیجیتال در قالب سند انتقال‌پذیر (PDF)
.SH "خلاصه دستور (SYNOPSIS)"
.B pdfsig
[\fIگزینه‌ها\fR]
.RI [ فایل-PDF ]
.RI [ فایل-خروجی ]
.SH "توضیحات (DESCRIPTION)"
.B pdfsig
امضاهای دیجیتال موجود در یک سند PDF را اعتبارسنجی می‌کند.
همچنین هویت هر امضاکننده
(فیلد commonName و نام متمایز کامل گواهی امضاکننده)،
زمان و تاریخ امضا، الگوریتم هش استفاده‌شده برای امضا،
نوع امضا به همان صورت که در سند PDF قید شده و
محدوده‌های امضاشده را همراه با بیانیه‌ای مبنی بر اینکه آیا کل سند امضا شده است یا خیر نمایش می‌دهد.
این ابزار همچنین می‌تواند اسناد PDF را امضا کند (با گزینه‌های \-add-signature یا \-sign).
.PP
دستور pdfsig از گواهی‌های معتبر ذخیره‌شده در پایگاه‌داده خدمات امنیت شبکه (NSS) یا در سامانه S/MIME مربوط به GnuPG موسوم به (gpgsm) استفاده می‌کند.
.PP
دستور pdfsig همچنین از پروتکل برخط وضعیت گواهی (OCSP) (برای اطلاعات بیشتر به http://en.wikipedia.org/wiki/Online_Certificate_Status_Protocol مراجعه کنید) برای جستجوی برخط گواهی و بررسی ابطال نشدن آن استفاده می‌کند (مگر اینکه گزینه \-no-ocsp مشخص شده باشد).
.PP
.nr step 0 1
.nr PI 2n
اگر از پیشانه NSS استفاده شود، پایگاه‌داده NSS در مسیرهای زیر جستجو می‌شود:
.IP \n+[step]
اگر گزینه \-nssdir مشخص شده باشد، دایرکتوری تعیین‌شده با این گزینه.
.IP \n+[step]
پایگاه‌داده گواهی‌های NSS در نمایه پیش‌فرض فایرفاکس، یعنی $HOME/.mozilla/firefox/*.default*.
.IP \n+[step]
پایگاه‌داده گواهی‌های NSS سیستمی در /etc/pki/nssdb.
.IP \n+[step]
پایگاه‌داده گواهی‌های NSS کاربر در $HOME/.pki/nssdb.
.PP
اگر از پیشانه GPG استفاده شود، گواهی S/MIME از متغیر $GNUPGHOME خوانده می‌شود که پیش‌فرض آن $HOME/.gnupg است.
.SH "گزینه‌ها (OPTIONS)"
.TP
.B \-nssdir "[prefix]directory"
دایرکتوری پایگاه‌داده حاوی فایل‌های پایگاه‌داده گواهی و کلید را مشخص می‌کند. برای جزئیات مربوط به
پیشوند به گزینه \-d در
.BR certutil (1)
مراجعه کنید. در صورت عدم تعیین، سایر مسیرهای جستجوی شرح‌داده‌شده در بخش
.B "توضیحات (DESCRIPTION)"
استفاده می‌شوند.
.TP
.B \-nss-pwd "password"
گذرواژه لازم برای دسترسی به پایگاه‌داده NSS (در صورت وجود) را مشخص می‌کند.
.TP
.B \-nocert
گواهی را اعتبارسنجی نمی‌کند.
.TP
.B \-no-ocsp
بررسی برخط ابطال گواهی با OCSP را انجام نمی‌دهد (همچنان از فهرست‌های محلی ابطال گواهی (CRL) استفاده می‌شود).
.TP
.B \-assert-signer " fpr_or_file"
این گزینه بررسی می‌کند که آیا امضای پوشش‌دهنده کل سند با کلید تعیین‌شده ایجاد شده است یا خیر. کلید یا به‌صورت یک اثرانگشت یا فایلی شامل فهرست اثرانگشت‌ها مشخص می‌شود. اثرانگشت باید در قالب فشرده (بدون دونقطه یا فاصله میان نویسه‌ها) وارد یا فهرست شود. اگر fpr_or_file یک فایل را مشخص کند، خطوط خالی و خطوطی که با علامت هش (#) شروع می‌شوند نادیده گرفته می‌شوند. تنها برای پیشانه GnuPG در دسترس است.
.TP
.B \-no-appearance
هنگام امضای فیلدهای موجود، اطلاعات ظاهری امضا (نام امضاکننده و تاریخ) را اضافه نمی‌کند.
.TP
.B \-aia
استفاده از افزونه دسترسی به اطلاعات مرجع (AIA) را برای دریافت گواهی‌های مفقود جهت ایجاد زنجیره گواهی فعال می‌کند.
.TP
.B \-dump
تمامی امضاها را در قالب بومی آن‌ها در دایرکتوری جاری ذخیره می‌کند. به احتمال زیاد این قالب یک بسته CMS/PKCS7 بدون فاصله‌گذاری یا با فاصله‌گذاری صفر (unpadded یا zero-padded) است.
.TP
.B \-add-signature
یک امضای جدید به سند اضافه می‌کند.
.TP
.B \-new-signature-field-name " name"
نام فیلدی که هنگام افزودن یک امضای جدید باید استفاده شود را مشخص می‌کند. به‌طور پیش‌فرض از یک شناسه تصادفی استفاده خواهد شد.
.TP
.B \-sign " field"
سند را در فیلد امضای موجود و مشخص‌شده در سند امضا می‌کند (باید امضانشده باشد). فیلد می‌تواند با نام فیلد (رشته) یا n-امین فیلد امضا در سند (عدد صحیح) مشخص شود.
.TP
.B \-nick " nickname"
از گواهی با نام مستعار داده‌شده برای امضا استفاده می‌کند (پیشانه NSS). اگر نام مستعار با pkcs11: آغاز شود، به عنوان یک شناسه یکنواخت منبع PKCS#11 در نظر گرفته می‌شود (پیشانه NSS). اگر نام مستعار به‌صورت اثرانگشت داده شود، همان گواهی استفاده خواهد شد (پیشانه GPG).
.TP
.B \-backend " backend"
از پیشانه مشخص‌شده برای امضاهای رمزنگاری استفاده می‌کند.
.TP
.B \-kpw " password"
از گذرواژه داده‌شده برای کلید امضا استفاده می‌کند
(در صورتی که کلید محافظت‌شده با گذرواژه نباشد ممکن است به این گزینه نیازی نباشد).
.TP
.B \-digest " algorithm"
از الگوریتم خلاصه‌ساز داده‌شده برای امضا استفاده می‌کند (پیش‌فرض: SHA256).
.TP
.B \-reason " reason"
رشته دلیل داده‌شده را برای امضا تنظیم می‌کند (پیش‌فرض: دلیلی تنظیم نشده است).
.TP
.B \-enable-pgp
امضاهای pgp را در پیشانه GnuPG فعال می‌کند. تنها برای پیشانه GnuPG در دسترس است.
.TP
.B \-etsi
امضایی از نوع ETSI.CAdES.detached به جای adbe.pkcs7.detached ایجاد می‌کند.
.TP
.B \-list-nicks
نام‌های مستعار موجود در پایگاه‌داده NSS را فهرست می‌کند.
.TP
.B \-list-backends
پیشانه‌های موجود برای امضاهای رمزنگاری را فهرست می‌کند.
.TP
.B \-v
اطلاعات حق نشر و نگارش را چاپ می‌کند.
.TP
.B \-h
اطلاعات نحوه استفاده را چاپ می‌کند.
.RB ( \-help
و
.B \-\-help
معادل یکدیگر هستند.)
.SH "مثال‌ها (EXAMPLES)"
.TP
pdfsig signed_file.pdf
اطلاعات امضای فایل signed_file.pdf را نمایش می‌دهد.
.TP
pdfsig input.pdf output.pdf -add-signature -nss-pwd password -nick my-cert -reason 'for fun!'
یک فایل pdf جدید به نام output.pdf با محتویات input.pdf ایجاد می‌کند که توسط گواهی 'my-cert' امضا شده است.
.TP
pdfsig input.pdf output.pdf -add-signature -nss-pwd password -nick 'pkcs11:token=smartcard0;object=Second%20certificate;type=cert'
مشابه حالت قبل، اما از یک نشانی PKCS#11 URI طبق تعریف IETF RFC 7512 برای انتخاب گواهی مورد استفاده جهت امضا بهره می‌برد.
.TP
pdfsig input.pdf output.pdf -sign 0 -nss-pwd password -nick my-cert -reason 'for fun!'
یک فایل pdf جدید به نام output.pdf با محتویات input.pdf ایجاد می‌کند که توسط گواهی 'my-cert' امضا شده است. فایل input.pdf باید از قبل یک فیلد امضای موجود و امضانشده داشته باشد.
.SH "نویسندگان (AUTHORS)"
حق نشر نرم‌افزار و مستندات pdfsig متعلق به سال‌های 1996-2004 شرکت Glyph & Cog, LLC
و سال‌های 2005-2015 توسعه‌دهندگان Poppler است - http://poppler.freedesktop.org
.SH "همچنین ببینید (SEE ALSO)"
.BR pdfdetach (1),
.BR pdffonts (1),
.BR pdfimages (1),
.BR pdfinfo (1),
.BR pdftocairo (1),
.BR pdftohtml (1),
.BR pdftoppm (1),
.BR pdftops (1),
.BR pdftotext (1),
.BR pdfseparate (1),
.BR pdfunite (1),
.BR certutil (1)