'\" t .\" Title: cmis-client .\" Author: [see the "AUTHOR" section] .\" Generator: DocBook XSL Stylesheets vsnapshot .\" Date: 2018-12-23 .\" Manual: libcmis 0.6.3 .\" Source: libcmis 0.6.3 .\" Language: English .\" .TH "CMIS\-CLIENT" "1" "2018\-12\-23" "libcmis 0.6.3" "libcmis 0.6.3" .\" ----------------------------------------------------------------- .\" * 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)" cmis\-client \- ابزار خط فرمانی کلاینت CMIS\&. .SH "خلاصه دستور (SYNOPSIS)" .HP \w'\fBcmis\-client\fR\ 'u \fBcmis\-client\fR help .HP \w'\fBcmis\-client\fR\ 'u \fBcmis\-client\fR [\-v] \-\-url\ \fIurl://to/binding\fR list\-repos .HP \w'\fBcmis\-client\fR\ 'u \fBcmis\-client\fR [\-v] [\-u\ \fIlogin\fR] [\-p\ \fIsecret\fR] \-\-url\ \fIurl://to/binding\fR \-r\ \fIrepo\-id\fR repo\-infos .HP \w'\fBcmis\-client\fR\ 'u \fBcmis\-client\fR [\-v] [\-u\ \fIlogin\fR] [\-p\ \fIsecret\fR] \-\-url\ \fIurl://to/binding\fR \-r\ \fIrepo\-id\fR show\-root .HP \w'\fBcmis\-client\fR\ 'u \fBcmis\-client\fR [\-v] [\-u\ \fIlogin\fR] [\-p\ \fIsecret\fR] \-\-url\ \fIurl://to/binding\fR \-r\ \fIrepo\-id\fR get\-content\ \fIid\fR .HP \w'\fBcmis\-client\fR\ 'u \fBcmis\-client\fR [\-v] [\-u\ \fIlogin\fR] [\-p\ \fIsecret\fR] \-\-url\ \fIurl://to/binding\fR \-r\ \fIrepo\-id\fR \-\-input\-file\ \fIpath/to/file\fR \-\-input\-type\ \fImime/type\fR [\-\-input\-name\ \fIname\&.ext\fR] set\-content\ \fIid\fR .HP \w'\fBcmis\-client\fR\ 'u \fBcmis\-client\fR [\-v] [\-u\ \fIlogin\fR] [\-p\ \fIsecret\fR] \-\-url\ \fIurl://to/binding\fR \-r\ \fIrepo\-id\fR [\-\-object\-type\ \fIsome:cmistype\fR] [\-\-object\-property\ \fIprop\-id=prop\-value\fR...] create\-folder\ \fIparent\-id\ name\fR .HP \w'\fBcmis\-client\fR\ 'u \fBcmis\-client\fR [\-v] [\-u\ \fIlogin\fR] [\-p\ \fIsecret\fR] \-\-url\ \fIurl://to/binding\fR \-r\ \fIrepo\-id\fR \-\-input\-file\ \fIpath/to/file\fR \-\-input\-type\ \fImime/type\fR [\-\-input\-name\ \fIname\&.ext\fR] [\-\-object\-type\ \fIsome:cmistype\fR] [\-\-object\-property\ \fIprop\-id=prop\-value\fR...] create\-document\ \fIparent\-id\ name\fR .HP \w'\fBcmis\-client\fR\ 'u \fBcmis\-client\fR [\-v] [\-u\ \fIlogin\fR] [\-p\ \fIsecret\fR] \-\-url\ \fIurl://to/binding\fR \-r\ \fIrepo\-id\fR [\-\-object\-property\ \fIprop\-id=prop\-value\fR...] update\-object\ \fIobject\-id\fR .HP \w'\fBcmis\-client\fR\ 'u \fBcmis\-client\fR [\-v] [\-u\ \fIlogin\fR] [\-p\ \fIsecret\fR] \-\-url\ \fIurl://to/binding\fR \-r\ \fIrepo\-id\fR [type\-by\-id] | [show\-by\-id] | [show\-by\-path] | [delete] \fIarg\fR... .HP \w'\fBcmis\-client\fR\ 'u \fBcmis\-client\fR [\-v] [\-u\ \fIlogin\fR] [\-p\ \fIsecret\fR] \-\-url\ \fIurl://to/binding\fR \-r\ \fIrepo\-id\fR [checkout] | [cancel\-checkout] | [get\-versions] \fIarg\fR .HP \w'\fBcmis\-client\fR\ 'u \fBcmis\-client\fR [\-v] [\-u\ \fIlogin\fR] [\-p\ \fIsecret\fR] \-\-url\ \fIurl://to/binding\fR \-r\ \fIrepo\-id\fR [\-\-input\-file\ \fIpath/to/file\fR] [\-\-input\-type\ \fImime/type\fR] [\-\-input\-name\ \fIname\&.ext\fR] [\-\-object\-property\ \fIprop\-id=prop\-value\fR...] [\-\-major] [\-\-message] checkin\ \fIpwc\ id\fR .SH "توضیحات (DESCRIPTION)" .PP ابزار \fBcmis\-client\fR پرس‌وجوها را از طریق شبکه به یک سرور مجهز به CMIS ارسال می‌کند تا به محتوای آن دسترسی داشته باشد یا آن را تغییر دهد\&. این ابزار در اصل برای نمایش قابلیت‌های libcmis توسعه یافته است\&. .SH "گزینه‌ها (OPTIONS)" .SS "گزینه‌های عمومی (GLOBAL OPTIONS)" .PP \-v, \-\-verbose .RS 4 اطلاعات مفصلی را برای نظارت بر آنچه در پشت صحنه رخ می‌دهد نمایش می‌دهد\&. این گزینه کمک شایانی به اشکال‌زدایی libcmis می‌کند\&. .RE .PP \-\-help .RS 4 راهنما را نمایش داده و خارج می‌شود\&. این گزینه معادل استفاده از دستور help است\&. .RE .PP \-\-url \fIurl://to/binding\fR .RS 4 مقدار \fIurl://to/binding\fR باید به سند سرویس یکی از بایندینگ‌های AtomPub یا WebService اشاره کند\&. .RE .PP \-r,\-\-repository \fIrepo\-id\fR .RS 4 عملیات را روی مخزن CMIS با شناسهٔ \fIrepo\-id\fR انجام می‌دهد\&. اگر فقط یک مخزن روی سرور وجود داشته باشد، به این پارامتر نیازی نیست و آن مخزن به‌طور خودکار انتخاب خواهد شد\&. در صورتی که چندین مخزن روی سرور وجود دارد از این پارامتر استفاده کنید\&. .RE .PP \-u,\-\-username \fIlogin\fR .RS 4 با نام کاربری \fIlogin\fR به سرور CMIS متصل می‌شود\&. در صورت عدم تعیین، اتصال به‌صورت ناشناس برقرار خواهد شد\&. .RE .PP \-p,\-\-password \fIsecret\fR .RS 4 از \fIsecret\fR برای احراز هویت در سرور CMIS استفاده می‌کند\&. .RE .PP \-\-no\-ssl\-check .RS 4 بررسی‌های گواهی SSL را غیرفعال می‌کند\&. امنیت را کاهش می‌دهد، اما برای دور زدن مشکلات گواهی‌های نامعتبر مانند گواهی‌های منقضی‌شده یا خودامضا کاربردی است\&. .RE .PP \-\-proxy \fIurl\fR .RS 4 از \fIurl\fR به عنوان پیشکار HTTP استفاده می‌کند\&. تنظیم این مقدار، تنظیمات پیشکار سیستم را لغو خواهد کرد\&. .RE .PP \-\-proxy\-username \fIlogin\fR .RS 4 از \fIlogin\fR برای احراز هویت در پیشکار HTTP استفاده می‌کند\&. .RE .PP \-\-proxy\-password \fIsecret\fR .RS 4 از \fIsecret\fR برای احراز هویت در پیشکار HTTP استفاده می‌کند\&. .RE .PP \-\-noproxy \fIlist\fR .RS 4 تنظیمات پیشکار روی نام‌های میزبان و دامنه‌های فهرست‌شده در \fIlist\fR اعمال نخواهد شد\&. این مقدار یک فهرست جداشده با کاما است\&. .RE .PP \-\-oauth2\-client\-id \fIclient_id\fR .RS 4 شناسه کلاینت برنامه (client id) جهت استفاده در جریان احراز هویت OAuth2\&. .RE .PP \-\-oauth2\-client\-secret \fIclient_secret\fR .RS 4 شناسه مخفی کلاینت برنامه (client secret) جهت استفاده در جریان احراز هویت OAuth2\&. .RE .PP \-\-oauth2\-auth\-url \fIurl\fR .RS 4 نشانی اینترنتی (URL) برای احراز هویت کاربر در جریان احراز هویت OAuth2\&. .RE .PP \-\-oauth2\-token\-url \fIurl\fR .RS 4 نشانی اینترنتی (URL) برای احراز هویت برنامه در جریان احراز هویت OAuth2\&. توکن‌های دسترسی و بازنشانی توسط این URL ارائه می‌شوند\&. .RE .PP \-\-oauth2\-redirect\-uri \fIuri\fR .RS 4 شناسه منبع یکنواخت (URI) که جریان احراز هویت OAuth2 پس از احراز هویت موفقیت‌آمیز به آن بازگردانده می‌شود\&. .RE .PP \-\-oauth2\-scope \fIscope\fR .RS 4 حوزه دسترسی درخواستی (scope) در جریان احراز هویت OAuth2\&. .RE .SS "گزینه‌های عملیات تغییر (MODIFICATION OPERATIONS OPTIONS)" .PP \-\-input\-file \fIpath/to/file\fR .RS 4 فایل \fIpath/to/file\fR را به عنوان جریان محتوای جدید شیء بارگذاری می‌کند\&. .RE .PP \-\-input\-type \fImime/type\fR .RS 4 نوع MIME جریان محتوای جدید شیء را روی \fImime/type\fR تنظیم می‌کند\&. .RE .PP \-\-input\-name \fIname\&.ext\fR .RS 4 نام فایل راه دور جریان محتوای جدید شیء را روی \fIname\&.ext\fR تنظیم می‌کند\&. .RE .PP \-\-object\-type \fIsome:cmistype\fR .RS 4 نوع شیء CMIS مورد نظر برای ایجاد را روی \fIsome:cmistype\fR تنظیم می‌کند\&. این گزینه معادل \-\-object\-property cmis:objectTypeId=some:cmistype است\&. .RE .PP \-\-object\-property \fIprop\-id=prop\-value\fR .RS 4 ویژگی جدیدی را برای به‌روزرسانی یا افزودن به شیء CMIS تعیین می‌کند\&. \fIprop\-id\fR شناسه تعریف ویژگی و \fIprop\-value\fR مقداری است که برای آن تنظیم می‌شود\&. .RE .PP \-\-major .RS 4 هنگام انجام checkin، یک نسخهٔ اصلی (major) ایجاد می‌کند\&. .RE .PP \-m, \-\-message \fImessage\fR .RS 4 پیام عملیات checkin را تنظیم می‌کند\&. .RE .SS "دستورها (COMMANDS)" .PP help .RS 4 راهنما را نمایش داده و خارج می‌شود\&. .RE .PP list\-repos .RS 4 مخازن موجود روی سرور را فهرست می‌کند\&. .RE .PP repo\-infos .RS 4 اطلاعات و قابلیت‌های مخزن انتخاب‌شده را نمایش می‌دهد\&. .RE .PP show\-root .RS 4 اطلاعات گره ریشه و فرزندان آن را نمایش می‌دهد\&. .RE .PP get\-content \fIid\fR .RS 4 محتوای شیء CMIS متناظر با \fIid\fR را در دایرکتوری جاری بارگیری می‌کند\&. .RE .PP set\-content \fIid\fR .RS 4 یک فایل را به عنوان جریان محتوای شیء CMIS متناظر با \fIid\fR بارگذاری می‌کند\&. .RE .PP create\-folder \fIparent\-id name\fR .RS 4 یک زیرپوشه در پوشهٔ \fIparent\-id\fR به نام \fIname\fR ایجاد می‌کند\&. نوع پیش‌فرض پوشه برای ایجاد cmis:folder است، اما می‌توان با استفاده از گزینهٔ \-\-object\-type آن را تغییر داد\&. .RE .PP create\-document \fIparent\-id name\fR .RS 4 یک سند در پوشهٔ \fIparent\-id\fR به نام \fIname\fR ایجاد می‌کند\&. نوع پیش‌فرض سند برای ایجاد cmis:document است، اما می‌توان با استفاده از گزینهٔ \-\-object\-type آن را تغییر داد\&. .sp توجه داشته باشید که بسته به نوع سند ایجادشونده و محدودیت‌های آن، ممکن است گزینه‌های \-\-input\-file و \-\-input\-type الزامی باشند\&. .RE .PP update\-object \fIobject\-id\fR .RS 4 ویژگی‌های قابل نوشتن داده‌شده با گزینهٔ \-\-object\-property را روی شیء متناظر با شناسهٔ \fIobject\-id\fR جایگزین می‌کند\&. .RE .PP type\-by\-id \fIarg\&.\&.\&.\fR .RS 4 اطلاعات و فرزندان (در صورت وجود) تمام انواع CMIS متناظر با شناسه‌های فهرست‌شده را نمایش می‌دهد\&. .RE .PP show\-by\-id \fIarg\&.\&.\&.\fR .RS 4 اطلاعات و فرزندان (در صورت وجود) تمام اشیاء CMIS متناظر با شناسه‌های فهرست‌شده را نمایش می‌دهد\&. .RE .PP show\-by\-path \fIarg\&.\&.\&.\fR .RS 4 اطلاعات و فرزندان (در صورت وجود) تمام اشیاء CMIS متناظر با مسیرهای فهرست‌شده را نمایش می‌دهد\&. .RE .PP delete \fIarg\&.\&.\&.\fR .RS 4 اشیاء CMIS متناظر با شناسه‌های فهرست‌شده را حذف می‌کند\&. اگر گره یک پوشه باشد، محتوای آن نیز حذف خواهد شد\&. .RE .PP checkout \fIarg\fR .RS 4 سند متناظر با شناسه ارائه‌شده را تحویل گرفته (checkout) و اطلاعات رونوشت کاری خصوصی (PWC) ایجادشده را نمایش می‌دهد\&. .RE .PP cancel\-checkout \fIarg\fR .RS 4 رونوشت کاری خصوصی (PWC) متناظر با شناسه گره را لغو می‌کند\&. .RE .PP get\-versions \fIarg\fR .RS 4 نسخه‌های (در صورت وجود) تمام اشیاء CMIS متناظر با شناسه ارائه‌شده را نمایش می‌دهد\&. .RE .PP checkin \fIarg\fR .RS 4 رونوشت کاری خصوصی متناظر با شناسه ارائه‌شده را تحویل داده (checkin) و اطلاعات سند حاصل را نمایش می‌دهد\&. از گزینه‌های \-\-major و \-\-message برای تعریف نسخه ایجادشونده و ثبت توضیحات مربوط به آن استفاده کنید\&. توجه داشته باشید مخازنی که قابلیت به‌روزرسانی رونوشت‌های کاری خصوصی را ندارند، به گزینه‌های \-\-input\-file، \-\-input\-type و \-\-object\-property نیاز خواهند داشت\&. .RE .SH "نحوه استفاده (USAGE)" .PP نمایش گره ریشه از مخزن A1: .PP \fBcmis\-client\fR \-r A1 \-\-url http://localhost/atom show\-root .PP نمایش گره‌های با شناسه‌های 133 و 116 از مخزن A1: .PP \fBcmis\-client\fR \-r A1 \-\-url http://localhost/atom show\-by id 133 116 .SH "نویسندگان (AUTHORS)" .PP C\('edric Bosdonnat .SH "گزارش باگ‌ها (BUGS)" .PP گزارش باگ‌ها را به <\m[blue]\fBhttps://github\&.com/tdf/libcmis/issues\fR\m[]> ارسال کنید\&.