170 lines
4.0 KiB
HTML
170 lines
4.0 KiB
HTML
<HTML><HEAD><TITLE>STk procedures - posix manual page</TITLE></HEAD>
|
|
<BR>
|
|
<BODY bgcolor = #ffffa0>
|
|
<H2><IMG ALIGN=BOTTOM SRC="./Img/ManPageYellow.gif"> posix </H2>
|
|
<I>Access to posix functions</I><P><IMG ALIGN=TOP SRC="./Img/line-red.gif">
|
|
<H3><A NAME="M2">SYNOPSIS</A></H3>
|
|
<P>
|
|
<DL>
|
|
<DT><A NAME="M3">{<I>ERROR MANAGEMENT</I>}</A><DD>
|
|
<B>*errno*</B>
|
|
<P>
|
|
<P>
|
|
<P>
|
|
(<B>posix-perror</B> <I>str</I>)
|
|
<P>
|
|
<DT><A NAME="M4">{<I>FILES AND DIRECTORIES</I>}</A><DD>
|
|
(<B>posix-stat</B> <I>filename</I>)
|
|
<P>
|
|
<P>
|
|
<P>
|
|
(<B>posix-stat->vector</B> <I>descr</I>)
|
|
<P>
|
|
<P>
|
|
<P>
|
|
(<B>posix-access </B><I>filename mode</I>)
|
|
<P>
|
|
<P>
|
|
<P>
|
|
(<B>posix-pipe</B>)
|
|
<P>
|
|
<DT><A NAME="M5">{<I>TIME FUNCTIONS</I>}</A><DD>
|
|
(<B>posix-time</B>)
|
|
<P>
|
|
<P>
|
|
<P>
|
|
(<B>posix-asctime</B>)
|
|
<P>
|
|
<P>
|
|
<P>
|
|
(<B>posix-asctime</B> seconds)
|
|
<P>
|
|
<P>
|
|
<P>
|
|
(<B>posix-ctime</B>)
|
|
<P>
|
|
<P>
|
|
<P>
|
|
(<B>posix-ctime</B> <I>seconds</I>)
|
|
<P>
|
|
<P>
|
|
<P>
|
|
(<B>posix-localtime</B> <I> seconds</I>)
|
|
<P>
|
|
<P>
|
|
<P>
|
|
(<B>posix-gmtime</B> <I>seconds</I>)
|
|
<P>
|
|
<P>
|
|
<P>
|
|
(<B>posix-mktime</B> <I>time</I>)
|
|
<P>
|
|
<P>
|
|
<P>
|
|
(<B>posix-tm->vector</B> <I>time</I>)
|
|
<P>
|
|
<P>
|
|
<P>
|
|
(<B>vector->posix-tm</B> <I>vect</I>)
|
|
<P>
|
|
<P>
|
|
<P>
|
|
(<B>posix-strftime</B> <I>format</I>)
|
|
<P>
|
|
<P>
|
|
<P>
|
|
(<B>posix-strftime</B> <I>format time</I>)
|
|
<P>
|
|
<DT><A NAME="M6">{<I>PROCESSES FUNCTIONS</I>}</A><DD>
|
|
<P>
|
|
<P>
|
|
(<B>posix-fork</B>)
|
|
<P>
|
|
<P>
|
|
<P>
|
|
(<B>posix-wait</B>)
|
|
<P>
|
|
<DT><A NAME="M7">{<I>SYSTEM INFORMATIONS</I>}</A><DD>
|
|
<P>
|
|
<P>
|
|
(<B>posix-uname</B>)
|
|
<P>
|
|
<P>
|
|
<P>
|
|
(<B>posix-host</B>)
|
|
<P>
|
|
<P>
|
|
<P>
|
|
(<B>posix-domain</B>)
|
|
<P>
|
|
</DL>
|
|
<H3><A NAME="M8">DESCRIPTION</A></H3>
|
|
The functions of the posix library must be loaded before use with:
|
|
<PRE>(require "posix")</PRE>
|
|
The functions will not be described here completely. For full details
|
|
about a functions and its behaviour, look at the corresponding Unix
|
|
manual page or to the POSIX.1 document.
|
|
|
|
<P>
|
|
<DL>
|
|
<DT><A NAME="M9">{<I>ERROR MANAGEMENT</I>}</A><DD>
|
|
</DL>
|
|
<P>
|
|
<P>
|
|
<DL>
|
|
<DT><A NAME="M10"><B>*errno*</B></A><DD>
|
|
is a variable which always contains the error number of last
|
|
encountered error. It is equivalent to the errno POSIX.1 variable.
|
|
<P>
|
|
<DT><A NAME="M11">(<B>posix-perror</B> <I>str</I>)</A><DD>
|
|
produces a message on the standard error output, describing the last
|
|
error encountered during a call to a system or library function. The
|
|
<I>str</I> parameter is an identifying string which will be printed before
|
|
the error message.
|
|
See <B>perror(3)</B>.
|
|
|
|
<P>
|
|
<DT><A NAME="M12">{<I>FILES AND DIRECTORIES</I>}</A><DD>
|
|
</DL>
|
|
<P>
|
|
<P>
|
|
<DL>
|
|
<DT><A NAME="M13">(<B>posix-stat</B> <I>filename</I>)</A><DD>
|
|
returns a C structure which contains a description of <I>filename</I>). This
|
|
structure is not viewable by itself. Use, <B>posix-stat->vector</B>
|
|
to access its content in Scheme.If <I>filename</I> does not exists, this procedure
|
|
returns <I>#f</I>.
|
|
<P>
|
|
<DT><A NAME="M14">{(<B>posix-stat->vector</B>} <I>descr</I>)</A><DD>
|
|
transforms a file description sructure obtained by <B>posix-stat</B> to a Scheme
|
|
vector. The components of the vector are given here with their index:
|
|
<P>
|
|
</DL>
|
|
<PRE>st_dev (0) st_ino (1)
|
|
st_mode (2) st_nlink (3)
|
|
st_uid (4) st_gid (5)
|
|
st_size (6) st_atime (7)
|
|
st_mtime (8) st_ctime (9)</PRE>
|
|
<PRE>See <B>fstat(2)</B> for details on the semantic of this fields.</PRE>
|
|
<P>
|
|
<DL>
|
|
<DT><A NAME="M15">(<B>posix-access </B><I>filename mode</I>)</A><DD>
|
|
checks whether the interpreter is allowed to read, write, execute or test for
|
|
existence of <I>filename</I>. <I>Mode</I> must be one of the following constants:
|
|
<B>|R_OK|</B>, <B>|W_OK|</B>, <B>|X_OK|</B> or <B>|F_OK|</B>.
|
|
If <I>filename</I> does not exit, this function returns <B>#f</B>.
|
|
See <B>access(2)</B> for details.
|
|
<P>
|
|
<DT><A NAME="M16">(<B>posix-pipe</B>)</A><DD>
|
|
returns a pair of Scheme ports associated to a
|
|
pipe inode. If a pipe cannot be created, this function returns
|
|
<B>#f</B>.
|
|
|
|
<P>
|
|
</DL>
|
|
<P>
|
|
<B>TO BE CONTINUED</B>
|
|
<P><IMG ALIGN=TOP SRC="./Img/line-red.gif"><P>
|
|
<A HREF=./STk-hlp.html><IMG ALIGN=BOTTOM SRC="./Img/RefBookYellow.gif"> Back to the <B>STk</B> main page</A>
|
|
</BODY></HTML>
|