dir.h revision 631688bc0cb9e4b091b6d199d620be03a03858cb
/* $Id$ */
/** @file
* IPRT - Internal Header for RTDir.
*/
/*
* Copyright (C) 2006-2007 Oracle Corporation
*
* This file is part of VirtualBox Open Source Edition (OSE), as
* available from http://www.virtualbox.org. This file is free software;
* General Public License (GPL) as published by the Free Software
* Foundation, in version 2 as it comes in the "COPYING" file of the
* VirtualBox OSE distribution. VirtualBox OSE is distributed in the
* hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
*
* The contents of this file may alternatively be used under the terms
* of the Common Development and Distribution License Version 1.0
* (CDDL) only, as it comes in the "COPYING.CDDL" file of the
* VirtualBox OSE distribution, in which case the provisions of the
* CDDL are applicable instead of those of the GPL.
*
* You may elect to license modified versions of this file under the
* terms and conditions of either the GPL or the CDDL or both.
*/
#ifndef ___internal_dir_h
#define ___internal_dir_h
/**
* Filter a the filename in the against a filter.
*
* @returns true if the name matches the filter.
* @returns false if the name doesn't match filter.
* @param pDir The directory handle.
* @param pszName The path to match to the filter.
*/
/** Pointer to a filter function. */
typedef FNRTDIRFILTER *PFNRTDIRFILTER;
/**
* Open directory.
*/
typedef struct RTDIR
{
/** Magic value, RTDIR_MAGIC. */
/** The type of filter that's to be applied to the directory listing. */
/** The filter function. */
/** The filter Code Point string.
* This is allocated in the same block as this structure. */
/** The number of Code Points in the filter string. */
/** The filter string.
* This is allocated in the same block as this structure, thus the const. */
const char *pszFilter;
/** The length of the filter string. */
/** Normalized path to the directory including a trailing slash.
* We keep this around so we can query more information if required (posix).
* This is allocated in the same block as this structure, thus the const. */
const char *pszPath;
/** The length of the path. */
/** Set to indicate that the Data member contains unread data. */
bool fDataUnread;
/** Pointer to the converted filename.
* This can be NULL. */
#ifdef RT_OS_WINDOWS
char *pszName;
#else
char const *pszName;
#endif
/** The length of the converted filename. */
#ifdef RT_OS_WINDOWS
/** Handle to the opened directory search. */
/** Find data buffer.
* fDataUnread indicates valid data. */
#else /* 'POSIX': */
/** What opendir() returned. */
/** The max size of the d_name member.
* This includes the 0 terminator of course.*/
/** Find data buffer.
* fDataUnread indicates valid data. */
#endif
} RTDIR;
/**
* Validates a directory handle.
* @returns true if valid.
* @returns false if valid after having bitched about it first.
*/
{
return true;
}
/**
* Initialize the OS specific part of the handle and open the directory.
* Called by rtDirOpenCommon().
*
* @returns IPRT status code.
* @param pDir The directory to open. The pszPath member contains the
* path to the directory.
* @param pszPathBuf Pointer to a RTPATH_MAX sized buffer containing pszPath.
* Find-first style systems can use this to setup the
* wildcard expression.
*/
#endif