.\" Last revised for MaraDNS 0.8.27 on October 16, 2001
.\"
.TH js_open 3 "October 2001" JS "js library reference"
.\" We don't want hyphenation (it's too ugly)
.\" We also disable justification when using nroff
.hy 0
.if n .na
.SH NAME
js_open \- Private function that opens up a file with open(2)
.SH SYNOPSIS
.nf
.B #include "JsStr.h"
.sp
.B "void js_open(js_string *filename, js_file *desc, int flags)"
.fi
.SH DESCRIPTION
.B js_open
is a function that opens up a file with open(2), using the
contents in the
.I js_string
object
.B filename
to determine the file name, and 
.B flags
to determine the opening flags.
.B desc 
is where we store the opened file descriptor.
.SH "RETURN VALUE"
.B js_open
is a void function.  The member 
.I filetype
of the structure
.I desc
will have an invalid value if an error occured opening the file.
.SH NOTES
Please do not use this function. Use
.BR js_open_read ,
.BR js_open_write ,
or
.B js_open_append
instead.

I am declaring this function a private function because programs using
the 
.I js_string
library really should not be utilizing Unix-specific file flags.  In other
words, use this function at your own risk, because I may change the
interface of this function or delete this function altogether in
future releases of the
.I js_string 
library.
.SH AUTHOR
Sam Trenholme <kiwi-zttfryb@koala.samiam.org>