Language

The Free and Open Productivity Suite
Released: Apache OpenOffice 4.1.15
 Overview   Namespace   Class   Index   Help 
LIST OF:  VALUES


::

enum e_Anonymous__16


Summary
@name Main goals and usage hints

Description
The main intentention of this interface is to provide an universal portable and
high performance access to file system issues on any operating system.<p>

There are a few main goals:<p>

1.The path specifications always have to be absolut. Any usage of relative path
specifications is forbidden. Most operating systems provide a
"Current Directory" per process. This is the reason why relative path
specifications can cause problems in multithreading environments.<p>

2.Proprietary notations of file paths are not supported. Every path notation
must follow the UNC notation. The directory divider is the slash character.<p>

3.The caller cannot get any information whether a file system is case sensitive,
case preserving or not. The operating system implementation itself should
determine if it can map case-insensitive paths. The case correct notation of
a filename or file path is part of the "File Info". This case correct name
can be used as a unique key if neccessary.<p>

4. Obtaining information about files or volumes is controlled by a
bitmask which specifies which fields are of interest. Due to performance
issues it is not recommended to obtain information which is not needed.
But if the operating system provides more information anyway the
implementation can set more fields on output as were requested. It is in the
responsibility of the caller to decide if he uses this additional information
or not. But he should do so to prevent further unnecessary calls if the information
is already there.<br>

The input bitmask supports a flag <code>osl_FileStatus_Mask_Validate</code> which
can be used to force retrieving uncached validated information. Setting this flag
when calling <code>osl_getFileStatus</code> in combination with no other flag is
a synonym for a "FileExists". This should only be done when processing a single file
(f.e. before opening) and NEVER during enumeration of directory contents on any step
of information processing. This would change the runtime behaviour from O(n) to
O(n*n/2) on nearly every file system.<br>
On Windows NT reading the contents of an directory with 7000 entries and
getting full information about every file only takes 0.6 seconds. Specifying the
flag <code>osl_FileStatus_Mask_Validate</code> for each entry will increase the
time to 180 seconds (!!!).


Values

osl_File_E_None
osl_File_E_PERM
osl_File_E_NOENT
osl_File_E_SRCH
osl_File_E_INTR
osl_File_E_IO
osl_File_E_NXIO
osl_File_E_2BIG
osl_File_E_NOEXEC
osl_File_E_BADF
osl_File_E_CHILD
osl_File_E_AGAIN
osl_File_E_NOMEM
osl_File_E_ACCES
osl_File_E_FAULT
osl_File_E_BUSY
osl_File_E_EXIST
osl_File_E_XDEV
osl_File_E_NODEV
osl_File_E_NOTDIR
osl_File_E_ISDIR
osl_File_E_INVAL
osl_File_E_NFILE
osl_File_E_MFILE
osl_File_E_NOTTY
osl_File_E_FBIG
osl_File_E_NOSPC
osl_File_E_SPIPE
osl_File_E_ROFS
osl_File_E_MLINK
osl_File_E_PIPE
osl_File_E_DOM
osl_File_E_RANGE
osl_File_E_DEADLK
osl_File_E_NAMETOOLONG
osl_File_E_NOLCK
osl_File_E_NOSYS
osl_File_E_NOTEMPTY
osl_File_E_LOOP
osl_File_E_ILSEQ
osl_File_E_NOLINK
osl_File_E_MULTIHOP
osl_File_E_USERS
osl_File_E_OVERFLOW
osl_File_E_NOTREADY
osl_File_E_invalidError
osl_File_E_FORCE_EQUAL_SIZE

Top of Page

Apache Software Foundation

Copyright & License | Privacy | Contact Us | Donate | Thanks

Apache, OpenOffice, OpenOffice.org and the seagull logo are registered trademarks of The Apache Software Foundation. The Apache feather logo is a trademark of The Apache Software Foundation. Other names appearing on the site may be trademarks of their respective owners.