NAME

bookinfo − extract information from and verify AnswerBook configuration file

SYNOPSIS

bookinfo -a answerbook-id -l language
bookinfo -a answerbook-id -f field book-id
bookinfo -a answerbook-id -c book-id
bookinfo -a answerbook-id -t
bookinfo -a answerbook-id -v

AVAILABILITY

bookinfo is available as part of OpenWindows Version 3.1 and the Solaris 2.1 operating system. 

DESCRIPTION

The bookinfo utility allows users to extract information from the AnswerBook configuration file (bookinfo) and to verify that configuration information is correct. 

The bookinfo file is the configuration file that docviewer(1), navigator(1), and related utilities use to locate components of a document collection.  See bookinfo(5) for a detailed description of the bookinfo file format and usage. 

The bookinfo utility is primarily intended for use by system administrators for diagnosing AnswerBook configuration problems.  To catch these problems early, the AnswerBook startup script answerbook invokes bookinfo each time it is run to verify the AnswerBook configuration information before launching docviewer and navigator. 

OPTIONS

−a answerbook-id
Specify the id of the AnswerBook.

−l List the book-id of each book in the bookinfo file. 

−f field book-id
Print the indicated field from book-id’s entry in the bookinfo file.  field must be one of id, tocpath, pspath, searchpath, or title. 

−c book-id
Check the bookinfo configuration information for the specified book.  If no book is specified, verify all books.  Specifically, bookinfo performs the following checks:

•That the book’s table of contents (TOC) database exists in the directory specified in the TOC-database-path. 

•That the book’s PostScript file directory exists in the directory specified in the PostScript-path field. 

•That the book’s search index (if any) exists in the location specified in the search-index-path field and is not corrupt. To do this, bookinfo actually performs a simple search operation on the index.  This not only verifies that the search index is present, but also that it is not corrupt. 

−t List all the languages (their two character code) that are available in the collection answerbook-id.

−v List all the languages (their two character code and the full name) that are available in the collection answerbook-id.  This is a verbose version of the −t option. 

ENVIRONMENT

bookinfo uses the same scheme as other AnswerBook applications and utilities for locating bookinfo entries—it looks in the following locations in order, using the first entry it finds:

BOOKINFO (Environment variable specifying the full path name of the bookinfo file)

~/.bookinfo (Per-user bookinfo file)

/etc/bookinfo (Per-system bookinfo file)

bookinfo.byname (NIS map for network-wide bookinfo)

SEE ALSO

docviewer(1), viewopen(1), viewprint(1), navigator(1), bookinfo(5), mkbookinfo(8)

DIAGNOSTICS

bookinfo: No bookinfo file. Make sure $BOOKINFO is set correctly.

bookinfo: No bookinfo entry for book book-id. 

bookinfo: environment variable $variable-name not set. 

bookinfo: Can’t access TOC database for book book-id:
toc-path/book-id.{dir,pag}. 
Reason: reason

bookinfo: Can’t access PostScript directory for book book-id:
toc-path/book-id. 
Reason: reason

bookinfo: Can’t initiate search on collection book-id. 
Search index is search-path
Reason: reason

bookinfo: Can’t open search index for collection book-id. 
Search index is: search-path
Reason: reason

bookinfo: Can’t perform search on collection book-id. 
Search index is: search-path
Reason: reason

NOTES

PostScript is a trademark of Adobe Systems Incorporated. 
AnswerBook is a trademark of Sun Microsystems, Inc., licensed to SunSoft, Inc.

SunOS 5.1  —  Last change: 02 March 1992