+++ /dev/null
-/*
- * Copyright (c) 1999-2000, 2009 Apple Inc. All rights reserved.
- *
- * @APPLE_LICENSE_HEADER_START@
- *
- * This file contains Original Code and/or Modifications of Original Code
- * as defined in and that are subject to the Apple Public Source License
- * Version 2.0 (the 'License'). You may not use this file except in
- * compliance with the License. Please obtain a copy of the License at
- * http://www.opensource.apple.com/apsl/ and read it before using this
- * file.
- *
- * The Original Code and all software distributed under the License are
- * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
- * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
- * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
- * Please see the License for the specific language governing rights and
- * limitations under the License.
- *
- * @APPLE_LICENSE_HEADER_END@
- */
-
-/*
- This API returns the various standard system directories where apps, resources, etc get installed.
- Because queries can return multiple directories, the API is in the form of an enumeration.
- The directories are returned in search path order; that is, the first place to look is returned first.
- This API may return directories that do not exist yet.
- If NSUserDomain is included in a query, then the results will contain "~" to refer to the user's directory.
- NEXT_ROOT is prepended as necessary to the returned values.
- Some calls might return no directories!
- The buffer that is passed in will be filled with a null-terminated string, possibly containing as many as PATH_MAX-1 characters.
-
- Typical usage:
-
- #include <limits.h>
- #include <NSSystemDirectories.h>
-
- char path[PATH_MAX];
- NSSearchPathEnumerationState state = NSStartSearchPathEnumeration(dir, domainMask);
- while (state = NSGetNextSearchPathEnumeration(state, path)) {
- // Handle path
- }
-
-
-*/
-
-#ifndef __NS_SYSTEM_DIRECTORIES_H__
-#define __NS_SYSTEM_DIRECTORIES_H__
-
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-// Directories
-
-typedef enum {
- NSApplicationDirectory = 1, // supported applications (Applications)
- NSDemoApplicationDirectory = 2, // unsupported applications, demonstration versions (Applications/GrabBag)
- NSDeveloperApplicationDirectory = 3, // developer applications (Developer/Applications)
- NSAdminApplicationDirectory = 4, // system and network administration applications (Applications/Utilities)
- NSLibraryDirectory = 5, // various user-visible documentation, support, and configuration files, resources (Library)
- NSDeveloperDirectory = 6, // developer resources (Developer)
- NSUserDirectory = 7, // user home directories (Users)
- NSDocumentationDirectory = 8, // documentation (Library/Documentation)
- NSDocumentDirectory = 9, // documents (Documents)
- NSCoreServiceDirectory = 10, // location of core services (System/Library/CoreServices)
- NSAutosavedInformationDirectory = 11, // location of user's directory for use with autosaving (Library/Autosave Information)
- NSDesktopDirectory = 12, // location of user's Desktop (Desktop)
- NSCachesDirectory = 13, // location of discardable cache files (Library/Caches)
- NSApplicationSupportDirectory = 14, // location of application support files (plug-ins, etc) (Library/Application Support)
- NSDownloadsDirectory = 15, // location of user's Downloads directory (Downloads)
- NSInputMethodsDirectory = 16, // input methods (Library/Input Methods)
- NSMoviesDirectory = 17, // location of user's Movies directory (~/Movies)
- NSMusicDirectory = 18, // location of user's Music directory (~/Music)
- NSPicturesDirectory = 19, // location of user's Pictures directory (~/Pictures)
- NSPrinterDescriptionDirectory = 20, // location of system's PPDs directory (Library/Printers/PPDs)
- NSSharedPublicDirectory = 21, // location of user's Public sharing directory (~/Public)
- NSPreferencePanesDirectory = 22, // location of the PreferencePanes directory for use with System Preferences (Library/PreferencePanes)
- NSAllApplicationsDirectory = 100, // all directories where applications can occur (Applications, Applications/Utilities, Developer/Applications, ...)
- NSAllLibrariesDirectory = 101 // all directories where resources can occur (Library, Developer)
-} NSSearchPathDirectory;
-
-// Domains
-
-typedef enum {
- NSUserDomainMask = 1, // user's home directory --- place to install user's personal items (~)
- NSLocalDomainMask = 2, // local to the current machine --- place to install items available to everyone on this machine
- NSNetworkDomainMask = 4, // publically available location in the local area network --- place to install items available on the network (/Network)
- NSSystemDomainMask = 8, // provided by Apple
- NSAllDomainsMask = 0x0ffff // all domains: all of the above and more, future items
-} NSSearchPathDomainMask;
-
-typedef unsigned int NSSearchPathEnumerationState;
-
-/* Enumeration
- Call NSStartSearchPathEnumeration() once, then call NSGetNextSearchPathEnumeration() one or more times with the returned state.
- The return value of NSGetNextSearchPathEnumeration() should be used as the state next time around.
- When NSGetNextSearchPathEnumeration() returns 0, you're done.
-*/
-
-extern NSSearchPathEnumerationState NSStartSearchPathEnumeration(NSSearchPathDirectory dir, NSSearchPathDomainMask domainMask);
-
-extern NSSearchPathEnumerationState NSGetNextSearchPathEnumeration(NSSearchPathEnumerationState state, char *path);
-
-#ifdef __cplusplus
-}
-#endif
-
-#endif /* __NS_SYSTEM_DIRECTORIES_H__ */
projects / apple / libc.git / blobdiff