'\" t
.\"     Title: ospcat
.\"    Author: 
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: September 2003
.\"    Manual: Reference
.\"    Source: OpenSP
.\"  Language: English
.\"
.TH "OSPCAT" "1" "September 2003" "OpenSP" "Reference"
.\" -----------------------------------------------------------------
.\" * 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"
ospcat \- SGML print catalog
.SH "SYNOPSIS"
.HP \w'\fBospcat\fR\ 'u
\fBospcat\fR [\fB\-b\ \fR\fB\fIname\fR\fR] [\fB\-\-bctf=\fR\fB\fIname\fR\fR] [\fB\-C\fR] [\fB\-\-catalogs\fR] [\fB\-c\ \fR\fB\fIsysid\fR\fR] [\fB\-\-catalog=\fR\fB\fIsysid\fR\fR] [\fB\-f\fR] [\fB\-\-error\-file=\fR\fB\fIfile\fR\fR] [\fB\-D\ \fR\fB\fIdirectory\fR\fR] [\fB\-\-directory=\fR\fB\fIdirectory\fR\fR] [\fB\-R\fR] [\fB\-\-restricted\fR] [\fB\-v\fR] [\fB\-h\fR] [\fB\-\-help\fR] [\fB\-P\ \fR\fB\fIliteral\fR\fR] [\fB\-\-public\-id=\fR\fB\fIliteral\fR\fR] [\fB\-S\ \fR\fB\fIliteral\fR\fR] [\fB\-\-system_id=\fR\fB\fIliteral\fR\fR] [\fB\-p\ \fR\fB\fIname\fR\fR] [\fB\-\-parameter\-entity=\fR\fB\fIname\fR\fR] [\fB\-d\ \fR\fB\fIname\fR\fR] [\fB\-\-doctype=\fR\fB\fIname\fR\fR] [\fB\-l\ \fR\fB\fIname\fR\fR] [\fB\-\-linktype=\fR\fB\fIname\fR\fR] [\fB\-e\ \fR\fB\fIname\fR\fR] [\fB\-\-entity=\fR\fB\fIname\fR\fR] [\fB\-n\ \fR\fB\fIname\fR\fR] [\fB\-\-notation=\fR\fB\fIname\fR\fR] [\fB\-s\ \fR\fB\fIname\fR\fR] [\fB\-\-declaration=\fR\fB\fIname\fR\fR]
.SH "DESCRIPTION"
.PP
\fBospcat\fR
prints effective system identifiers found in the catalogs on the standard output\&. It doesn\*(Aqt check that the system identifiers correspond to actual files\&. The return value is 0 if the last system identifier was successfully created and 1 otherwise\&.
.SH "OPTIONS"
.PP
The following options are available:
.PP
\fB\-b \fR\fB\fIname\fR\fR, \fB\-\-bctf=\fR\fB\fIname\fR\fR
.RS 4
Use bctf
\fIname\fR
for output\&.
.RE
.PP
\fB\-f \fR\fB\fIfile\fR\fR, \fB\-\-error\-file=\fR\fB\fIfile\fR\fR
.RS 4
Append error messages to file
\fIfile\fR\&.
.RE
.PP
\fB\-v\fR, \fB\-\-version\fR
.RS 4
Display the program version\&.
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
Show this help text\&.
.RE
.PP
\fB\-c \fR\fB\fIsysid\fR\fR, \fB\-\-catalog=\fR\fB\fIsysid\fR\fR
.RS 4
Use catalog
\fIsysid\fR\&.
.RE
.PP
\fB\-C\fR, \fB\-\-catalogs\fR
.RS 4
Arguments are catalogs, use DOCUMENT entry\&.
.RE
.PP
\fB\-D \fR\fB\fIdirectory\fR\fR, \fB\-\-directory=\fR\fB\fIdirectory\fR\fR
.RS 4
Search files in directory
\fIdirectory\fR\&.
.RE
.PP
\fB\-R\fR, \fB\-\-restricted\fR
.RS 4
Restrict file reading (for use in Web apps)\&.
.RE
.PP
\fB\-P \fR\fB\fIliteral\fR\fR, \fB\-\-public\-id=\fR\fB\fIliteral\fR\fR
.RS 4
Print the effective system id for the public id
\fIliteral\fR\&.
.RE
.PP
\fB\-S \fR\fB\fIliteral\fR\fR, \fB\-\-system\-id=\fR\fB\fIliteral\fR\fR
.RS 4
Print the effective system id for system id
\fIliteral\fR\&.
.RE
.PP
\fB\-p \fR\fB\fIname\fR\fR, \fB\-\-parameter\-entity=\fR\fB\fIname\fR\fR
.RS 4
Print the effective system id for parameter entity
\fIname\fR\&.
.RE
.PP
\fB\-d \fR\fB\fIname\fR\fR, \fB\-\-doctype=\fR\fB\fIname\fR\fR
.RS 4
Print the effective system id for the doctype
\fIname\fR\&.
.RE
.PP
\fB\-l \fR\fB\fIname\fR\fR, \fB\-\-linktype=\fR\fB\fIname\fR\fR
.RS 4
Print the effective system id for the linktype
\fIname\fR\&.
.RE
.PP
\fB\-e \fR\fB\fIname\fR\fR, \fB\-\-entity=\fR\fB\fIname\fR\fR
.RS 4
Print the effective system id for entity
\fIname\fR\&.
.RE
.PP
\fB\-n \fR\fB\fIname\fR\fR, \fB\-\-notation=\fR\fB\fIname\fR\fR
.RS 4
Print the effective system id for notation
\fIname\fR\&.
.RE
.PP
\fB\-s \fR\fB\fIname\fR\fR, \fB\-\-declaration=\fR\fB\fIname\fR\fR
.RS 4
Print the effective system id for the SGML declaration for doctype
\fIname\fR\&.
.RE
.SH "SEE ALSO"
.PP
\fBonsgmls(1)\fR,
\fBospam(1)\fR,
\fBonsgmlnorm(1)\fR,
\fBospent(1)\fR
.SH "AUTHOR"
.PP
\fBIan Castle\fR <\&ian.castle@openjade.org\&>
.RS 4
Author.
.RE
.SH "COPYRIGHT"
.br