lihao/luafilesystem
1
0
Fork 0
mirror of https://github.com/lunarmodules/luafilesystem.git synced 2026-07-23 19:43:06 +00:00
Code Issues Packages Projects Releases Wiki Activity

Compare commits

base: lihao:v1_0b
Branches Tags
lihao:master lihao:high-precision-times lihao:gh-pages lihao:fix-101 lihao:2.0 lihao:1.7 lihao:symlink_target
lihao:v1_9_0 lihao:v1_8_0 lihao:v1_7_0_2 lihao:v1_7_0 lihao:v1_6_3 lihao:v_1_6_3 lihao:v1_6_2 lihao:v1.5.0 lihao:v1_4_2 lihao:v1_4_1 lihao:V1_4_1RC1 lihao:v1_4_0 lihao:v1_3_0 lihao:v1_2_1 lihao:v1_2_0 lihao:Root_rel_1_2_x lihao:v1_1_0 lihao:v1_0 lihao:v1_0b lihao:start
..
compare: lihao:start
Branches Tags
lihao:master lihao:high-precision-times lihao:gh-pages lihao:fix-101 lihao:2.0 lihao:1.7 lihao:symlink_target
lihao:v1_9_0 lihao:v1_8_0 lihao:v1_7_0_2 lihao:v1_7_0 lihao:v1_6_3 lihao:v_1_6_3 lihao:v1_6_2 lihao:v1.5.0 lihao:v1_4_2 lihao:v1_4_1 lihao:V1_4_1RC1 lihao:v1_4_0 lihao:v1_3_0 lihao:v1_2_1 lihao:v1_2_0 lihao:Root_rel_1_2_x lihao:v1_1_0 lihao:v1_0 lihao:v1_0b lihao:start

1 Commits
v1_0b ... start

Author SHA1 Message Date
tomas
b848b63be4 Importando 2004-07-27 14:15:24 +00:00
15 changed files with 360 additions and 719 deletions
Expand all files Collapse all files

33
Makefile
View File

@@ -1,40 +1,35 @@
# $Id: Makefile,v 1.9 2004/11/10 14:44:01 tuler Exp $ # $Id: Makefile,v 1.1.1.1 2004/07/27 14:15:24 tomas Exp $
T= lfs T= luafilesystem
include ./config include ./config
V= 1.0b V= 1.0a
DIST_DIR= luafilesystem-$V
TAR_FILE= $(DIST_DIR).tar.gz
ZIP_FILE= $(DIST_DIR).zip
LIBNAME= lib$T.$V$(LIB_EXT) LIBNAME= lib$T.$V$(LIB_EXT)
L= $T.lua
TL= t_$T.lua
SRCS= $T.c SRCS= $T.c
OBJS= $T.o compat-5.1.o OBJS= $T.o
lib: $(LIBNAME) lib: $(LIBNAME)
$(LIBNAME): $(OBJS) $(LIBNAME): $(OBJS) $(TL)
$(CC) $(CFLAGS) $(LIB_OPTION) -o $(LIBNAME) $(OBJS) $(LIBS) $(CC) $(CFLAGS) $(LIB_OPTION) -o $(LIBNAME) $(OBJS) $(LIBS)
sed -e "s|LIB_NAME|$(LIB_DIR)/$(LIBNAME)|" $(TL) > $L
compat-5.1.o: $(COMPAT_DIR)/compat-5.1.c $(LUA_DIR)/$L: $L
$(CC) -c $(CFLAGS) -o $@ $(COMPAT_DIR)/compat-5.1.c mkdir -p $(LUA_DIR)
cp $L $(LUA_DIR)
install: $(LIBNAME) install: $(LUA_DIR)/$L $(LIBNAME)
mkdir -p $(LIB_DIR) mkdir -p $(LIB_DIR)
cp $(LIBNAME) $(LIB_DIR) cp $(LIBNAME) $(LIB_DIR)
ln -f -s $(LIB_DIR)/$(LIBNAME) $(LIB_DIR)/$T$(LIB_EXT)
clean: clean:
rm -f $L $(LIBNAME) $(OBJS) rm -f $L $(LIBNAME) $(OBJS)
dist: dist_dir dist:
tar -czf $(TAR_FILE) $(DIST_DIR)
zip -rq $(ZIP_FILE) $(DIST_DIR)/*
rm -rf $(DIST_DIR)
dist_dir:
mkdir -p $(DIST_DIR) mkdir -p $(DIST_DIR)
cp config $(SRCS) $T.h $T.def Makefile *html luafilesystem.png $(DIST_DIR) cp config $(SRCS) $T.h $(TL) Makefile $(DIST_DIR)

8
config
View File

@@ -1,7 +1,6 @@
# Installation directories # Installation directories
# System's libraries directory (where binary libraries are installed) # System's libraries directory (where Lua libraries are installed)
LIB_DIR= /usr/local/lib LIB_DIR= /usr/local/lib
# System's lua directory (where Lua libraries are installed)
LUA_DIR= /usr/local/lua LUA_DIR= /usr/local/lua
# OS dependent # OS dependent
@@ -10,13 +9,12 @@ LIB_EXT= .dylib
LIB_OPTION= -dynamiclib #for MacOS X LIB_OPTION= -dynamiclib #for MacOS X
#LIB_OPTION= -shared #for Linux #LIB_OPTION= -shared #for Linux
COMPAT_DIR= .
# Compilation directives # Compilation directives
# pre-compile and include mod2.lua into mod_lua.c
# On FreeBSD systems, the following line should be commented # On FreeBSD systems, the following line should be commented
DLLIB= -ldl DLLIB= -ldl
WARN= -O2 -Wall -fPIC -W -Waggregate-return -Wcast-align -Wmissing-prototypes -Wnested-externs -Wshadow -Wwrite-strings WARN= -O2 -Wall -fPIC -W -Waggregate-return -Wcast-align -Wmissing-prototypes -Wnested-externs -Wshadow -Wwrite-strings
INCS= -I/usr/local/include/lua5 -I$(COMPAT_DIR) INCS= -I/usr/local/include/lua5
LIBS= -L$(LIB_DIR) -llua -llualib -lm $(DLLIB) LIBS= -L$(LIB_DIR) -llua -llualib -lm $(DLLIB)
CFLAGS= $(WARN) $(INCS) CFLAGS= $(WARN) $(INCS)
CC= gcc CC= gcc

148
doc/us/index.html
View File

@@ -1,122 +1,114 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2//EN">
<html> <html>
<head> <head>
<meta name="generator" content="HTML Tidy, see www.w3.org">
<title>LuaFileSystem</title> <title>LuaFileSystem</title>
<style type="text/css"> <style type="text/css">
ul { list-style-type: disc }; ul { list-style-type: disc };
</style> </style>
</head> </head>
<body bgcolor="#FFFFFF"> <body bgcolor="#FFFFFF">
<center> <center>
<table border="0" cellspacing="2" cellpadding="2"> <table border=0 cellspacing=2 cellpadding=2>
<tr> <tr><td align=center><a href="http://www.keplerproject.org">
<td align="center"><a href="http://www.keplerproject.org"><img <img border=0 alt="LuaFileSystem" src="luafilesystem.png"></a>
border="0" alt="LuaFileSystem" src="luafilesystem.png"></a> </td> <tr><td align=center><big><b>LuaFileSystem</b></big>
</tr> <tr><td align=center valign=top>File system library for the
<a href="http://www.lua.org">Lua</a>
<tr> programming language
<td align="center"><big><b>LuaFileSystem</b></big> </td>
</tr>
<tr>
<td align="center" valign="top">File System Library for the <a
href="http://www.lua.org">Lua</a> Programming Language</td>
</tr>
</table> </table>
</center> </center>
<p>
<center><small><a href="#over">overview</a> &middot; <a href= <center><small>
"#download">download</a> &middot; <a href="manual.html">manual</a> <a href="#over">overview</a> &middot;
&middot; <a href="#credits">credits</a> &middot; <a href= <a href="#download">download</a> &middot;
"#contact">contact us</a></small></center> <a href="manual.html">manual</a> &middot;
<a href="#credits">credits</a> &middot;
<a href="#contact">contact us</a>
</small></center>
<p>
<hr> <hr>
<h2>Contents</h2> <h2>Contents</h2>
<p>
<ul> <ul>
<li><a href="#over">Overview</a></li> <li> <a href="#over">Overview</a>
<li> <a href="#version">Current Version</a>
<li><a href="#version">Current Version</a></li> <li> <a href="#download">Download</a>
<li> <a href="#manual">Manual</a>
<li><a href="#download">Download</a></li> <li> <a href="#credits">Credits</a>
<li> <a href="#contact">Contact us</a>
<li><a href="#manual">Manual</a></li>
<li><a href="#credits">Credits</a></li>
<li><a href="#contact">Contact us</a></li>
</ul> </ul>
<a name="over"></a> <a name="over"></a>
<h2>Overview</h2> <h2>Overview</h2>
<p>
LuaFileSystem is a library developed to complement the set of functions
related to file systems offered by the standard Lua distribution.
One of its goals is to be as portable as Lua.
<p>
LuaFileSystem is free software and uses the same
<a href="license.html">license</a>
as Lua 5.0.
<p>LuaFileSystem is a library developed to complement the set of
functions related to file systems offered by the standard Lua
distribution. One of its goals is to be as portable as Lua.</p>
<p>LuaFileSystem is free software and uses the same <a href=
"license.html">license</a> as Lua 5.0. <a name="version"></a></p>
<a name="version"></a>
<h2>Current version</h2> <h2>Current version</h2>
<p>
Current version is 1.0 alpha.
It was developed for Lua 5.0.
</p>
<p>Current version is 1.0 beta. It was developed for Lua 5.0.</p>
<p>Version 1.0 follows the <a href=
"http://www.keplerproject.org/compat">package proposal</a> for Lua
5.1 (see section <a href="#installation">Installation</a> for more
details). <a name="download"></a></p>
<a name="download"></a>
<h2>Download</h2> <h2>Download</h2>
<p>
<p>LuaFileSystem can be downloaded from its <a href= LuaFileSystem can be downloaded in source code from the following links:
"http://luaforge.net/project/showfiles.php?group_id=66">Lua <p>
Forge</a> page. <a name="new"></a></p>
<h2>What's new</h2>
<ul> <ul>
<li>[10/nov/2004] Version 1.0 beta released</li> <li><a href="luafilesystem-1.0a.tar.gz">luafilesystem-1.0a.tar.gz</a>.
<li><a href="luafilesystem-1.0a.zip">luafilesystem-1.0a.zip</a>.
</ul> </ul>
<a name="installation"></a>
<h2>Installation</h2> <a name="new"></a>
<h2>What's new</h2>
<p>
<ul>
<li>[2/Aug/2004] Version 1.0 alpha released
</ul>
<p>LuaFileSystem is distributed as a pair of C source and header
files. The distribution provides a <tt>Makefile</tt> prepared to
compile the library and install it. The file <tt>config</tt> should
be edited to suit the needs of the aimed platform.</p>
<p>LuaFileSystem follows the <a href=
"http://www.keplerproject.org/compat">package proposal</a> for Lua
5.1, therefore this package should be "installed". In other words,
if you are using Lua 5.0, the files <tt>compat-5.1.c</tt> and
<tt>compat-5.1.h</tt> must be used in the compilation and the file
<tt>compat-5.1.lua</tt> must be installed in the <tt>LUA_PATH</tt>.
If you are using Lua 5.1, nothing should be done.</p>
<a name="credits"></a> <a name="credits"></a>
<h2>Credits</h2> <h2>Credits</h2>
<p>LuaFileSystem was designed by Roberto Ierusalimschy, <p>
Andr&eacute; Carregal and Tom&aacute;s Guisasola as part of <a LuaFileSystem was designed by Roberto Ierusalimschy,
href="http://www.keplerproject.org">The Kepler Project</a> which Andr&eacute; Carregal and Tom&aacute;s Guisasola as part of
holds its copyright.</p> <a href="http://www.keplerproject.org">The Kepler Project</a>
which holds its copyright.
</p>
<a name="contact"></a> <a name="contact"></a>
<h2>Contact us</h2> <h2>Contact us</h2>
<p>For more information please <a href= <p>
"mailto:info-NO-SPAM-THANKS@keplerproject.org">contact us</a>. For more information please
Comments are welcome!</p> <a href="mailto:tomas-NO-SPAM-THANKS@keplerproject.org">contact us</a>.
Comments are welcome!
</p>
<p>
<hr> <hr>
<small>$Id: index.html,v 1.6 2004/11/11 15:33:20 tomas Exp <small>
$</small> $Id: index.html,v 1.1.1.1 2004/07/27 14:15:24 tomas Exp $
</small>
</body> </body>
</html> </html>

122
doc/us/license.html
View File

@@ -1,68 +1,78 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2//EN"> <! See Copyright Notice at the end of this file>
<html> <HTML>
<head> <HEAD>
<meta name="generator" content="HTML Tidy, see www.w3.org"> <TITLE>LuaFileSystem: license</TITLE>
<title>LuaFileSystem: license</title> </HEAD>
</head>
<body bgcolor="#FFFFFF">
<hr>
<h1>License</h1>
LuaFileSystem is free software: it can be used for both academic <BODY BGCOLOR="#FFFFFF">
and commercial purposes at absolutely no cost. There are no
royalties or GNU-like "copyleft" restrictions. LuaFileSystem
qualifies as <a href=
"http://www.opensource.org/docs/definition.html">Open Source</a>
software. Its licenses are compatible with <a href=
"http://www.gnu.org/licenses/gpl.html">GPL</a>. LuaFileSystem is
not in the public domain and <a href=
"http://www.keplerproject.org">The Kepler Project</a> keep its
copyright. The legal details are below.
<p>The spirit of the license is that you are free to use <HR>
LuaFileSystem for any purpose at no cost without having to ask us. <H1>
The only requirement is that if you do use LuaFileSystem, then you License
should give us credit by including the appropriate copyright notice </H1>
somewhere in your product or its documentation.</p>
<p>The LuaFileSystem library is designed and implemented by Roberto LuaFileSystem
Ierusalimschy, Andr&eacute; Carregal and Tom&aacute;s Guisasola. is free software:
The implementation is not derived from licensed software.</p> it can be used for both academic and commercial purposes at absolutely no cost.
There are no royalties or GNU-like "copyleft" restrictions.
LuaFileSystem qualifies as
<A HREF="http://www.opensource.org/docs/definition.html">Open Source</A>
software.
Its licenses are compatible with
<A HREF="http://www.gnu.org/licenses/gpl.html">GPL</A>.
LuaFileSystem is not in the public domain and
<a href="http://www.keplerproject.org">The Kepler Project</a>
keep its copyright.
The legal details are below.
<P>
The spirit of the license is that
you are free to use LuaFileSystem for any purpose at no cost without having to ask us.
The only requirement is that
if you do use LuaFileSystem,
then you should give us credit by including the appropriate copyright notice
somewhere in your product or its documentation.
<P>
The LuaFileSystem library is designed and implemented
by
Roberto Ierusalimschy,
Andr&eacute; Carregal and
Tom&aacute;s Guisasola.
The implementation is not derived from licensed software.
<P>
<p>
<!-- ===================================================================== --> <!-- ===================================================================== -->
</p> <HR>
<hr>
Copyright &copy; 2004 The Kepler Project. Copyright &copy; 2004 The Kepler Project.
<P>
<p>Permission is hereby granted, free of charge, to any person Permission is hereby granted, free of charge, to any person obtaining a copy
obtaining a copy of this software and associated documentation of this software and associated documentation files (the "Software"), to deal
files (the "Software"), to deal in the Software without in the Software without restriction, including without limitation the rights
restriction, including without limitation the rights to use, copy, to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
modify, merge, publish, distribute, sublicense, and/or sell copies copies of the Software, and to permit persons to whom the Software is
of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
furnished to do so, subject to the following conditions:</p> <P>
<p>The above copyright notice and this permission notice shall be The above copyright notice and this permission notice shall be included in
included in all copies or substantial portions of the Software.</p> all copies or substantial portions of the Software.
<P>
<p>THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE THE SOFTWARE.
SOFTWARE.</p> <P>
<p>
<!-- ===================================================================== --> <!-- ===================================================================== -->
</p> <HR>
<SMALL>
<hr> $Id: license.html,v 1.1.1.1 2004/07/27 14:15:24 tomas Exp $
<small>$Id: license.html,v 1.1.1.1 2004/07/27 14:15:24 tomas Exp </SMALL>
$</small>
</body>
</html>
</BODY>
</HTML>

BIN
doc/us/luafilesystem.png
View File

Binary file not shown.
Side by Side

Before

Width:  |  Height:  |  Size: 8.3 KiB

249
doc/us/manual.html
View File

@@ -1,197 +1,144 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <! See Copyright Notice in license.html>
<html> <html>
<head> <head>
<meta name="generator" content="HTML Tidy, see www.w3.org">
<title>LuaFileSystem</title> <title>LuaFileSystem</title>
<style type="text/css"> <style type="text/css">
ul { list-style-type: disc }; ul { list-style-type: disc };
</style> </style>
</head> </head>
<body bgcolor="#FFFFFF"> <body bgcolor="#FFFFFF">
<hr> <hr>
<center> <center>
<table border="0" cellspacing="2" cellpadding="2"> <table border=0 cellspacing=2 cellpadding=2>
<tr> <tr><td align=center><a href="http://www.keplerproject.org/luafilesystem">
<td align="center"><a href= <img border=0 alt="LuaFileSystem logo" src="luafilesystem.png"></a>
"http://www.keplerproject.org/luafilesystem"><img border="0" alt= <tr><td align=center><big><b>LuaFileSystem Reference Manual</b></big>
"LuaFileSystem logo" src="luafilesystem.png"></a> </td> <tr><td align=center valign=top>File system library for the
</tr> <a href="http://www.lua.org">Lua</a>
programming language
<tr>
<td align="center"><big><b>LuaFileSystem Reference Manual</b></big>
</td>
</tr>
<tr>
<td align="center" valign="top">File system library for the <a
href="http://www.lua.org">Lua</a> programming language</td>
</tr>
</table> </table>
</center> </center>
<p>
<center><small><a href="index.html">home</a> &middot; <a href= <center><small>
"#introduction">introduction</a> &middot; <a href= <a href="index.html">home</a> &middot;
"#reference">reference</a> &middot; <a href= <a href="#introduction">introduction</a> &middot;
"#example">example</a></small></center> <a href="#reference">reference</a> &middot;
<a href="#example">example</a>
</small></center>
<p>
<hr> <hr>
<a name="introduction"></a>
<a name="introduction"></a>
<h2>Introduction</h2> <h2>Introduction</h2>
<p>LuaFileSystem is a <a href="http://www.lua.org">Lua</a> library <p>
developed to complement the set of functions related to file LuaFileSystem is a <a href="http://www.lua.org">Lua</a> library
systems offered by the standard Lua distribution.</p> developed to complement the set of functions related to file systems offered
by the standard Lua distribution.
<p>
LuaFileSystem is free software and uses the same
<a href="license.html">license</a>
as Lua 5.0.
</p>
<p>LuaFileSystem is free software and uses the same <a href=
"license.html">license</a> as Lua 5.0.</p>
<a name="reference"></a> <a name="reference"></a>
<h2>Reference</h2> <h2>Reference</h2>
<p>LuaFileSystem offers the following functions:</p> <p>
LuaFileSystem offers the following functions:
<ul> <ul>
<li style="list-style: none"><a name="attributes"></a></li> <a name="chdir"></a>
<li> <b><tt>luafilesystem.chdir (path)</tt></b> <br>
Changes the current
working directory to the given <tt>path</tt>.
<li><b><tt>lfs.attributes (filepath)</tt></b><br> <a name="getcwd"></a>
Obtains the file attributes. The attributes are: <li> <b><tt>luafilesystem.currentdir ()</tt></b> <br>
Returns the current
working directory or <code>nil</code> plus an error string.
<div style="margin-left: 2em"><i>dev</i>, device inode resides <a name="dir"></a>
on;<br> <li> <b><tt>luafilesystem.dir (path)</tt></b> <br>
<i>ino</i>, inode's number;<br> Lua iterator over the entries
<i>mode</i>, inode protection mode (<small>values could be of a given directory.
<tt>file</tt>, <tt>directory</tt>, <tt>link</tt>, <tt>socket</tt>,
<tt>named pipe</tt>, <tt>char device</tt>, <tt>block device</tt> or
<tt>other</tt></small>);<br>
<i>nlink</i>, number of hard links to the file;<br>
<i>uid</i>, user-id of owner;<br>
<i>gid</i>, group-id of owner;<br>
<i>rdev</i>, device type, for special file inode;<br>
<i>access</i>, time of last access;<br>
<i>modification</i>, time of last data modification;<br>
<i>change</i>, time of last file status change;<br>
<i>size</i>, file size, in bytes;<br>
<i>blocks</i>, block allocated for file; (Unix only)<br>
<i>blksize</i>, optimal file system I/O blocksize; (Unix only)<br>
</div>
Returns a table with file attributes described above. <a name= <a name="lock"></a>
"chdir"></a></li> <li> <b><tt>luafilesystem.lock (filehandle, mode[, start[, length]])</tt></b> <br>
Locks a file or a part of it.
This function works on <em>open files</em>;
the file handle should be specified as the first argument.
The string <code>mode</code> could be either <code>r</code> (for a
read/shared lock) or <code>w</code> (for a write/exclusive lock).
The optional arguments <code>start</code> and <code>length</code> can be
used to specify a starting point and its length;
both should be numbers.
This function returns a boolean indicating if the operation was successful;
in case of error, it returns <code>false</code> plus a string describing the
error.
<li><b><tt>lfs.chdir (path)</tt></b><br> <a name="mkdir"></a>
Changes the current working directory to the given <li> <b><tt>luafilesystem.mkdir (dirname)</tt></b> <br>
<tt>path</tt>.<br> Creates a new directory.
Returns <tt>true</tt> in case of success or <tt>nil</tt> plus an The argument is the name of the new directory.
error string. <a name="getcwd"></a></li>
<li><b><tt>lfs.currentdir ()</tt></b><br> <a name="unlock"></a>
Returns a string with the current working directory or <li> <b><tt>luafilesystem.unlock (filehandle[, start[, length]])</tt></b> <br>
<code>nil</code> plus an error string. <a name="dir"></a></li> Unlocks a file or a part of it.
This function works on <em>open files</em>;
the file handle should be specified as the first argument.
The optional arguments <code>start</code> and <code>length</code> can be
used to specify a starting point and its length;
both should be numbers.
This function returns a boolean indicating if the operation was successful;
in case of error, it returns <code>false</code> plus a string describing the
error.
<li><b><tt>lfs.dir (path)</tt></b><br>
Lua iterator over the entries of a given directory. Raises an
error if <tt>path</tt> is not a directory. <a name="lock"></a></li>
<li><b><tt>lfs.lock (filehandle, mode[, start[,
length]])</tt></b><br>
Locks a file or a part of it. This function works on <em>open
files</em>; the file handle should be specified as the first
argument. The string <code>mode</code> could be either
<code>r</code> (for a read/shared lock) or <code>w</code> (for a
write/exclusive lock). The optional arguments <code>start</code>
and <code>length</code> can be used to specify a starting point and
its length; both should be numbers.<br>
Returns a boolean indicating if the operation was successful; in
case of error, it returns <code>false</code> plus an error string.
<a name="mkdir"></a></li>
<li><b><tt>lfs.mkdir (dirname)</tt></b><br>
Creates a new directory. The argument is the name of the new
directory.<br>
Returns a boolean indicating whether the operation succeeds or not
(in this case, an error string is returned too). <a name=
"unlock"></a></li>
<li><b><tt>lfs.unlock (filehandle[, start[, length]])</tt></b><br>
Unlocks a file or a part of it. This function works on <em>open
files</em>; the file handle should be specified as the first
argument. The optional arguments <code>start</code> and
<code>length</code> can be used to specify a starting point and its
length; both should be numbers.<br>
Returns a boolean indicating if the operation was successful; in
case of error, it returns <code>false</code> plus a string
describing the error.</li>
</ul> </ul>
<a name="example"></a> <a name="example"></a>
<h2>Example</h2> <h2>Example</h2>
<pre>
require"lfs"
function attrdir (path)
for file in lfs.dir(path) do
if file ~= "." and file ~= ".." then
local f = path..'/'..file
print ("\t "..f)
local attr = lfs.attributes (f)
assert (type(attr) == "table")
if attr.mode == "directory" then
attrdir (f)
else
for name, value in pairs(attr) do
print (name, value)
end
end
end
end
end
attrdir (".")
</pre>
<a name="contents"></a> <a name="contents"></a>
<h2>Contents</h2> <h2>Contents</h2>
<p>
<ul> <ul>
<li><a href="#introduction">Introduction</a></li> <li> <a href="#introduction">Introduction</a>
<li> <a href="#reference">Reference</a>
<li><a href="#reference">Reference</a> <ul>
<li> <a href="#chdir">chdir</a>
<ul> <li> <a href="#currentdir">currentdir</a>
<li><a href="#chdir">chdir</a></li> <li> <a href="#dir">dir</a>
<li> <a href="#lock">lock</a>
<li><a href="#currentdir">currentdir</a></li> <li> <a href="#mkdir">mkdir</a>
<li> <a href="#unlock">unlock</a>
<li><a href="#dir">dir</a></li> </ul>
<li> <a href="#examples">Examples</a>
<li><a href="#lock">lock</a></li>
<li><a href="#mkdir">mkdir</a></li>
<li><a href="#unlock">unlock</a></li>
</ul> </ul>
</li> </p>
<li><a href="#examples">Examples</a></li>
</ul>
<br>
<br>
<center><small><a href="index.html">home</a> &middot; <a href= <p>
"#introduction">introduction</a> &middot; <a href= <center><small>
"#reference">reference</a> &middot; <a href= <a href="index.html">home</a> &middot;
"#example">example</a></small></center> <a href="#introduction">introduction</a> &middot;
<a href="#reference">reference</a> &middot;
<a href="#example">example</a>
</small></center>
<p>
<hr> <hr>
<small>$Id: manual.html,v 1.7 2004/11/10 14:09:45 tuler Exp <small>
$</small> $Id: manual.html,v 1.1.1.1 2004/07/27 14:15:24 tomas Exp $
</small>
</body> </body>
</html> </html>

177
src/lfs.c → luafilesystem.c
View File

@@ -1,22 +1,21 @@
/* /*
** File system manipulation library. ** File system manipulation library.
** This library offers these functions: ** This library offers these functions:
** lfs.attributes (filepath [, attributename]) ** luafilesystem.attributes (filepath [, attributename])
** lfs.chdir (path) ** luafilesystem.chdir (path)
** lfs.currentdir () ** luafilesystem.currentdir ()
** lfs.dir (path) ** luafilesystem.dir (path)
** lfs.mkdir (path) ** luafilesystem.mkdir (path)
** lfs.lock (fh, mode) ** luafilesystem.lock (fh, mode)
** lfs.unlock (fh) ** luafilesystem.unlock (fh)
** **
** $Id: lfs.c,v 1.14 2004/11/17 14:08:04 tomas Exp $ ** $Id: luafilesystem.c,v 1.1.1.1 2004/07/27 14:15:24 tomas Exp $
*/ */
#include <errno.h> #include <errno.h>
#include <stdio.h> #include <stdio.h>
#include <string.h> #include <string.h>
#include <time.h> #include <time.h>
#include <sys/stat.h>
#ifdef WIN32 #ifdef WIN32
#include <direct.h> #include <direct.h>
@@ -27,14 +26,14 @@
#include <dirent.h> #include <dirent.h>
#include <fcntl.h> #include <fcntl.h>
#include <sys/types.h> #include <sys/types.h>
#include <sys/stat.h>
#endif #endif
#include "lua.h" #include <lua.h>
#include "lauxlib.h" #include <lauxlib.h>
#include "lualib.h" #include <lualib.h>
#include "compat-5.1.h"
#include "lfs.h" #include "luafilesystem.h"
/* Define 'strerror' for systems that do not implement it */ /* Define 'strerror' for systems that do not implement it */
#ifdef NO_STRERROR #ifdef NO_STRERROR
@@ -64,15 +63,10 @@ typedef struct dir_data {
*/ */
static int change_dir (lua_State *L) { static int change_dir (lua_State *L) {
const char *path = luaL_checkstring(L, 1); const char *path = luaL_checkstring(L, 1);
if (chdir(path)) { if (chdir(path))
lua_pushnil (L); luaL_error(L,"Unable to change working directory to '%s'\n%s\n",
lua_pushfstring (L,"Unable to change working directory to '%s'\n%s\n",
path, chdir_error); path, chdir_error);
return 2; return 0;
} else {
lua_pushboolean (L, 1);
return 1;
}
} }
/* /*
@@ -238,11 +232,7 @@ static int make_dir (lua_State *L) {
fail = mkdir (path, S_IRUSR | S_IWUSR | S_IXUSR | S_IRGRP | fail = mkdir (path, S_IRUSR | S_IWUSR | S_IXUSR | S_IRGRP |
S_IWGRP | S_IXGRP | S_IROTH | S_IXOTH ); S_IWGRP | S_IXGRP | S_IROTH | S_IXOTH );
#endif #endif
lua_pushboolean (L, !fail); lua_pushboolean (L, fail);
if (fail) {
lua_pushfstring (L, "%s", strerror(errno));
return 2;
}
umask (oldmask); umask (oldmask);
return 1; return 1;
} }
@@ -344,135 +334,7 @@ static int dir_create_meta (lua_State *L) {
} }
#ifdef _WIN32
#define S_ISDIR(mode) (mode&_S_IFDIR)
#define S_ISREG(mode) (mode&_S_IFREG)
#define S_ISLNK(mode) (0)
#define S_ISSOCK(mode) (0)
#define S_ISFIFO(mode) (0)
#define S_ISCHR(mode) (mode&_S_IFCHR)
#define S_ISBLK(mode) (0)
#endif
/*
** Convert the inode protection mode to a string.
*/
#ifdef WIN32
static const char *mode2string (unsigned short mode) {
#else
static const char *mode2string (mode_t mode) {
#endif
if ( S_ISREG(mode) )
return "file";
else if ( S_ISDIR(mode) )
return "directory";
else if ( S_ISLNK(mode) )
return "link";
else if ( S_ISSOCK(mode) )
return "socket";
else if ( S_ISFIFO(mode) )
return "named pipe";
else if ( S_ISCHR(mode) )
return "char device";
else if ( S_ISBLK(mode) )
return "block device";
else
return "other";
}
/*
** Get file information
*/
static int file_info (lua_State *L) {
struct stat info;
const char *file = luaL_checkstring (L, 1);
if (stat(file, &info)) {
lua_pushnil (L);
lua_pushfstring (L, "cannot obtain information from file `%s'", file);
return 2;
}
lua_newtable (L);
/* device inode resides on */
lua_pushliteral (L, "dev");
lua_pushnumber (L, (lua_Number)info.st_dev);
lua_rawset (L, -3);
/* inode's number */
lua_pushliteral (L, "ino");
lua_pushnumber (L, (lua_Number)info.st_ino);
lua_rawset (L, -3);
/* inode protection mode */
lua_pushliteral (L, "mode");
lua_pushstring (L, mode2string (info.st_mode));
lua_rawset (L, -3);
/* number of hard links to the file */
lua_pushliteral (L, "nlink");
lua_pushnumber (L, (lua_Number)info.st_nlink);
lua_rawset (L, -3);
/* user-id of owner */
lua_pushliteral (L, "uid");
lua_pushnumber (L, (lua_Number)info.st_uid);
lua_rawset (L, -3);
/* group-id of owner */
lua_pushliteral (L, "gid");
lua_pushnumber (L, (lua_Number)info.st_gid);
lua_rawset (L, -3);
/* device type, for special file inode */
lua_pushliteral (L, "rdev");
lua_pushnumber (L, (lua_Number)info.st_rdev);
lua_rawset (L, -3);
/* time of last access */
lua_pushliteral (L, "access");
lua_pushnumber (L, info.st_atime);
lua_rawset (L, -3);
/* time of last data modification */
lua_pushliteral (L, "modification");
lua_pushnumber (L, info.st_mtime);
lua_rawset (L, -3);
/* time of last file status change */
lua_pushliteral (L, "change");
lua_pushnumber (L, info.st_ctime);
lua_rawset (L, -3);
/* file size, in bytes */
lua_pushliteral (L, "size");
lua_pushnumber (L, (lua_Number)info.st_size);
lua_rawset (L, -3);
#ifndef WIN32
/* blocks allocated for file */
lua_pushliteral (L, "blocks");
lua_pushnumber (L, (lua_Number)info.st_blocks);
lua_rawset (L, -3);
/* optimal file system I/O blocksize */
lua_pushliteral (L, "blksize");
lua_pushnumber (L, (lua_Number)info.st_blksize);
lua_rawset (L, -3);
#endif
return 1;
}
/*
** Assumes the table is on top of the stack.
*/
static void set_info (lua_State *L) {
lua_pushliteral (L, "_COPYRIGHT");
lua_pushliteral (L, "Copyright (C) 2004 Kepler Project");
lua_settable (L, -3);
lua_pushliteral (L, "_DESCRIPTION");
lua_pushliteral (L, "LuaFileSystem is a Lua library developed to complement the set of functions related to file systems offered by the standard Lua distribution");
lua_settable (L, -3);
lua_pushliteral (L, "_NAME");
lua_pushliteral (L, "LuaFileSystem");
lua_settable (L, -3);
lua_pushliteral (L, "_VERSION");
lua_pushliteral (L, "1.0b");
lua_settable (L, -3);
}
static const struct luaL_reg fslib[] = { static const struct luaL_reg fslib[] = {
{"attributes", file_info},
{"chdir", change_dir}, {"chdir", change_dir},
{"currentdir", get_dir}, {"currentdir", get_dir},
{"dir", dir_iter_factory}, {"dir", dir_iter_factory},
@@ -482,9 +344,8 @@ static const struct luaL_reg fslib[] = {
{NULL, NULL}, {NULL, NULL},
}; };
int luaopen_lfs (lua_State *L) { int luaopen_luafilesystem (lua_State *L) {
dir_create_meta (L); dir_create_meta (L);
luaL_openlib (L, "lfs", fslib, 0); luaL_openlib (L, "luafilesystem", fslib, 0);
set_info (L);
return 1; return 1;
} }

5
luafilesystem.def Normal file
View File

@@ -0,0 +1,5 @@
LIBRARY luafilesystem.dll
DESCRIPTION "LuaFilesystem"
VERSION 1.0
EXPORTS
luaopen_luafilesystem

4
src/lfs.h → luafilesystem.h
View File

@@ -1,5 +1,5 @@
/* Define 'chdir' for systems that do not implement it */ /* Define 'chdir' for systems that do not implement it */
/* $Id: lfs.h,v 1.1 2004/07/29 14:26:33 tomas Exp $ */ /* $Id: luafilesystem.h,v 1.1.1.1 2004/07/27 14:15:24 tomas Exp $ */
#ifdef NO_CHDIR #ifdef NO_CHDIR
#define chdir(p) (-1) #define chdir(p) (-1)
#define chdir_error "Function 'chdir' not provided by system" #define chdir_error "Function 'chdir' not provided by system"
@@ -7,4 +7,4 @@
#define chdir_error strerror(errno) #define chdir_error strerror(errno)
#endif #endif
int luaopen_lfs (lua_State *L); int luaopen_filesystem (lua_State *L);

8
t_luafilesystem.lua Normal file
View File

@@ -0,0 +1,8 @@
-- $Id: t_luafilesystem.lua,v 1.1.1.1 2004/07/27 14:15:24 tomas Exp $
if not luafilesystem and loadlib then
local libname = "LIB_NAME"
local libopen = "luaopen_luafilesystem"
local init, err1, err2 = loadlib (libname, libopen)
assert (init, (err1 or '')..(err2 or ''))
init ()
end

26
teste.lua Normal file
View File

@@ -0,0 +1,26 @@
#!/usr/local/bin/lua -i
require"luafilesystem"
print(luafilesystem.version)
function p ()
local fh = assert (io.open ("teste", 'r'))
assert (luafilesystem.lock (fh, 'r'))
print (fh:read"*a")
fh:close ()
end
function wr ()
fh = assert (io.open ("teste", 'w'))
assert (luafilesystem.lock (fh, 'w'))
end
function op ()
fh = assert (io.open ("teste", 'r'))
assert (luafilesystem.lock (fh, 'r'))
end
function fw (x)
assert (fh:write (x))
end

40
tests/test.lua
View File

@@ -1,40 +0,0 @@
#!/usr/local/bin/lua
local tmp = "/tmp"
local sep = "/"
local upper = ".."
require"lfs"
function attrdir (path)
for file in lfs.dir(path) do
if file ~= "." and file ~= ".." then
local f = path..'/'..file
print ("\t=> "..f.." <=")
local attr = lfs.attributes (f)
assert (type(attr) == "table")
if attr.mode == "directory" then
attrdir (f)
else
for name, value in pairs(attr) do
print (name, value)
end
end
end
end
end
-- Checking changing directories
local current = assert (lfs.currentdir())
local reldir = string.gsub (current, "^.*%"..sep.."([^"..sep.."])$", "%1")
assert (lfs.chdir (upper), "could not change to upper directory")
assert (lfs.chdir (reldir), "could not change back to current directory")
assert (lfs.currentdir() == current, "error trying to change directories")
assert (lfs.chdir ("this couldn't be an actual directory") == nil, "could change to a non-existent directory")
-- Changing creating and removing directories
assert (lfs.mkdir (tmp.."/lfs_tmp_dir"), "could not make a new directory")
assert (os.remove (tmp.."/lfs_tmp_dir"), "could not remove new directory")
assert (lfs.mkdir (tmp.."/lfs_tmp_dir/lfs_tmp_dir") == false, "could create a directory inside a non-existent one")
--
assert (lfs.attributes ("this couldn't be an actual file") == nil, "could get attributes of a non-existent file")
assert (type(lfs.attributes (upper)) == "table", "couldn't get attributes of upper directory")

5
vc6/lfs.def
View File

@@ -1,5 +0,0 @@
LIBRARY lfs.dll
DESCRIPTION "LuaFileSystem"
VERSION 1.0
EXPORTS
luaopen_lfs

33
vc6/luafilesystem.dsw
View File

@@ -1,33 +0,0 @@
Microsoft Developer Studio Workspace File, Format Version 6.00
# WARNING: DO NOT EDIT OR DELETE THIS WORKSPACE FILE!
###############################################################################
Project: "luafilesystem_dll"=.\luafilesystem_dll.dsp - Package Owner=<4>
Package=<5>
{{{
begin source code control
luafilesystem
..
end source code control
}}}
Package=<4>
{{{
}}}
###############################################################################
Global:
Package=<5>
{{{
}}}
Package=<3>
{{{
}}}
###############################################################################

123
vc6/luafilesystem_dll.dsp
View File

@@ -1,123 +0,0 @@
# Microsoft Developer Studio Project File - Name="luafilesystem_dll" - Package Owner=<4>
# Microsoft Developer Studio Generated Build File, Format Version 6.00
# ** DO NOT EDIT **
# TARGTYPE "Win32 (x86) Dynamic-Link Library" 0x0102
CFG=luafilesystem_dll - Win32 Debug
!MESSAGE This is not a valid makefile. To build this project using NMAKE,
!MESSAGE use the Export Makefile command and run
!MESSAGE
!MESSAGE NMAKE /f "luafilesystem_dll.mak".
!MESSAGE
!MESSAGE You can specify a configuration when running NMAKE
!MESSAGE by defining the macro CFG on the command line. For example:
!MESSAGE
!MESSAGE NMAKE /f "luafilesystem_dll.mak" CFG="luafilesystem_dll - Win32 Debug"
!MESSAGE
!MESSAGE Possible choices for configuration are:
!MESSAGE
!MESSAGE "luafilesystem_dll - Win32 Release" (based on "Win32 (x86) Dynamic-Link Library")
!MESSAGE "luafilesystem_dll - Win32 Debug" (based on "Win32 (x86) Dynamic-Link Library")
!MESSAGE
# Begin Project
# PROP AllowPerConfigDependencies 0
# PROP Scc_ProjName "luafilesystem_dll"
# PROP Scc_LocalPath ".."
CPP=cl.exe
MTL=midl.exe
RSC=rc.exe
!IF "$(CFG)" == "luafilesystem_dll - Win32 Release"
# PROP BASE Use_MFC 0
# PROP BASE Use_Debug_Libraries 0
# PROP BASE Output_Dir "Release"
# PROP BASE Intermediate_Dir "Release"
# PROP BASE Target_Dir ""
# PROP Use_MFC 0
# PROP Use_Debug_Libraries 0
# PROP Output_Dir "../lib/vc6"
# PROP Intermediate_Dir "luafilesystem_dll/Release"
# PROP Ignore_Export_Lib 0
# PROP Target_Dir ""
# ADD BASE CPP /nologo /MT /W3 /GX /O2 /D "WIN32" /D "NDEBUG" /D "_WINDOWS" /D "_MBCS" /D "_USRDLL" /D "LUAFILESYSTEM_EXPORTS" /YX /FD /c
# ADD CPP /nologo /MD /W3 /GX /O2 /I "../../lua/include" /I "../../compat" /D "WIN32" /D "NDEBUG" /D "_WINDOWS" /D "_MBCS" /D "_USRDLL" /D "LUAFILESYSTEM_EXPORTS" /YX /FD /c
# ADD BASE MTL /nologo /D "NDEBUG" /mktyplib203 /win32
# ADD MTL /nologo /D "NDEBUG" /mktyplib203 /win32
# ADD BASE RSC /l 0x416 /d "NDEBUG"
# ADD RSC /l 0x416 /d "NDEBUG"
BSC32=bscmake.exe
# ADD BASE BSC32 /nologo
# ADD BSC32 /nologo
LINK32=link.exe
# ADD BASE LINK32 kernel32.lib user32.lib gdi32.lib winspool.lib comdlg32.lib advapi32.lib shell32.lib ole32.lib oleaut32.lib uuid.lib odbc32.lib odbccp32.lib /nologo /dll /machine:I386
# ADD LINK32 lua50.lib lualib50.lib kernel32.lib user32.lib gdi32.lib winspool.lib comdlg32.lib advapi32.lib shell32.lib ole32.lib oleaut32.lib uuid.lib odbc32.lib odbccp32.lib /nologo /dll /machine:I386 /out:"../bin/vc6/lfs.dll" /libpath:"../../lua/lib/vc6"
!ELSEIF "$(CFG)" == "luafilesystem_dll - Win32 Debug"
# PROP BASE Use_MFC 0
# PROP BASE Use_Debug_Libraries 1
# PROP BASE Output_Dir "Debug"
# PROP BASE Intermediate_Dir "Debug"
# PROP BASE Target_Dir ""
# PROP Use_MFC 0
# PROP Use_Debug_Libraries 1
# PROP Output_Dir "../lib/vc6"
# PROP Intermediate_Dir "luafilesystem_dll/Debug"
# PROP Ignore_Export_Lib 0
# PROP Target_Dir ""
# ADD BASE CPP /nologo /MTd /W3 /Gm /GX /ZI /Od /D "WIN32" /D "_DEBUG" /D "_WINDOWS" /D "_MBCS" /D "_USRDLL" /D "LUAFILESYSTEM_EXPORTS" /YX /FD /GZ /c
# ADD CPP /nologo /MDd /W3 /Gm /GX /ZI /Od /I "../../lua/include" /I "../../compat" /D "WIN32" /D "_DEBUG" /D "_WINDOWS" /D "_MBCS" /D "_USRDLL" /D "LUAFILESYSTEM_EXPORTS" /YX /FD /GZ /c
# ADD BASE MTL /nologo /D "_DEBUG" /mktyplib203 /win32
# ADD MTL /nologo /D "_DEBUG" /mktyplib203 /win32
# ADD BASE RSC /l 0x416 /d "_DEBUG"
# ADD RSC /l 0x416 /d "_DEBUG"
BSC32=bscmake.exe
# ADD BASE BSC32 /nologo
# ADD BSC32 /nologo
LINK32=link.exe
# ADD BASE LINK32 kernel32.lib user32.lib gdi32.lib winspool.lib comdlg32.lib advapi32.lib shell32.lib ole32.lib oleaut32.lib uuid.lib odbc32.lib odbccp32.lib /nologo /dll /debug /machine:I386 /pdbtype:sept
# ADD LINK32 lua50d.lib lualib50d.lib kernel32.lib user32.lib gdi32.lib winspool.lib comdlg32.lib advapi32.lib shell32.lib ole32.lib oleaut32.lib uuid.lib odbc32.lib odbccp32.lib /nologo /dll /debug /machine:I386 /out:"../bin/vc6/lfsd.dll" /pdbtype:sept /libpath:"../../lua/lib/vc6"
!ENDIF
# Begin Target
# Name "luafilesystem_dll - Win32 Release"
# Name "luafilesystem_dll - Win32 Debug"
# Begin Group "Source Files"
# PROP Default_Filter "cpp;c;cxx;rc;def;r;odl;idl;hpj;bat"
# Begin Source File
SOURCE="..\..\compat\compat-5.1.c"
# End Source File
# Begin Source File
SOURCE=..\lfs.c
# End Source File
# Begin Source File
SOURCE=..\lfs.def
# End Source File
# End Group
# Begin Group "Header Files"
# PROP Default_Filter "h;hpp;hxx;hm;inl"
# Begin Source File
SOURCE="..\..\compat\compat-5.1.h"
# End Source File
# Begin Source File
SOURCE=..\lfs.h
# End Source File
# End Group
# Begin Group "Resource Files"
# PROP Default_Filter "ico;cur;bmp;dlg;rc2;rct;bin;rgs;gif;jpg;jpeg;jpe"
# End Group
# End Target
# End Project