'\" t
.\" Worldvisions Weaver Software
.\"   Copyright (C) 1997 - 2004 Net Integration Technologies Inc.
.TH UNI 8 "September 2004" "Uni 4.6.1"
.SH "نام (NAME)"
uni \- برنامه‌ای برای ارتباط با سیستم پیکربندی UniConf
.SH "خلاصه دستور (SYNOPSIS)"
.B uni
get
.I KEY
.RI [ DEFAULT ]
.PP
.B uni
set
.I KEY
.RI [ VALUE ]
.br
.B uni
xset
.I KEY
.RI [ VALUE ]
.PP
.B uni
keys
.I KEY
.br
.B uni
hkeys
.I KEY
.br
.B uni
xkeys
.I KEY
.PP
.B uni
dump
.I KEY
.br
.B uni
hdump
.I KEY
.br
.B uni
xdump
.I KEY
.SH "توضیحات (DESCRIPTION)"
UniConf سیستم پیکربندی جامعی است که همه سیستم‌های دیگر را در بر می‌گیرد، زیرا دارای بک‌اندهای افزونه‌ای
.I و
فرانت‌اندهای مختلف است. یا به بیان ساده‌تر، درختی سبک‌وزن، توزیع‌شده و با قابلیت کش‌شدن از رشته‌ها است.
.PP
دستور
.B uni
برای ارتباط مستقیم با سیستم UniConf استفاده می‌شود. کاربرد اصلی آن برای اهداف عیب‌یابی و تشخیصی است، اما می‌تواند برای افزودن پشتیبانی از UniConf به اسکریپت‌های شل نیز به کار رود.
.SH "متغیر محیطی (ENVIRONMENT VARIABLE)"
.TP
.I UNICONF
پیش از استفاده از
.BR uni ،
باید با تنظیم این متغیر محیطی مشخص کنید که می‌خواهید از کدام مانیکر (moniker) UniConf پرس‌وجو نمایید.
.PP
مانیکرها برای برقراری ارتباط با بک‌اندهای UniConf استفاده می‌شوند، خواه یک سرور
.B uniconfd
باشد یا یک فایل محلی.
برای نمونه، می‌تواند یکی از موارد زیر باشد:
.RS 4
\(bu
نام یک فایل
.RI (ini: /var/lib/app/config.ini )،
.br
\(bu
یا یک نشانی شبکه،
.RI (tcp: open.nit.ca:4111 ).
.RE
.SH "دستورات (COMMANDS)"
.TP
get
مقدار
.I VALUE
مرتبط با کلید
.I KEY
ارائه‌شده را در پایگاه داده UniConf بازیابی می‌کند. اگر یک
.I DEFAULT
(پیش‌فرض) مشخص شده باشد، در صورتی که کلید
.I KEY
هیچ
.IR VALUE ی
نداشته باشد، این مقدار بازگردانده خواهد شد.
.TP
set
مقدار
.I VALUE
مشخص‌شده را به کلید
.IR KEY
اختصاص می‌دهد.
سیستم UniConf هیچ تضمینی نمی‌دهد که این ورودی در سرتاسر پایگاه داده ثبت شود. دستور \(lqget\(rq بعدی برای این
.I KEY
ممکن است به دلیل حافظه کش یا وجود یک مولد فقط‌خواندنی، آخرین مقدار \(lqset\(rq شده را بازنگرداند.
.TP
xset
محتویات جریان ورودی استاندارد (standard-input) را به کلید
.IR KEY
مشخص‌شده اختصاص می‌دهد. از این دستور برای انتقال (pipe) اطلاعات به درون پایگاه داده UniConf استفاده کنید.
.TP
keys
فهرست کردن تمام زیرکلیدهای موجود در کلید
.IR KEY
ارائه‌شده.
.TP
hkeys
فهرست کردن بازگشتی تمام زیرکلیدهای موجود در کلید
.IR KEY
ارائه‌شده.
از آنجا که هر
.I KEY
می‌تواند شامل زیرکلیدها باشد، UniConf هیچ تضمینی مبنی بر عدم وجود ارجاعات دایره‌ای ارائه نمی‌دهد.
.TP
xkeys
فهرست کردن تمام زیرکلیدهای موجود در کلید
.IR KEY
مشخص‌شده، که می‌تواند شامل نویسه‌های عام باشد. بخش
.B "نویسه‌های عام (WILDCARDS)"
را ببینید.
.TP
dump
فهرست کردن تمام زیرکلیدها و مقادیر آن‌ها در کلید
.IR KEY
مشخص‌شده.
.TP
hdump
فهرست کردن بازگشتی تمام زیرکلیدها و مقادیر آن‌ها در کلید
.IR KEY
مشخص‌شده.
.TP
xdump
فهرست کردن تمام زیرکلیدها و مقادیر آن‌ها در کلید
.IR KEY
مشخص‌شده، که می‌تواند شامل نویسه‌های عام باشد.
.SH "نویسه‌های عام (WILDCARDS)"
یک
.I KEY
دقیقاً مانند یک مسیر معمولی تفکیک‌شده با اسلش به نظر می‌رسد. ریشه درخت UniConf دارای یک
.I KEY
به نام
.RB \(lq / \(rq
است. زیرکلیدها می‌توانند با نام‌هایی مانند
.RB \(lq /software/myapp/version \(rq
در دسترس قرار گیرند.
.PP
با استفاده از نویسه‌های عام (wildcards)، می‌توانید به بیش از یک کلید در یک زمان دسترسی پیدا کنید.
.TP
*
برای دسترسی به یک زیرکلید در هر یک از سطوح کلیدها، از ستاره به این صورت استفاده کنید:
.RB \(lq /software/*/version \(rq.
این دستور تمام کلیدهای
.RB \(lq version \(rq
را که در یک سطح زیر
.RB \(lq /software \(rq
قرار دارند بازیابی می‌کند.
.TP
.RB ...
برای دسترسی به یک زیرکلید در هر کجای زیر یک کلید، از سه نقطه به این صورت استفاده کنید:
.RB \(lq /.../version \(rq.
این دستور تمام کلیدهای
.RB \(lq version \(rq
را که در صفر سطح یا سطوح بیشتر زیر ریشه قرار دارند بازیابی می‌کند
.RI ( یعنی
هرگونه حضور کلید
.RB \(lq version \(rq
در پایگاه داده).
.SH "همچنین ببینید (SEE ALSO)"
.BR uniconfd (8)
.SH "نویسندگان (AUTHORS)"
این نرم‌افزار توسط هکرهای شرکت Net Integration Technologies نوشته شده است. تماس با ما از طریق: <wvstreams\-dev@lists.nit.ca>
.\" Local variables:
.\" mode:nroff
.\" End: