نام (NAME)

indxbib - ساخت نمایه معکوس برای پایگاه‌های داده کتاب‌شناختی

خلاصه دستور (SYNOPSIS)

توضیحات (DESCRIPTION)

دستور indxbib یک نمایه معکوس از پایگاه‌های داده کتاب‌شناختی در هر file می‌سازد تا سرعت دسترسی به آن‌ها توسط refer(1)، lookbib(1) و lkbib(1) افزایش یابد. این برنامه در یک فایل موقت می‌نویسد و سپس نام آن را به file.i تغییر می‌دهد. اگر هیچ عملوند file مشخص نشده باشد و هیچ گزینه -o نیز داده نشده باشد، indxbib نام نمایه را Ind.i می‌گذارد.

پایگاه‌های داده کتاب‌شناختی با خطوط خالی به رکوردها تقسیم می‌شوند. درون یک رکورد، هر فیلد با یک نویسه % در ابتدای خط آغاز می‌شود. فیلدها دارای یک نام تک‌حرفی هستند که پس از نویسه % قرار می‌گیرد.

دستور indxbib مقادیر تنظیم‌شده توسط گزینه‌های -c، -l، -n و -t را در نمایه ذخیره می‌کند: برنامه‌هایی که در نمایه جستجو می‌کنند، این مقادیر را تفسیر کرده، کلیدها را به درستی دور می‌ریزند یا کوتاه می‌کنند، و با استفاده از کلیدهای اصلی تایید می‌کنند که هر رکورد یافت‌شده با استفاده از نمایه، واقعاً حاوی آن کلیدها باشد. این بدان معناست که کاربر نمایه نیازی به دانستن این موضوع ندارد که آیا این گزینه‌ها در زمان ایجاد نمایه استفاده شده‌اند یا خیر، مشروط بر آن‌که تمام کلیدهای مورد جستجو در طول نمایه‌سازی دور ریخته نشده باشند و کاربر حداقل آن بخش از هر کلید را ارائه دهد که پس از کوتاه‌سازی در طول نمایه‌سازی باقی می‌مانده است. همچنین indxbib مقدار تنظیم‌شده توسط گزینه -i را در نمایه ذخیره می‌کند تا برای اعتبارسنجی رکوردهای یافت‌شده با استفاده از آن به کار رود.

گزینه‌ها (OPTIONS)

--help یک پیام راهنمای استفاده نمایش می‌دهد، در حالی که -v و --version اطلاعات نسخه را نشان می‌دهند؛ سپس همگی خارج می‌شوند.

-c common-words-file

خواندن فهرست کلمات رایج از common-words-file به جای /usr/share/groff/1.24.1/eign.

-d dir

استفاده از dir به‌عنوان نام دایرکتوری جهت ذخیره در نمایه، به جای نامی که توسط getcwd(2) بازگردانده می‌شود. معمولاً dir یک پیوند نمادین خواهد بود که مقصد آن دایرکتوری کاری فعلی است.

-f list-file

خواندن فایل‌هایی که باید نمایه‌سازی شوند از list-file. اگر list-file برابر با - باشد، فایل‌ها از جریان ورودی استاندارد خوانده می‌شوند. گزینه -f حداکثر یک بار می‌تواند مشخص شود.

-h min-hash-table-size

استفاده از اولین عدد اول بزرگ‌تر یا مساوی با آرگومان برای اندازه جدول درهم‌سازی. مقادیر بزرگ‌تر معمولاً جستجو را سریع‌تر می‌کنند، اما اندازه فایل نمایه را بزرگ‌تر کرده و موجب می‌شوند indxbib حافظه بیشتری مصرف کند. اندازه پیش‌فرض جدول درهم‌سازی ۹۹۷ است.

-i excluded-fields

عدم نمایه‌سازی محتوای فیلدهایی که نام آن‌ها در excluded-fields آمده است. نام‌های فیلدها هر کدام یک نویسه هستند. اگر این گزینه مشخص نشود، indxbib فیلدهای X، Y و Z را مستثنی می‌کند.

-k max-keys-per-record

استفاده از کلیدهایی به ازای هر رکورد ورودی، نه بیشتر از آنچه در آرگومان مشخص شده است. اگر این گزینه مشخص نشود، حداکثر مقدار ۱۰۰ است.

-l min-key-length

دور ریختن هر کلیدی که طول آن بر حسب نویسه کوتاه‌تر از مقدار آرگومان باشد. اگر این گزینه مشخص نشود، حداقل طول کلید ۳ خواهد بود.

-n threshold

دور ریختن threshold کلمه از رایج‌ترین کلمات موجود در فایل کلمات رایج. اگر این گزینه مشخص نشود، ۱۰۰ کلمه از رایج‌ترین کلمات دور ریخته می‌شوند.

-o basename

نام‌گذاری نمایه به صورت basename.i.

-t max-key-length

کوتاه‌سازی کلیدها به max-key-length نویسه. اگر این گزینه مشخص نشود، کلیدها به ۶ نویسه کوتاه می‌شوند.

-w

نمایه‌سازی کل فایل‌ها. هر فایل یک رکورد جداگانه در نظر گرفته می‌شود.

وضعیت خروج (EXIT STATUS)

دستور indxbib در صورت اجرای موفقیت‌آمیز با وضعیت 0، اگر نتواند آرگومان‌های خط فرمان را تفسیر کند با وضعیت 2 و در صورت مواجهه با خطا در حین اجرا با وضعیت 1 خارج می‌شود.

فایل‌ها (FILES)

file.i

نمایه برای file

Ind.i

نام پیش‌فرض نمایه

/usr/share/groff/1.24.1/eign

شامل فهرست کلمات رایج است. نام سنتی “eign” مخفف عبارت “English ignored [word list]” است.

indxbibXXXXXX

فایل موقت

همچنین ببینید (SEE ALSO)

“Some Applications of Inverted Indexes on the Unix System”, by M. E. Lesk, 1978, AT&T Bell Laboratories Computing Science Technical Report No. 69.

refer(1)، lkbib(1)، lookbib(1)