New file.

git-svn-id: svn+ssh://svn.gna.org/svn/gnustep/libs/base/trunk@2210 72102866-910b-0410-8b05-ffd578937521

Headers/gnustep/base/NSFileManager.h

@@ -0,0 +1,179 @@
+/* 
+   NSFileManager.h
+
+   Copyright (C) 1997 Free Software Foundation, Inc.
+
+   Author: Mircea Oancea <mircea@jupiter.elcom.pub.ro>
+   Author: Ovidiu Predescu <ovidiu@net-community.com>
+   Date: Feb 1997
+
+   This file is part of the GNUstep Base Library.
+
+   This library is free software; you can redistribute it and/or
+   modify it under the terms of the GNU Library General Public
+   License as published by the Free Software Foundation; either
+   version 2 of the License, or (at your option) any later version.
+   
+   This library is distributed in the hope that it will be useful,
+   but WITHOUT ANY WARRANTY; without even the implied warranty of
+   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+   Library General Public License for more details.
+
+   You should have received a copy of the GNU Library General Public
+   License along with this library; if not, write to the Free
+   Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+*/
+
+#ifndef __NSFileManager_h_GNUSTEP_BASE_INCLUDE
+#define __NSFileManager_h_GNUSTEP_BASE_INCLUDE
+
+#include <Foundation/NSObject.h>
+#include <Foundation/NSUtilities.h>
+#include <Foundation/NSDictionary.h>
+
+@class NSNumber;
+@class NSString;
+@class NSData;
+@class NSDate;
+@class NSArray;
+@class NSMutableArray;
+
+@class NSDirectoryEnumerator;
+
+@interface NSFileManager : NSObject
+
+// Getting the default manager
++ (NSFileManager*)defaultManager;
+
+// Directory operations
+- (BOOL)changeCurrentDirectoryPath:(NSString*)path;
+- (BOOL)createDirectoryAtPath:(NSString*)path
+  attributes:(NSDictionary*)attributes;
+- (NSString*)currentDirectoryPath;
+
+// File operations
+- (BOOL)copyPath:(NSString*)source toPath:(NSString*)destination
+  handler:handler;
+- (BOOL)movePath:(NSString*)source toPath:(NSString*)destination 
+  handler:handler;
+- (BOOL)linkPath:(NSString*)source toPath:(NSString*)destination
+  handler:handler;
+- (BOOL)removeFileAtPath:(NSString*)path
+  handler:handler;
+- (BOOL)createFileAtPath:(NSString*)path contents:(NSData*)contents
+  attributes:(NSDictionary*)attributes;
+
+// Getting and comparing file contents	
+- (NSData*)contentsAtPath:(NSString*)path;
+- (BOOL)contentsEqualAtPath:(NSString*)path1 andPath:(NSString*)path2;
+
+// Detemining access to files
+- (BOOL)fileExistsAtPath:(NSString*)path;
+- (BOOL)fileExistsAtPath:(NSString*)path isDirectory:(BOOL*)isDirectory;
+- (BOOL)isReadableFileAtPath:(NSString*)path;
+- (BOOL)isWritableFileAtPath:(NSString*)path;
+- (BOOL)isExecutableFileAtPath:(NSString*)path;
+- (BOOL)isDeletableFileAtPath:(NSString*)path;
+
+// Getting and setting attributes
+- (NSDictionary*)fileAttributesAtPath:(NSString*)path traverseLink:(BOOL)flag;
+- (NSDictionary*)fileSystemAttributesAtPath:(NSString*)path;
+- (BOOL)changeFileAttributes:(NSDictionary*)attributes atPath:(NSString*)path;
+
+// Discovering directory contents
+- (NSArray*)directoryContentsAtPath:(NSString*)path;
+- (NSDirectoryEnumerator*)enumeratorAtPath:(NSString*)path;
+- (NSArray*)subpathsAtPath:(NSString*)path;
+
+// Symbolic-link operations
+- (BOOL)createSymbolicLinkAtPath:(NSString*)path
+  pathContent:(NSString*)otherPath;
+- (NSString*)pathContentOfSymbolicLinkAtPath:(NSString*)path;
+
+// Converting file-system representations
+- (const char*)fileSystemRepresentationWithPath:(NSString*)path;
+- (NSString*)stringWithFileSystemRepresentation:(const char*)string
+  length:(unsigned int)len;
+
+@end /* NSFileManager */
+
+
+@interface NSObject (NSFileManagerHandler)
+- (BOOL)fileManager:(NSFileManager*)fileManager
+  shouldProceedAfterError:(NSDictionary*)errorDictionary;
+- (void)fileManager:(NSFileManager*)fileManager
+  willProcessPath:(NSString*)path;
+@end
+
+
+@interface NSDirectoryEnumerator : NSEnumerator
+{
+    NSMutableArray*	enumStack;
+    NSMutableArray*	pathStack;
+    NSString*		currentFileName;
+    NSString*		currentFilePath;
+    NSString*		topPath;
+    struct {
+	BOOL		isRecursive:1;
+ 	BOOL		isFollowing:1;
+   } flags;
+}
+
+// Initializing
+- initWithDirectoryPath:(NSString*)path 
+  recurseIntoSubdirectories:(BOOL)recurse
+  followSymlinks:(BOOL)follow
+  prefixFiles:(BOOL)prefix;
+
+// Getting attributes
+- (NSDictionary*)directoryAttributes;
+- (NSDictionary*)fileAttributes;
+
+// Skipping subdirectories
+- (void)skipDescendents;
+
+@end /* NSDirectoryEnumerator */
+
+/* File Attributes */
+extern NSString* NSFileSize;
+extern NSString* NSFileModificationDate;
+extern NSString* NSFileOwnerAccountNumber;
+extern NSString* NSFileGroupOwnerAccountNumber;
+extern NSString* NSFileReferenceCount;
+extern NSString* NSFileIdentifier;
+extern NSString* NSFileDeviceIdentifier;
+extern NSString* NSFilePosixPermissions;
+extern NSString* NSFileType;
+
+/* File Types */
+
+extern NSString* NSFileTypeDirectory;
+extern NSString* NSFileTypeRegular;
+extern NSString* NSFileTypeSymbolicLink;
+extern NSString* NSFileTypeSocket;
+extern NSString* NSFileTypeFifo;
+extern NSString* NSFileTypeCharacterSpecial;
+extern NSString* NSFileTypeBlockSpecial;
+extern NSString* NSFileTypeUnknown;
+
+/* FileSystem Attributes */
+
+extern NSString* NSFileSystemSize;
+extern NSString* NSFileSystemFreeSize;
+extern NSString* NSFileSystemNodes;
+extern NSString* NSFileSystemFreeNodes;
+extern NSString* NSFileSystemNumber;
+
+/* Easy access to attributes in a dictionary */
+
+@interface NSDictionary(NSFileAttributes)
+- (NSNumber*)fileSize;
+- (NSString*)fileType;
+- (NSNumber*)fileOwnerAccountNumber;
+- (NSNumber*)fileGroupOwnerAccountNumber;
+- (NSDate*)fileModificationDate;
+- (NSNumber*)filePosixPermissions;
+@end
+
+
+#endif /* __NSFileManager_h_GNUSTEP_BASE_INCLUDE */

Source/NSFileManager.m

@@ -0,0 +1,809 @@
+/* 
+   NSFileManager.m
+
+   Copyright (C) 1997 Free Software Foundation, Inc.
+
+   Author: Mircea Oancea <mircea@jupiter.elcom.pub.ro>
+   Author: Ovidiu Predescu <ovidiu@net-community.com>
+   Date: Feb 1997
+
+   This file is part of the GNUstep Base Library.
+
+   This library is free software; you can redistribute it and/or
+   modify it under the terms of the GNU Library General Public
+   License as published by the Free Software Foundation; either
+   version 2 of the License, or (at your option) any later version.
+   
+   This library is distributed in the hope that it will be useful,
+   but WITHOUT ANY WARRANTY; without even the implied warranty of
+   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+   Library General Public License for more details.
+
+   You should have received a copy of the GNU Library General Public
+   License along with this library; if not, write to the Free
+   Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+*/
+
+#include <gnustep/base/preface.h>
+#include <Foundation/NSFileManager.h>
+
+/* determine directory reading files */
+
+#if defined(HAVE_DIRENT_H)
+# include <dirent.h>
+#elif defined(HAVE_SYS_DIR_H)
+# include <sys/dir.h>
+#elif defined(HAVE_SYS_NDIR_H)
+# include <sys/ndir.h>
+#elif defined(HAVE_NDIR_H)
+# include <ndir.h>
+#endif
+
+#include <unistd.h>
+
+#if !defined(_POSIX_VERSION)
+# if defined(NeXT)
+#  define DIR_enum_item struct direct
+# endif
+#endif
+
+#if !defined(DIR_enum_item)
+# define DIR_enum_item struct dirent
+#endif
+
+#define DIR_enum_state DIR
+
+/* determine filesystem max path length */
+
+#ifdef _POSIX_VERSION
+# include <limits.h>			/* for PATH_MAX */
+# include <utime.h>
+#else
+# include <sys/param.h>			/* for MAXPATHLEN */
+#endif
+
+#ifndef PATH_MAX
+# ifdef _POSIX_VERSION
+#  define PATH_MAX _POSIX_PATH_MAX
+# else
+#  ifdef MAXPATHLEN
+#   define PATH_MAX MAXPATHLEN
+#  else
+#   define PATH_MAX 1024
+#  endif
+# endif
+#endif
+
+/* determine if we have statfs struct and function */
+
+#ifdef HAVE_SYS_VFS_H
+# include <sys/vfs.h>
+#endif
+
+#ifdef HAVE_SYS_STATFS_H
+# include <sys/statfs.h>
+#endif
+
+#include <errno.h>
+#include <sys/stat.h>
+
+/* include usual headers */
+
+#include <Foundation/NSArray.h>
+#include <Foundation/NSDictionary.h>
+#include <Foundation/NSData.h>
+#include <Foundation/NSDate.h>
+#include <Foundation/NSString.h>
+#include <Foundation/NSValue.h>
+#include <Foundation/NSPathUtilities.h>
+#include <Foundation/NSFileManager.h>
+
+/*
+ * NSFileManager implementation
+ */
+
+@implementation NSFileManager
+
+// Getting the default manager
+
+static NSFileManager* defaultManager = nil;
+
++ (NSFileManager*)defaultManager
+{
+    if (!defaultManager) {
+	// THREAD
+	defaultManager = [[self alloc] init];
+    }
+    return defaultManager;
+}
+
+// Directory operations
+
+- (BOOL)changeCurrentDirectoryPath:(NSString*)path
+{
+    const char* cpath = [self fileSystemRepresentationWithPath:path];
+    
+    return (chdir(cpath) == 0);
+}
+
+- (BOOL)createDirectoryAtPath:(NSString*)path
+  attributes:(NSDictionary*)attributes
+{
+    const char* cpath;
+    char dirpath[PATH_MAX+1];
+    struct stat statbuf;
+    int len, cur;
+    
+    cpath = [self fileSystemRepresentationWithPath:path];
+    len = strlen(cpath);
+    if (len > PATH_MAX)
+	// name too long
+	return NO;
+    
+    if (strcmp(cpath, "/") == 0 || len == 0)
+	// cannot use "/" or "" as a new dir path
+	return NO; 
+    
+    strcpy(dirpath, cpath);
+    dirpath[len] = '\0';
+    if (dirpath[len-1] == '/')
+	dirpath[len-1] = '\0';
+    cur = 0;
+    
+    do {
+	// find next '/'
+	while (dirpath[cur] != '/' && cur < len)
+	    cur++;
+	// if first char is '/' then again; (cur == len) -> last component
+	if (cur == 0) {
+	    cur++;
+	    continue;
+	}
+	// check if path from 0 to cur is valid
+	dirpath[cur] = '\0';
+	if (stat(dirpath, &statbuf) == 0) {
+	    if (cur == len)
+		return NO; // already existing last path
+	}
+	else {
+	    // make new directory
+	    if (mkdir(dirpath, 0777) != 0)
+		return NO; // could not create component
+	    // if last directory and attributes then change
+	    if (cur == len && attributes)
+		return [self changeFileAttributes:attributes 
+		    atPath:[self stringWithFileSystemRepresentation:dirpath
+			length:cur]];
+	}
+	dirpath[cur] = '/';
+	cur++;
+    } while (cur < len);
+    
+    return YES;
+}
+
+- (NSString*)currentDirectoryPath
+{
+    char path[PATH_MAX];
+    
+#ifdef HAVE_GETCWD
+    if (getcwd(path, PATH_MAX-1) == NULL)
+	return nil;
+#else
+    if (getwd(path) == NULL)
+	return nil;
+#endif
+
+    return [self stringWithFileSystemRepresentation:path length:strlen(path)];
+}
+
+// File operations
+
+- (BOOL)copyPath:(NSString*)source toPath:(NSString*)destination
+  handler:handler
+{
+    // TODO
+    return NO;
+}
+
+- (BOOL)movePath:(NSString*)source toPath:(NSString*)destination 
+  handler:handler
+{
+    BOOL sourceIsDir;
+    const char* sourcePath = [self fileSystemRepresentationWithPath:source];
+    const char* destPath = [self fileSystemRepresentationWithPath:destination];
+
+    if ([self fileExistsAtPath:source isDirectory:&sourceIsDir]
+	&& !sourceIsDir) {
+	/* `source' is file so simply move it to destination. */
+	[handler fileManager:self willProcessPath:source];
+	if (rename(sourcePath, destPath) == -1) {
+	    if (handler) {
+		NSDictionary* dict
+		    = [NSDictionary dictionaryWithObjectsAndKeys:
+			source, @"Path",
+			[NSString stringWithCString:strerror(errno)], @"Error",
+			destination, @"ToPath",
+			nil];
+		if ([handler fileManager:self shouldProceedAfterError:dict])
+		    return YES;
+	    }
+	    return NO;
+	}
+    }
+
+    // TODO: handle directories
+    return YES;
+}
+
+- (BOOL)linkPath:(NSString*)source toPath:(NSString*)destination
+  handler:handler
+{
+    // TODO
+    return NO;
+}
+
+- (BOOL)removeFileAtPath:(NSString*)path
+  handler:handler
+{
+    // TODO
+    return NO;
+}
+
+- (BOOL)createFileAtPath:(NSString*)path contents:(NSData*)contents
+  attributes:(NSDictionary*)attributes
+{
+    // TODO
+    return NO;
+}
+
+// Getting and comparing file contents
+
+- (NSData*)contentsAtPath:(NSString*)path
+{
+    // TODO
+    return nil;
+}
+
+- (BOOL)contentsEqualAtPath:(NSString*)path1 andPath:(NSString*)path2
+{
+    // TODO
+    return NO;
+}
+
+// Detemining access to files
+
+- (BOOL)fileExistsAtPath:(NSString*)path
+{
+    return [self fileExistsAtPath:path isDirectory:NULL];
+}
+
+- (BOOL)fileExistsAtPath:(NSString*)path isDirectory:(BOOL*)isDirectory
+{
+    struct stat statbuf;
+    const char* cpath = [self fileSystemRepresentationWithPath:path];
+
+    if (stat(cpath, &statbuf) != 0)
+	return NO;
+    
+    if (isDirectory) {
+	*isDirectory = ((statbuf.st_mode & S_IFMT) == S_IFDIR);
+    }
+    
+    return YES;
+}
+
+- (BOOL)isReadableFileAtPath:(NSString*)path
+{
+    const char* cpath = [self fileSystemRepresentationWithPath:path];
+    
+    return (access(cpath, R_OK) == 0);
+}
+
+- (BOOL)isWritableFileAtPath:(NSString*)path
+{
+    const char* cpath = [self fileSystemRepresentationWithPath:path];
+    
+    return (access(cpath, W_OK) == 0);
+}
+
+- (BOOL)isExecutableFileAtPath:(NSString*)path
+{
+    const char* cpath = [self fileSystemRepresentationWithPath:path];
+    
+    return (access(cpath, X_OK) == 0);
+}
+
+- (BOOL)isDeletableFileAtPath:(NSString*)path
+{
+    // TODO - handle directories
+    const char* cpath;
+    
+    cpath = [self fileSystemRepresentationWithPath:
+	[path stringByDeletingLastPathComponent]];
+    
+    if (access(cpath, X_OK || W_OK) != 0)
+	return NO;
+
+    cpath = [self fileSystemRepresentationWithPath:
+	[path stringByDeletingLastPathComponent]];
+    
+    return  (access(cpath, X_OK || W_OK) != 0);
+}
+
+- (NSDictionary*)fileAttributesAtPath:(NSString*)path traverseLink:(BOOL)flag
+{
+    struct stat statbuf;
+    const char* cpath = [self fileSystemRepresentationWithPath:path];
+    int mode;
+    
+    id  values[9];
+    id	keys[9] = {
+	    NSFileSize,
+	    NSFileModificationDate,
+	    NSFileOwnerAccountNumber,
+	    NSFileGroupOwnerAccountNumber,
+	    NSFileReferenceCount,
+	    NSFileIdentifier,
+	    NSFileDeviceIdentifier,
+	    NSFilePosixPermissions,
+	    NSFileType
+	};
+    
+    if (stat(cpath, &statbuf) != 0)
+	return nil;
+    
+    values[0] = [NSNumber numberWithUnsignedLongLong:statbuf.st_size];
+    values[1] = [NSDate dateWithTimeIntervalSince1970:statbuf.st_mtime];
+    values[2] = [NSNumber numberWithUnsignedInt:statbuf.st_uid];
+    values[3] = [NSNumber numberWithUnsignedInt:statbuf.st_gid];
+    values[4] = [NSNumber numberWithUnsignedInt:statbuf.st_nlink];
+    values[5] = [NSNumber numberWithUnsignedLong:statbuf.st_ino];
+    values[6] = [NSNumber numberWithUnsignedInt:statbuf.st_dev];
+    values[7] = [NSNumber numberWithUnsignedInt:statbuf.st_mode];
+    
+    mode = statbuf.st_mode & S_IFMT;
+
+    if      (mode == S_IFREG)
+	values[8] = NSFileTypeRegular;
+    else if (mode == S_IFDIR)
+	values[8] = NSFileTypeDirectory;
+    else if (mode == S_IFCHR)
+	values[8] = NSFileTypeCharacterSpecial;
+    else if (mode == S_IFBLK)
+	values[8] = NSFileTypeBlockSpecial;
+    else if (mode == S_IFLNK)
+	values[8] = NSFileTypeSymbolicLink;
+    else if (mode == S_IFIFO)
+	values[8] = NSFileTypeFifo;
+    else if (mode == S_IFSOCK)
+	values[8] = NSFileTypeSocket;
+    else
+	values[8] = NSFileTypeUnknown;
+	
+    return [[[NSDictionary alloc]
+	initWithObjects:values forKeys:keys count:5]
+	autorelease];
+}
+
+- (NSDictionary*)fileSystemAttributesAtPath:(NSString*)path
+{
+#if HAVE_SYS_VFS_H || HAVE_SYS_STATFS_H
+    struct stat statbuf;
+#if HAVE_STATVFS
+    struct statvfs statfsbuf;
+#else
+    struct statfs statfsbuf;
+#endif
+    long long totalsize, freesize;
+    const char* cpath = [self fileSystemRepresentationWithPath:path];
+    
+    id  values[5];
+    id	keys[5] = {
+	    NSFileSystemSize,
+	    NSFileSystemFreeSize,
+	    NSFileSystemNodes,
+	    NSFileSystemFreeNodes,
+	    NSFileSystemNumber
+	};
+    
+    if (stat(cpath, &statbuf) != 0)
+	return nil;
+
+#if HAVE_STATVFS
+    if (statvfs(cpath, &statfsbuf) != 0)
+	return nil;
+#else
+    if (statfs(cpath, &statfsbuf) != 0)
+	return nil;
+#endif
+
+    totalsize = statfsbuf.f_bsize * statfsbuf.f_blocks;
+    freesize = statfsbuf.f_bsize * statfsbuf.f_bfree;
+    
+    values[0] = [NSNumber numberWithLongLong:totalsize];
+    values[1] = [NSNumber numberWithLongLong:freesize];
+    values[2] = [NSNumber numberWithLong:statfsbuf.f_files];
+    values[3] = [NSNumber numberWithLong:statfsbuf.f_ffree];
+    values[4] = [NSNumber numberWithUnsignedInt:statbuf.st_dev];
+    
+    return [[[NSDictionary alloc]
+	initWithObjects:values forKeys:keys count:5]
+	autorelease];
+#else
+    return nil;
+#endif
+}
+
+- (BOOL)changeFileAttributes:(NSDictionary*)attributes atPath:(NSString*)path
+{
+    const char* cpath = [self fileSystemRepresentationWithPath:path];
+    NSNumber* num;
+    NSDate* date;
+    BOOL allOk = YES;
+    
+    num = [attributes objectForKey:NSFileOwnerAccountNumber];
+    if (num) {
+	allOk &= (chown(cpath, [num intValue], -1) == 0);
+    }
+    
+    num = [attributes objectForKey:NSFileGroupOwnerAccountNumber];
+    if (num) {
+	allOk &= (chown(cpath, -1, [num intValue]) == 0);
+    }
+    
+    num = [attributes objectForKey:NSFilePosixPermissions];
+    if (num) {
+	allOk &= (chmod(cpath, [num intValue]) == 0);
+    }
+    
+    date = [attributes objectForKey:NSFileModificationDate];
+    if (date) {
+	struct stat sb;
+#ifdef  _POSIX_VERSION
+	struct utimbuf ub;
+#else
+	time_t ub[2];
+#endif
+
+	if (stat(cpath, &sb) != 0)
+	    allOk = NO;
+	else {
+#ifdef  _POSIX_VERSION
+	    ub.actime = sb.st_atime;
+	    ub.modtime = [date timeIntervalSince1970];
+	    allOk &= (utime(cpath, &ub) == 0);
+#else
+	    ub[0] = sb.st_atime;
+	    ub[1] = [date timeIntervalSince1970];
+	    allOk &= (utime((char*)cpath, ub) == 0);
+#endif
+	}
+    }
+    
+    return allOk;
+}
+
+// Discovering directory contents
+
+- (NSArray*)directoryContentsAtPath:(NSString*)path
+{
+    NSDirectoryEnumerator* direnum;
+    NSMutableArray* content;
+    BOOL isDir;
+    
+    if (![self fileExistsAtPath:path isDirectory:&isDir] || !isDir)
+	return nil;
+    
+    direnum = [[NSDirectoryEnumerator alloc]
+	initWithDirectoryPath:path 
+	recurseIntoSubdirectories:NO
+	followSymlinks:NO
+	prefixFiles:NO];
+    content = [[[NSMutableArray alloc] init] autorelease];
+    
+    while ((path = [direnum nextObject]))
+	[content addObject:path];
+
+    [direnum release];
+
+    return content;
+}
+
+- (NSDirectoryEnumerator*)enumeratorAtPath:(NSString*)path
+{
+    return [[[NSDirectoryEnumerator alloc]
+	initWithDirectoryPath:path 
+	recurseIntoSubdirectories:YES
+	followSymlinks:NO
+	prefixFiles:YES] autorelease];
+}
+
+- (NSArray*)subpathsAtPath:(NSString*)path
+{
+    NSDirectoryEnumerator* direnum;
+    NSMutableArray* content;
+    BOOL isDir;
+    
+    if (![self fileExistsAtPath:path isDirectory:&isDir] || !isDir)
+	return nil;
+    
+    direnum = [[NSDirectoryEnumerator alloc]
+	initWithDirectoryPath:path 
+	recurseIntoSubdirectories:YES
+	followSymlinks:NO
+	prefixFiles:YES];
+    content = [[[NSMutableArray alloc] init] autorelease];
+    
+    while ((path = [direnum nextObject]))
+	[content addObject:path];
+
+    [direnum release];
+
+    return content;
+}
+
+// Symbolic-link operations
+
+- (BOOL)createSymbolicLinkAtPath:(NSString*)path
+  pathContent:(NSString*)otherPath
+{
+    const char* lpath = [self fileSystemRepresentationWithPath:path];
+    const char* npath = [self fileSystemRepresentationWithPath:otherPath];
+    
+    return (symlink(lpath, npath) == 0);
+}
+
+- (NSString*)pathContentOfSymbolicLinkAtPath:(NSString*)path
+{
+    char  lpath[PATH_MAX];
+    const char* cpath = [self fileSystemRepresentationWithPath:path];
+    int   llen = readlink(cpath, lpath, PATH_MAX-1);
+    
+    if (llen > 0)
+	return [self stringWithFileSystemRepresentation:lpath length:llen];
+    else
+	return nil;
+}
+
+// Converting file-system representations
+
+- (const char*)fileSystemRepresentationWithPath:(NSString*)path
+{
+    return [[[path copy] autorelease] cString];
+}
+
+- (NSString*)stringWithFileSystemRepresentation:(const char*)string
+  length:(unsigned int)len
+{
+    return [NSString stringWithCString:string length:len];
+}
+
+@end /* NSFileManager */
+
+/*
+ * NSDirectoryEnumerator implementation
+ */
+
+@implementation NSDirectoryEnumerator
+
+// Implementation dependent methods
+
+/* 
+  recurses into directory `path' 
+	- pushes relative path (relative to root of search) on pathStack
+	- pushes system dir enumerator on enumPath 
+*/
+- (void)recurseIntoDirectory:(NSString*)path relativeName:(NSString*)name
+{
+    const char* cpath;
+    DIR*  dir;
+    
+    cpath = [[NSFileManager defaultManager]
+	fileSystemRepresentationWithPath:path];
+    
+    dir = opendir(cpath);
+    
+    if (dir) {
+	[pathStack addObject:name];
+	[enumStack addObject:[NSValue valueWithPointer:dir]];
+    }
+}
+
+/*
+  backtracks enumeration to the previous dir
+  	- pops current dir relative path from pathStack
+	- pops system dir enumerator from enumStack
+	- sets currentFile* to nil
+*/
+- (void)backtrack
+{
+    closedir((DIR*)[[enumStack lastObject] pointerValue]);
+    [enumStack removeLastObject];
+    [pathStack removeLastObject];
+    [currentFileName release];
+    [currentFilePath release];
+    currentFileName = currentFilePath = nil;
+}
+
+/*
+  finds the next file according to the top enumerator
+  	- if there is a next file it is put in currentFile
+	- if the current file is a directory and if isRecursive calls 
+	    recurseIntoDirectory:currentFile
+	- if the current file is a symlink to a directory and if isRecursive 
+	    and isFollowing calls recurseIntoDirectory:currentFile
+	- if at end of current directory pops stack and attempts to
+	    find the next entry in the parent
+	- sets currentFile to nil if there are no more files to enumerate
+*/
+- (void)findNextFile
+{
+    NSFileManager*	manager = [NSFileManager defaultManager];
+    DIR_enum_state*  	dir;
+    DIR_enum_item*	dirbuf;
+    struct stat		statbuf;
+    const char*		cpath;
+    
+    [currentFileName release];
+    [currentFilePath release];
+    currentFileName = currentFilePath = nil;
+    
+    while ([pathStack count]) {
+	dir = (DIR*)[[enumStack lastObject] pointerValue];
+	dirbuf = readdir(dir);
+	if (dirbuf) {
+	    /* Skip "." and ".." directory entries */
+	    if (strcmp(dirbuf->d_name, ".") == 0 || 
+	        strcmp(dirbuf->d_name, "..") == 0)
+		    continue;
+	    // Name of current file
+	    currentFileName = [manager
+		   stringWithFileSystemRepresentation:dirbuf->d_name
+		   length:strlen(dirbuf->d_name)];
+	    currentFileName = [[pathStack lastObject]
+		stringByAppendingPathComponent:currentFileName];
+	    // Full path of current file
+	    currentFilePath = [topPath
+		stringByAppendingPathComponent:currentFileName];
+	    // Check if directory
+	    cpath = [manager fileSystemRepresentationWithPath:currentFilePath];
+	    // Do not follow links
+	    if (!flags.isFollowing) {
+		if (!lstat(cpath, &statbuf))
+		    break;
+		// If link then return it as link
+		if (S_IFLNK == (S_IFMT & statbuf.st_mode)) 
+		    break;
+	    }
+	    // Follow links - check for directory
+	    if (!stat(cpath, &statbuf))
+		break;
+	    if (S_IFDIR == (S_IFMT & statbuf.st_mode)) {
+		[self recurseIntoDirectory:currentFilePath 
+		    relativeName:currentFileName];
+		break;
+	    }
+	}
+	else
+	    [self backtrack];
+    }
+}
+
+// Initializing
+
+- initWithDirectoryPath:(NSString*)path 
+  recurseIntoSubdirectories:(BOOL)recurse
+  followSymlinks:(BOOL)follow
+  prefixFiles:(BOOL)prefix
+{
+    pathStack = [NSMutableArray new];
+    enumStack = [NSMutableArray new];
+    flags.isRecursive = recurse;
+    flags.isFollowing = follow;
+    
+    topPath = [path retain];
+    [self recurseIntoDirectory:path relativeName:@""];
+    
+    return self;
+}
+
+- (void)dealloc
+{
+    while ([pathStack count])
+	[self backtrack];
+    
+    [pathStack release];
+    [enumStack release];
+    [currentFileName release];
+    [currentFilePath release];
+    [topPath release];
+}
+
+// Getting attributes
+
+- (NSDictionary*)directoryAttributes
+{
+    return [[NSFileManager defaultManager]
+	fileAttributesAtPath:currentFilePath
+	traverseLink:flags.isFollowing];
+}
+
+- (NSDictionary*)fileAttributes
+{
+    return [[NSFileManager defaultManager]
+	fileAttributesAtPath:currentFilePath
+	traverseLink:flags.isFollowing];
+}
+
+// Skipping subdirectories
+
+- (void)skipDescendents
+{
+    if ([pathStack count])
+	[self backtrack];
+}
+
+// Enumerate next
+
+- nextObject
+{
+    [self findNextFile];
+    return currentFileName;
+}
+
+@end /* NSDirectoryEnumerator */
+
+/*
+ * Attributes dictionary access
+ */
+
+@implementation NSDictionary(NSFileAttributes)
+- (NSNumber*)fileSize
+  {return [self objectForKey:NSFileSize];}
+- (NSString*)fileType;
+  {return [self objectForKey:NSFileType];}
+- (NSNumber*)fileOwnerAccountNumber;
+  {return [self objectForKey:NSFileOwnerAccountNumber];}
+- (NSNumber*)fileGroupOwnerAccountNumber;
+  {return [self objectForKey:NSFileGroupOwnerAccountNumber];}
+- (NSDate*)fileModificationDate;
+  {return [self objectForKey:NSFileModificationDate];}
+- (NSNumber*)filePosixPermissions;
+  {return [self objectForKey:NSFilePosixPermissions];}
+@end
+
+/*
+ * File attributes names
+ */
+
+/* File Attributes */
+
+NSString* NSFileSize = @"NSFileSize";
+NSString* NSFileModificationDate = @"NSFileModificationDate";
+NSString* NSFileOwnerAccountNumber = @"NSFileOwnerAccountNumber";
+NSString* NSFileGroupOwnerAccountNumber = @"NSFileGroupOwnerAccountNumber";
+NSString* NSFileReferenceCount = @"NSFileReferenceCount";
+NSString* NSFileIdentifier = @"NSFileIdentifier";
+NSString* NSFileDeviceIdentifier = @"NSFileDeviceIdentifier";
+NSString* NSFilePosixPermissions = @"NSFilePosixPermissions";
+NSString* NSFileType = @"NSFileType";
+
+/* File Types */
+
+NSString* NSFileTypeDirectory = @"NSFileTypeDirectory";
+NSString* NSFileTypeRegular = @"NSFileTypeRegular";
+NSString* NSFileTypeSymbolicLink = @"NSFileTypeSymbolicLink";
+NSString* NSFileTypeSocket = @"NSFileTypeSocket";
+NSString* NSFileTypeFifo = @"NSFileTypeFifo";
+NSString* NSFileTypeCharacterSpecial = @"NSFileTypeCharacterSpecial";
+NSString* NSFileTypeBlockSpecial = @"NSFileTypeBlockSpecial";
+NSString* NSFileTypeUnknown = @"NSFileTypeUnknown";
+
+/* FileSystem Attributes */
+
+NSString* NSFileSystemSize = @"NSFileSystemSize";
+NSString* NSFileSystemFreeSize = @"NSFileSystemFreeSize";
+NSString* NSFileSystemNodes = @"NSFileSystemNodes";
+NSString* NSFileSystemFreeNodes = @"NSFileSystemFreeNodes";
+NSString* NSFileSystemNumber = @"NSFileSystemNumber";

Testing/nscharacterset.m

@@ -0,0 +1,13 @@
+#include <Foundation/NSCharacterSet.h>
+
+int main()
+{
+  NSCharacterSet *alpha = [NSCharacterSet alphanumericCharacterSet];
+
+  if (alpha)
+    printf("obtained alphanumeric character set\n");
+  else
+    printf("unable to obtain alphanumeric character set\n");
+
+  exit(0);
+}

confdefs.h

@@ -0,0 +1 @@
+