home *** CD-ROM | disk | FTP | other *** search
/ Apple WWDC 1996 / WWDC96_1996 (CD).toast / Technology Materials / MacOS 8 Resources / Developer Tools / Mac OS 8 Interfaces & Libraries / Interfaces / CIncludes / FileManagerSPI.h < prev    next >
Encoding:
C/C++ Source or Header  |  1996-05-01  |  42.1 KB  |  819 lines  |  [TEXT/MPS ]
  1. /*
  2.      File:        FileManagerSPI.h
  3.  
  4.      Contains:    FileManager extended interface
  5.  
  6.      Version:    Technology:    System 8
  7.                  Release:    Universal Interfaces 3.0d3 on Copland DR1
  8.  
  9.      Copyright:    © 1984-1996 by Apple Computer, Inc.  All rights reserved.
  10.  
  11.      Bugs?:        If you find a problem with this file, send the file and version
  12.                  information (from above) and the problem description to:
  13.  
  14.                      Internet:    apple.bugs@applelink.apple.com
  15.                      AppleLink:    APPLE.BUGS
  16.  
  17. */
  18. #ifndef __FILEMANAGERSPI__
  19. #define __FILEMANAGERSPI__
  20.  
  21. #ifndef __KERNEL__
  22. #include <Kernel.h>
  23. #endif
  24. #ifndef __FILEMANAGERTYPES__
  25. #include <FileManagerTypes.h>
  26. #endif
  27. #ifndef __FILES__
  28. #include <Files.h>
  29. #endif
  30.  
  31. #ifdef __cplusplus
  32. extern "C" {
  33. #endif
  34.  
  35. #if PRAGMA_IMPORT_SUPPORTED
  36. #pragma import on
  37. #endif
  38.  
  39. #if PRAGMA_ALIGN_SUPPORTED
  40. #pragma options align=power
  41. /* the following contents can only be used by compilers that support PowerPC struct alignment */
  42.  
  43. /* You can use FileManager.h or FileManagerSPI.h, but not both */
  44. #ifndef __FILEMANAGER__
  45. #if FOR_SYSTEM8_PREEMPTIVE
  46. /*>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> C O N T A I N E R S <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<*/
  47. /*
  48. ****************************************************************************
  49.     OBJECTS
  50. ****************************************************************************
  51. */
  52. /*
  53.     Function:    FSObjectRefClone
  54.     Purpose:    Return a copy of an FSObjectRef such that the copy also needs to be disposed.
  55.     Inputs:
  56.                 object_t        The object ref to be cloned.
  57.     Outputs:
  58.                 clone_o            Copy of object_t.
  59.     Notes:
  60.                 The value returned is the same value passed as input in object_t.  This call
  61.                 would typically be used to balance a future call to FSObjectRefDispose.  Some
  62.                 examples where it might be used:
  63.                     • A called procedure needs to save an FSObjectRef for future use, but the
  64.                       calling conventions dictate that the caller is responsible for disposing
  65.                       of the ref.  The called function could call FSObjectRefClone to make its
  66.                       copy.  The caller can safely dispose of the ref, yet the callee can use
  67.                       the ref until doing its own dispose.
  68.                     • In object-oriented programming, an object could be passed an FSObjectRef
  69.                       in its constructor.  The destructor would be expected to dispose the ref,
  70.                       but so would the routine that created the object.  FSObjectRefClone could
  71.                       be used in the constructor.
  72.                 
  73.                 The returned FSObjectRef is registered to the calling process (as must object_t).
  74. */
  75. extern OSStatus FSObjectRefClone(FSObjectRef object_t, FSObjectRef *clone_o);
  76.  
  77. extern OSStatus FSObjectRefCloneAsync(FSObjectRef object_t, const KernelNotification *completion_i, FSObjectRef *clone_o, MessageID *requestID_o);
  78.  
  79. /*
  80.     Function:    FSObjectRefDispose
  81.     Purpose:    Dispose of an FSObjectRef previously returned to a process.
  82.     Inputs:
  83.                 object_t        The object ref to be disposed.
  84.     Outputs:
  85.     Notes:
  86.                 A process must dispose of all FSObjectRefs returned to it.  The FSObjectRefs
  87.                 may be returned as explicit output parameters, or as properties.  If a ref
  88.                 is returned several times for a given object, it must be disposed for each
  89.                 time it was returned.
  90.                 
  91.                 When all refs to a given object are disposed, the File Manager will dispose
  92.                 of any resources it allocated in order to operate on that object.  All refs
  93.                 for a process will be automatically disposed upon process termination.
  94.                 
  95.                 For refs returned as properties (especially when iterating over muliple
  96.                 objects), the FSObjectRefDisposeBulk call may be more convenient.
  97. */
  98. extern OSStatus FSObjectRefDispose(FSObjectRef object_t);
  99.  
  100. extern OSStatus FSObjectRefDisposeAsync(FSObjectRef object_t, const KernelNotification *completion_i, MessageID *requestID_o);
  101.  
  102. /*
  103.     Function:    FSObjectRefDisposeBulk
  104.     Purpose:    Dispose of many FSObjectRefs, using a list of property descriptors.
  105.                 (Typically used to dispose all refs returned by FSObjectIterate).
  106.     Inputs:
  107.                 objectCount_i        Number of objects returned by FSObjectIterate.
  108.                 propertyCount_i        Number of properties per object, as passed to FSObjectIterate.
  109.                 statusBuffer_i        Status buffer as returned by FSObjectIterate.
  110.                 properties_i        List of property descriptors passed to FSObjectIterate.
  111.                 propertiesBuffer_i    Buffer where property values were returned by FSObjectIterate.
  112.     Outputs:
  113.                 statusBuffer_o        Error status for each property of each object.
  114.     Notes:
  115.                 This call is intended to make it easy to dispose of FSObjectRefs returned by an
  116.                 FSObjectIterate call.  You would pass the same property count, property descriptor
  117.                 list and property value buffer as was passed to FSObjectIterate.  You also pass the
  118.                 object count and status buffer as returned by FSObjectIterate (since these tell which
  119.                 properties were actually returned).
  120.                 
  121.                 Any property in properties_i that does not contain an FSObjectRef is ignored.  Any
  122.                 property that does not have E_NoError in its propertyStatus field (in statusBuffer_i)
  123.                 is ignored.
  124.                 
  125.                 All elements of statusBuffer_o will be set.  If the property was ignored (as described
  126.                 above), then its propertyStatus is set to E_NoError; otherwise, it is set based on the
  127.                 attempt to dispose of the ref.  The propertyValueActualSize fields are all set to 0.
  128.  
  129. */
  130. extern OSStatus FSObjectRefDisposeBulk(ItemCount objectCount_i, ItemCount propertyCount_i, const FSBufferDescriptor *statusBuffer_i, const FSPropertyDescriptor properties_i[], const FSBufferDescriptor *propertiesBuffer_i, FSBufferDescriptor *statusBuffer_o);
  131.  
  132. /**/
  133. extern OSStatus FSObjectRefDisposeBulkAsync(ItemCount objectCount_i, ItemCount propertyCount_i, const FSBufferDescriptor *statusBuffer_i, const FSPropertyDescriptor properties_i[], const FSBufferDescriptor *propertiesBuffer_i, const KernelNotification *completion_i, FSBufferDescriptor *statusBuffer_o, MessageID *requestID_o);
  134.  
  135. /*
  136.     Function:    FSObjectRefRegister
  137.     Purpose:    Allow an FSObjectRef to be used by another process.
  138.     Inputs:
  139.                 senderObject_t        The object ref.
  140.                 receiverPid_i        The other process that will be using senderObject_t.
  141.     Outputs:
  142.     Notes:
  143.                 This call allows one process to send an FSObjectRef to another process
  144.                 such that the other process can use the FSObjectRef itself.  The process
  145.                 specified by receiverPid_i must also dispose of senderObject_t.  The File
  146.                 Manager acts as if senderObject_t has been returned to receiverPid_i.
  147.  
  148.  
  149.  
  150.  
  151.  
  152.                 You might use this call if you have several processes where one process
  153.                 (typically a server of some kind) obtains FSObjectRefs for use by other
  154.                 processes (typically clients of that server).  If the other process (as
  155.                 specified by receiverPid_i) won't actually call the File Manager with
  156.                 that FSObjectRef, then it doesn't need to be registered to that process.
  157.  
  158.                 It would also be possible to have the server process make all of the
  159.                 calls to the File Manager.  FSObjectRefs could still be passed between
  160.                 client and server, but if the clients never use the refs directly, then
  161.                 there would be no need to register the refs to those clients.  (But beware:
  162.                 the server would still be responsible for disposing of all refs returned to
  163.                 it; the server would probably have some cleanup and disposal to do if one
  164.                 of its client processes were to terminate.)
  165. */
  166. extern OSStatus FSObjectRefRegister(FSObjectRef senderObject_t, KernelProcessID receiverPid_i);
  167.  
  168. extern OSStatus FSObjectRefRegisterAsync(FSObjectRef senderObject_t, KernelProcessID receiverPid_i, const KernelNotification *completion_i, MessageID *requestID_o);
  169.  
  170. /*
  171. ============================================================================
  172.     Volume Sets
  173. ============================================================================
  174. */
  175. /*
  176.     Function:    FSVolumeSetGetInformation
  177.     Purpose:    Returns an FSObjectRef for a Volume Set specified by an
  178.                 FSVolumeSetObjID.
  179.     Inputs:
  180.                 volumeSet_t                The volume set.
  181.     Outputs:
  182.                 object_o                Object ref for the volume set.
  183.                 includesBootVolume_o    True if the volume set includes the boot volume.
  184.     Notes:
  185.                 There is currently only one volume set.  In the future there could be others
  186.                 (perhaps file servers; perhaps to support multiple local users).
  187. */
  188. extern OSStatus FSVolumeSetGetInformation(FSVolumeSetObjID volumeSet_t, Boolean *includesBootVolume_o, FSObjectRef *object_o);
  189.  
  190. extern OSStatus FSVolumeSetGetInformationAsync(FSVolumeSetObjID volumeSet_t, const KernelNotification *completion_i, Boolean *includesBootVolume_o, FSObjectRef *object_o, MessageID *requestID_o);
  191.  
  192. /*
  193. ============================================================================
  194.     Volumes
  195. ============================================================================
  196. */
  197. /**/
  198. extern OSStatus FSVolumeGetInformation(FSVolumeObjID volume_t, FSObjectRef *object_o);
  199.  
  200. extern OSStatus FSVolumeGetInformationAsync(FSVolumeObjID volume_t, const KernelNotification *completion_i, FSObjectRef *objectRef_o, MessageID *requestID_o);
  201.  
  202. /* */
  203. extern OSStatus FSVolumeMount(ObjectID device_t, FSVolumeCapabilities requiredCapabilities_i, const FSMountAccessConstraints *constraints_i, FSObjectRef *volume_o);
  204.  
  205. extern OSStatus FSVolumeMountAsync(ObjectID device_t, FSVolumeCapabilities requiredCapabilities_i, const FSMountAccessConstraints *constraints_i, const KernelNotification *completion_i, FSObjectRef *volume_o, MessageID *requestID_o);
  206.  
  207. /* */
  208. extern OSStatus FSVolumeUnmount(FSObjectRef volume_t);
  209.  
  210. extern OSStatus FSVolumeUnmountAsync(FSObjectRef volume_t, const KernelNotification *completion_i, MessageID *requestID_o);
  211.  
  212. /*
  213. ============================================================================
  214.     Folders
  215. ============================================================================
  216. */
  217. /* */
  218. extern OSStatus FSFolderCreateWithProperties(FSObjectRef container_t, ItemCount propertyCount_i, const FSPropertyDescriptor properties_i[], const FSBufferDescriptor *propertiesBuffer_i, FSBufferDescriptor *statusBuffer_o, FSObjectRef *folder_o);
  219.  
  220. extern OSStatus FSFolderCreateWithPropertiesAsync(FSObjectRef container_t, ItemCount propertyCount_i, const FSPropertyDescriptor properties_i[], const FSBufferDescriptor *propertiesBuffer_i, const KernelNotification *completion_i, FSBufferDescriptor *statusBuffer_o, FSObjectRef *folder_o, MessageID *requestID_o);
  221.  
  222. /*
  223. ============================================================================
  224.     Files
  225. ============================================================================
  226. */
  227. /* */
  228. extern OSStatus FSFileCreateWithProperties(FSObjectRef container_t, ItemCount propertyCount_i, const FSPropertyDescriptor properties_i[], const FSBufferDescriptor *propertiesBuffer_i, FSBufferDescriptor *statusBuffer_o, FSObjectRef *file_o);
  229.  
  230. extern OSStatus FSFileCreateWithPropertiesAsync(FSObjectRef container_t, ItemCount propertyCount_i, const FSPropertyDescriptor properties_i[], const FSBufferDescriptor *propertiesBuffer_i, const KernelNotification *completion_i, FSBufferDescriptor *statusBuffer_o, FSObjectRef *file_o, MessageID *requestID_o);
  231.  
  232. /*
  233. ============================================================================
  234.     Folder and File Requests
  235. ============================================================================
  236. */
  237. /**/
  238. extern OSStatus FSObjectCopy(FSObjectRef sourceObject_t, FSObjectRef container_i, ItemCount propertyCount_i, const FSPropertyDescriptor properties_i[], const FSBufferDescriptor *propertiesBuffer_i, FSBufferDescriptor *statusBuffer_o, FSObjectRef *newObject_o);
  239.  
  240. extern OSStatus FSObjectCopyAsync(FSObjectRef sourceObject_t, FSObjectRef container_i, ItemCount propertyCount_i, const FSPropertyDescriptor properties_i[], const FSBufferDescriptor *propertiesBuffer_i, const KernelNotification *completion_i, FSBufferDescriptor *statusBuffer_o, FSObjectRef *newObject_o, MessageID *requestID_o);
  241.  
  242. /*
  243.     Function:    FSObjectDelete
  244.     Purpose:    Deletes an object.  The FSObjectRef is NOT disposed; you must still dispose it yourself.
  245.                 Further attempts to use the ref will return errors (such as E_ObjectNotFound).
  246.  
  247.     Inputs:
  248.                 object_t        The object to be deleted.
  249.     Outputs:
  250. */
  251. extern OSStatus FSObjectDelete(FSObjectRef object_t);
  252.  
  253. extern OSStatus FSObjectDeleteAsync(FSObjectRef object_t, const KernelNotification *completion_i, MessageID *requestID_o);
  254.  
  255. /**/
  256. extern OSStatus FSObjectMove(FSObjectRef sourceObject_t, FSObjectRef container_i, ItemCount propertyCount_i, const FSPropertyDescriptor properties_i[], const FSBufferDescriptor *propertiesBuffer_i, FSBufferDescriptor *statusBuffer_o);
  257.  
  258. extern OSStatus FSObjectMoveAsync(FSObjectRef sourceObject_t, FSObjectRef container_i, ItemCount propertyCount_i, const FSPropertyDescriptor properties_i[], const FSBufferDescriptor *propertyValues_i, const KernelNotification *completion_i, FSBufferDescriptor *statusBuffer_o, MessageID *requestID_o);
  259.  
  260. /*
  261. ****************************************************************************
  262.     PROPERTIES
  263. ****************************************************************************
  264. */
  265. /*
  266. ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  267.     Object Properties
  268. ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  269. */
  270. /**/
  271. extern OSStatus FSObjectCreateProperties(FSObjectRef object_t, ItemCount propertyCount_i, const FSPropertyDescriptor properties_i[], const FSBufferDescriptor *propertiesBuffer_i, FSBufferDescriptor *statusBuffer_o);
  272.  
  273. extern OSStatus FSObjectCreatePropertiesAsync(FSObjectRef object_t, ItemCount propertyCount_i, const FSPropertyDescriptor properties_i[], const FSBufferDescriptor *propertiesBuffer_i, const KernelNotification *completion_i, FSBufferDescriptor *statusBuffer_o, MessageID *requestID_o);
  274.  
  275. /**/
  276. extern OSStatus FSObjectDeleteProperties(FSObjectRef object_t, ItemCount propertyCount_i, const FSProperty properties_i[], FSBufferDescriptor *statusBuffer_o);
  277.  
  278. extern OSStatus FSObjectDeletePropertiesAsync(FSObjectRef object_t, ItemCount propertyCount_i, const FSProperty properties_i[], const KernelNotification *completion_i, FSBufferDescriptor *statusBuffer_o, MessageID *requestID_o);
  279.  
  280. /*>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> C a p a b i l i t i e s <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<*/
  281. /*
  282. ****************************************************************************
  283.     PROPERTY ACCESS METHODS
  284. ****************************************************************************
  285. */
  286. /*
  287. ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  288.     Object Property Simple Values
  289. ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  290. */
  291. /**/
  292. extern OSStatus FSObjectGetProperties(FSObjectRef object_t, ItemCount propertyCount_i, const FSPropertyDescriptor properties_i[], FSBufferDescriptor *propertiesBuffer_o, FSBufferDescriptor *statusBuffer_o);
  293.  
  294. extern OSStatus FSObjectGetPropertiesAsync(FSObjectRef object_t, ItemCount propertyCount_i, const FSPropertyDescriptor properties_i[], const KernelNotification *completion_i, FSBufferDescriptor *propertiesBuffer_o, FSBufferDescriptor *statusBuffer_o, MessageID *requestID_o);
  295.  
  296. /**/
  297. extern OSStatus FSObjectSetProperties(FSObjectRef object_t, ItemCount propertyCount_i, const FSPropertyDescriptor properties_i[], const FSBufferDescriptor *propertiesBuffer_i, FSBufferDescriptor *statusBuffer_o);
  298.  
  299. extern OSStatus FSObjectSetPropertiesAsync(FSObjectRef object_t, ItemCount propertyCount_i, const FSPropertyDescriptor properties_i[], const FSBufferDescriptor *propertiesBuffer_i, const KernelNotification *completion_i, FSBufferDescriptor *statusBuffer_o, MessageID *requestID_o);
  300.  
  301. /*
  302. ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  303.     Object Property Fork Values
  304. ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  305. */
  306. /*
  307. ============================================================================
  308.     Stream-based Access Method
  309. ============================================================================
  310. */
  311. /* */
  312. extern OSStatus FSStreamAllocate(FSStreamObjID stream_t, const FSForkPositionDescriptor *start_i, FSSize length_i, FSForkAllocationPolicy policy_i, FSSize *actualAllocation_o);
  313.  
  314. extern OSStatus FSStreamAllocateAsync(FSStreamObjID stream_t, const FSForkPositionDescriptor *start_i, FSSize length_i, FSForkAllocationPolicy policy_i, const KernelNotification *completion_i, FSSize *actualAllocation_o, MessageID *requestID_o);
  315.  
  316. /*
  317.     Function:    FSStreamClose
  318.     Purpose:    Close a stream previously opened with FSStreamOpen or FSStreamOpenWithConstraints.
  319.     Inputs:
  320.                 stream_t            The stream to close.
  321.     Outputs:
  322.     Notes:
  323.                 Any data written to the stream is flushed (written by the File Manager) before the
  324.                 stream is closed.  The FSStreamObjID, stream_t, may no longer be used.  Any resources
  325.                 allocated by the File Manager for use by this stream will be disposed.
  326. */
  327. extern OSStatus FSStreamClose(FSStreamObjID stream_t);
  328.  
  329. extern OSStatus FSStreamCloseAsync(FSStreamObjID stream_t, const KernelNotification *completion_i, MessageID *requestID_o);
  330.  
  331. /*
  332.     Function:    FSStreamFlush
  333.     Purpose:    Any data written to the stream will be written by the File Manager.
  334.     Inputs:
  335.                 stream_t            The stream to flush.
  336.     Outputs:
  337.     Notes:
  338.                 Stream data may still reside in the File Manager's caches, but any changes will have
  339.                 been written out by the File Manager.  Note that the underlying device's driver, or
  340.                 the device itself, may cache some data, so the File Manager cannot guarantee that
  341.                 all data has actually been written to the underlying media.
  342.                 
  343.                 Other information about the object (such as its modification date) might not be flushed
  344.                 by this call, though any volume-level data needed to access the stream will be.
  345.  
  346.  
  347. */
  348. extern OSStatus FSStreamFlush(FSStreamObjID stream_t);
  349.  
  350. extern OSStatus FSStreamFlushAsync(FSStreamObjID stream_t, const KernelNotification *completion_i, MessageID *requestID_o);
  351.  
  352. /* */
  353. extern OSStatus FSStreamGetEOF(FSStreamObjID stream_t, FSOffset *currentEOF_o);
  354.  
  355. extern OSStatus FSStreamGetEOFAsync(FSStreamObjID stream_t, const KernelNotification *completion_i, FSOffset *currentEOF_o, MessageID *requestID_o);
  356.  
  357. /* */
  358. extern OSStatus FSStreamGetInformation(FSStreamObjID stream_t, FSObjectRef *object_o, FSProperty *fork_o, FSForkAccessConstraints *constraints_o);
  359.  
  360. extern OSStatus FSStreamGetInformationAsync(FSStreamObjID stream_t, const KernelNotification *completion_i, FSObjectRef *object_o, FSProperty *fork_o, FSForkAccessConstraints *constraints_o, MessageID *requestID_o);
  361.  
  362. /*
  363.     Function:    FSStreamGetMark
  364.     Purpose:    Returns the current mark (position offset) for a stream.
  365.     Inputs:
  366.                 stream_t            The stream.
  367.     Outputs:
  368.                 currentMark_o        Current offset in the stream, stream_t.
  369.     Notes:
  370.                 This call returns the offset from the start of the file that would be
  371.                 equivalent to using a FSForkPositionDescriptor whose positionOffset is
  372.                 0, and whose positionMode is kFSFromMark.  A stream's mark is set to
  373.                 the byte following the last read or write, or via FSStreamSetMark.
  374. */
  375. extern OSStatus FSStreamGetMark(FSStreamObjID stream_t, FSOffset *currentMark_o);
  376.  
  377. extern OSStatus FSStreamGetMarkAsync(FSStreamObjID stream_t, const KernelNotification *completion_i, FSOffset *currentMark_o, MessageID *requestID_o);
  378.  
  379. /* */
  380. extern OSStatus FSStreamLockRange(FSStreamObjID stream_t, const FSForkPositionDescriptor *position_i, FSSize length_i, FSRangeLockOptions options_i, FSOffset *rangeStart_o, FSSize *actualLength_o);
  381.  
  382. extern OSStatus FSStreamLockRangeAsync(FSStreamObjID stream_t, const FSForkPositionDescriptor *position_i, FSSize length_i, FSRangeLockOptions options_i, const KernelNotification *completion_i, FSOffset *rangeStart_o, FSSize *actualLength_o, MessageID *requestID_o);
  383.  
  384. /* */
  385. extern OSStatus FSStreamOpenWithConstraints(FSObjectRef object_t, const FSProperty *fork_i, const FSForkAccessConstraints *constraints_i, FSStreamObjID *stream_o);
  386.  
  387. extern OSStatus FSStreamOpenWithConstraintsAsync(FSObjectRef object_t, const FSProperty *fork_i, const FSForkAccessConstraints *constraints_i, const KernelNotification *completion_i, FSStreamObjID *stream_o, MessageID *requestID_o);
  388.  
  389. /* */
  390. extern OSStatus FSStreamRead(FSStreamObjID stream_t, const FSForkPositionDescriptor *position_i, FSStreamIOOptions options_i, FSBufferDescriptor *buffer_o, ByteCount *actualLength_o, FSOffset *currentMark_o);
  391.  
  392. extern OSStatus FSStreamReadAsync(FSStreamObjID stream_t, const FSForkPositionDescriptor *position_i, FSStreamIOOptions options_i, const KernelNotification *completion_i, FSBufferDescriptor *buffer_o, ByteCount *actualLength_o, FSOffset *currentMark_o, MessageID *requestID_o);
  393.  
  394. /* */
  395. extern OSStatus FSStreamReleaseAllocation(FSStreamObjID stream_t, const FSForkPositionDescriptor *start_i, FSSize length_i, FSSize *actualLength_o);
  396.  
  397. extern OSStatus FSStreamReleaseAllocationAsync(FSStreamObjID stream_t, const FSForkPositionDescriptor *start_i, FSSize length_i, const KernelNotification *completion_i, FSSize *actualLength_o, MessageID *requestID_o);
  398.  
  399. /* */
  400. extern OSStatus FSStreamSetEOF(FSStreamObjID stream_t, const FSForkPositionDescriptor *EOF_i, FSForkAllocationPolicy policy_i, FSOffset *currentEOF_o);
  401.  
  402. extern OSStatus FSStreamSetEOFAsync(FSStreamObjID stream_t, const FSForkPositionDescriptor *EOF_i, FSForkAllocationPolicy policy_i, const KernelNotification *completion_i, FSOffset *currentEOF_o, MessageID *requestID_o);
  403.  
  404. /*
  405.     Function:    FSStreamSetMark
  406.     Purpose:    Sets the current mark (position offset) for a stream.
  407.     Inputs:
  408.                 stream_t            The stream.
  409.                 newPosition_i        The new position of the stream's mark.
  410.                 options_i
  411.     Outputs:
  412.                 originalMark_o        The stream's mark, before being changed (relative
  413.                                     to the start of the stream).
  414.                 currentMark_o        The new mark, relative to the start of the stream.
  415.     Notes:
  416.                 A stream's mark is usually used for sequential access to a stream,
  417.                 or to position relative to the ending position of the last operation
  418.                 on a stream.  This call lets you explicitly set the mark for future
  419.                 operations that will operate relative to the current mark.
  420.                 
  421.                 If kFSMarkPinToEOF is set in options_i, and the new position specified
  422.                 by newPosition_i would exceed the current end of the stream (also known
  423.                 as End Of File or EOF), then the mark will be set to the EOF and E_NoError
  424.                 is returned.  Otherwise, an error will returned.  The mark may never be
  425.                 set past the end of the stream.
  426.  
  427.  
  428. */
  429. extern OSStatus FSStreamSetMark(FSStreamObjID stream_t, const FSForkPositionDescriptor *newPosition_i, FSStreamSetMarkOptions options_i, FSOffset *originalMark_o, FSOffset *currentMark_o);
  430.  
  431. extern OSStatus FSStreamSetMarkAsync(FSStreamObjID stream_t, const FSForkPositionDescriptor *newPosition_i, FSStreamSetMarkOptions options_i, const KernelNotification *completion_i, FSOffset *originalMark_o, FSOffset *currentMark_o, MessageID *requestID_o);
  432.  
  433. /* */
  434. extern OSStatus FSStreamUnlockRange(FSStreamObjID stream_t, const FSForkPositionDescriptor *position_i, FSSize length_i, FSRangeLockOptions options_i);
  435.  
  436. extern OSStatus FSStreamUnlockRangeAsync(FSStreamObjID stream_t, const FSForkPositionDescriptor *position_i, FSSize length_i, FSRangeLockOptions options_i, const KernelNotification *completion_i, MessageID *requestID_o);
  437.  
  438. /* */
  439. extern OSStatus FSStreamWrite(FSStreamObjID stream_t, const FSForkPositionDescriptor *position_i, FSStreamIOOptions options_i, const FSBufferDescriptor *buffer_i, ByteCount *actualLength_o, FSOffset *currentMark_o);
  440.  
  441. extern OSStatus FSStreamWriteAsync(FSStreamObjID stream_t, const FSForkPositionDescriptor *position_i, FSStreamIOOptions options_i, const FSBufferDescriptor *buffer_i, const KernelNotification *completion_i, ByteCount *actualLength_o, FSOffset *currentMark_o, MessageID *requestID_o);
  442.  
  443. /*
  444. ============================================================================
  445.     Memory-mapped Access Method(Backing Store Requests)
  446. ============================================================================
  447. */
  448. /*
  449.     Function:    FSMappedFileClose
  450.     Purpose:    Closes an access path to a file used for backing store.
  451.     Inputs:
  452.                 backingStore_t        The backing store object.
  453.     Outputs:
  454.     Notes:
  455.                 Basically the same as FSStreamClose, but for a backing store.
  456.                 
  457.                 All data written to this backing store (by writing to pages backed by
  458.                 this store) will be flushed (written) by the File Manager.
  459. */
  460. extern OSStatus FSMappedFileClose(FSBackingStoreObjID backingStore_t);
  461.  
  462. extern OSStatus FSMappedFileCloseAsync(FSBackingStoreObjID backingStore_t, const KernelNotification *completion_i, MessageID *requestID_o);
  463.  
  464. /*
  465.     Function:    FSMappedFileGetEOF
  466.     Purpose:    Return the EOF (length) of the fork being accessed by the given backing store.
  467.     Inputs:
  468.                 backingStore_t        The backing store used to access the fork.
  469.     Outputs:
  470.                 currentEOF_o        The size, in bytes, of the fork.
  471.     Notes:
  472.                 Since access to a fork via a backing store (i.e. memory mapped file access) is
  473.                 accomplished by directly accessing memory pages, the virtual memory system must
  474.                 read and write entire pages.  If the last page is modified, the entire page is
  475.                 written, resulting in the fork size being rounded up to a multiple of a page size.
  476.                 Similarly for access to pages beyond the fork's EOF.
  477.                 
  478.                 This call returns the current EOF (length) of the underlying fork.  This may be
  479.                 set implicitly by writing to backed pages, or by using the FSBackingStoreSetEOF
  480.                 call.  It may also be changed by streams opened to the same fork.
  481. */
  482. extern OSStatus FSMappedFileGetEOF(FSBackingStoreObjID backingStore_t, FSOffset *currentEOF_o);
  483.  
  484. extern OSStatus FSMappedFileGetEOFAsync(FSBackingStoreObjID backingStore_t, const KernelNotification *completion_i, FSOffset *currentEOF_o, MessageID *requestID_o);
  485.  
  486. /* */
  487. extern OSStatus FSMappedFileGetInformation(FSBackingStoreObjID backingStore_t, FSObjectRef *object_o, FSProperty *fork_o, FSForkAccessConstraints *constraints_o);
  488.  
  489. extern OSStatus FSMappedFileGetInformationAsync(FSBackingStoreObjID backingStore_t, const KernelNotification *completion_i, FSObjectRef *object_o, FSProperty *fork_o, FSForkAccessConstraints *constraints_o, MessageID *requestID_o);
  490.  
  491. /*
  492.     Function:    FSMappedFileSetEOF
  493.     Purpose:    Sets the EOF (length) of the fork being accessed by the given backing store.
  494.     Inputs:
  495.                 backingStore_t        The backing store used to access the fork.
  496.                 EOF_i                The new length (EOF) of the fork.
  497.                 policy_i            Controls how space should be allocated (if the new EOF
  498.                                     is larger than the current EOF).
  499.     Outputs:
  500.                 currentEOF_o        The new size, in bytes, of the fork.
  501.     Notes:
  502.                 Since access to a fork via a backing store (i.e. memory mapped file access) is
  503.                 accomplished by directly accessing memory pages, the virtual memory system must
  504.                 read and write entire pages.  If the last page is modified, the entire page is
  505.                 written, resulting in the fork size being rounded up to a multiple of a page size.
  506.                 Similarly for access to pages beyond the fork's EOF.
  507.                 
  508.                 This call allows the EOF to be explicitly set for a fork being accessed via a
  509.                 backing store.  Any data beyond the EOF will not actually be written to the fork.
  510.                 The File Manager has no way to detect whether access to pages occurs beyond the
  511.                 EOF; it is a programming error to access bytes beyond the EOF via a backing store.
  512.                 
  513.                 This call would typically be used when a fork has been memory mapped to enable
  514.                 convenient access to a file's data structures as if it were completely in memory.
  515.                 You would make all changes to the data structures, then use this call to indicate
  516.                 the number of bytes that are valid and should be written to the fork.
  517. */
  518. extern OSStatus FSMappedFileSetEOF(FSBackingStoreObjID backingStore_t, const FSForkPositionDescriptor *EOF_i, FSForkAllocationPolicy policy_i, FSOffset *currentEOF_o);
  519.  
  520. extern OSStatus FSMappedFileSetEOFAsync(FSBackingStoreObjID backingStore_t, const FSForkPositionDescriptor *EOF_i, FSForkAllocationPolicy policy_i, const KernelNotification *completion_i, FSOffset *currentEOF_o, MessageID *requestID_o);
  521.  
  522. /* */
  523. extern OSStatus FSMappedFileOpenWithConstraints(FSObjectRef object_t, const FSProperty *fork_i, const FSForkAccessConstraints *constraints_i, FSBackingStoreObjID *backingStore_o);
  524.  
  525. extern OSStatus FSMappedFileOpenWithConstraintsAsync(FSObjectRef object_t, const FSProperty *fork_i, const FSForkAccessConstraints *constraints_i, const KernelNotification *completion_i, FSBackingStoreObjID *backingStore_o, MessageID *requestID_o);
  526.  
  527. /*
  528. ****************************************************************************
  529.     NAVIGATION & ENUMERATION
  530. ****************************************************************************
  531. */
  532. /*
  533. ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  534.     Object Iteration
  535. ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  536. */
  537. /**/
  538. extern OSStatus FSObjectIterate(FSObjectIteratorObjID iterator_t, ItemCount objectCount_i, ItemCount propertyCount_i, const FSPropertyDescriptor properties_i[], ItemCount *actualObjectCount_o, FSBufferDescriptor *propertiesBuffer_o, FSBufferDescriptor *statusBuffer_o);
  539.  
  540. extern OSStatus FSObjectIterateAsync(FSObjectIteratorObjID iterator_t, ItemCount objectCount_i, ItemCount propertyCount_i, const FSPropertyDescriptor properties_i[], const KernelNotification *completion_i, ItemCount *actualObjectCount_o, FSBufferDescriptor *propertiesBuffer_o, FSBufferDescriptor *statusBuffer_o, MessageID *requestID_o);
  541.  
  542. /*
  543.     Function:    FSObjectIteratorChangeCurrentScope
  544.     Purpose:    Move an object iterator into or out of a container.
  545.     Inputs:
  546.                 iterator_t        The object iterator.
  547.                 movement_i        The direction to move: into or out of a container.
  548.     Outputs:
  549.     Notes:
  550.                 If movement_i is kFSObjectEnter, then the iterator must be positioned on
  551.                 an object that is capable of containing other objects; it does not need to
  552.                 actually contain any objects at that time.  That object will become the new
  553.                 current scope of the iterator and it will be in Start Of Iteration state
  554.                 (meaning that all objects in the current scope have yet to be returned).
  555.                 The iterator will not be positioned on any object.
  556.                 
  557.                 If movement_i is kFSObjectExit,  then the current scope will become the object
  558.                 that contains the current scope; the iterator's new position will be the object
  559.                 that was the current scope.  If the current scope and the outermost scope were
  560.                 the same, then the outermost scope will also change to the new current scope and
  561.                 E_ExitIteratorScope is returned (so that you realize you will be iterating outside
  562.                 of the scope that you used to create the iterator; the iterator remains usable).
  563.                 
  564.                 Object iterators keep track of all of the objects between the outermost scope and
  565.                 the current scope (this is known as the "scope stack").  If any object in the scope
  566.                 stack is moved, the iterator is invalidated and will return the error
  567.                 E_IteratorScopeException until it has been explicitly fixed (by FSObjectIteratorRecreate)
  568.                 or disposed.  This call adds or removes objects from the scope stack.
  569. */
  570. extern OSStatus FSObjectIteratorChangeCurrentScope(FSObjectIteratorObjID iterator_t, FSObjectIteratorMovement movement_i);
  571.  
  572. extern OSStatus FSObjectIteratorChangeCurrentScopeAsync(FSObjectIteratorObjID iterator_t, FSObjectIteratorMovement movement_i, const KernelNotification *completion_i, MessageID *requestID_o);
  573.  
  574. /**/
  575. extern OSStatus FSObjectIteratorClone(FSObjectIteratorObjID iterator_t, FSObjectIteratorObjID *clone_o);
  576.  
  577. extern OSStatus FSObjectIteratorCloneAsync(FSObjectIteratorObjID iterator_t, const KernelNotification *completion_i, FSObjectIteratorObjID *clone_o, MessageID *requestID_o);
  578.  
  579. /*
  580.     Function:    FSObjectIteratorCreate
  581.     Purpose:    Create an iterator for iterating over objects.
  582.     Inputs:
  583.                 outermostScope_t        The initial outermost scope and current scope.
  584.                 options_i                Controls whether the iterator will traverse objects in
  585.                                         a single container or all embedded (nested) containers.
  586.                                         Also controls which kinds of objects will be returned.
  587.     Outputs:
  588.                 iterator_o                The object iterator.
  589.     Notes:
  590.                 The outermost scope and current scope of the iterator are set to outermostScope_t.
  591.                 The iterator is not positioned on any object, though it is inside outermostScope_t.
  592.                 OutermostScope_t must be an object capable of containing other objects (such as the
  593.                 Universe, a volume set, a volume, or a folder).  The iterator is put into "Start Of
  594.                 Iteration" state, meaning that all objects in the current scope have yet to be
  595.                 returned.
  596.                 
  597.                 The File Manager allocates resources and maintains state for every iterator.  When
  598.                 you have finished using an iterator, you should call FSObjectIteratorDispose to dispose
  599.                 of it.
  600. */
  601. extern OSStatus FSObjectIteratorCreate(FSObjectRef outermostScope_t, FSObjectIteratorCreationOptions options_i, FSObjectIteratorObjID *iterator_o);
  602.  
  603. extern OSStatus FSObjectIteratorCreateAsync(FSObjectRef outermostScope_t, FSObjectIteratorCreationOptions options_i, const KernelNotification *completion_i, FSObjectIteratorObjID *iterator_o, MessageID *requestID_o);
  604.  
  605. /*
  606.     Function:    FSObjectIteratorDispose
  607.     Purpose:    Dispose of an object iterator.
  608.     Inputs:
  609.                 iterator_t        The object iterator.
  610.     Outputs:
  611.     Notes:
  612.                 The File Manager will dispose of the iterator and release any resources
  613.                 allocated to the iterator.  Further attempts to use the iterator will result
  614.                 in an error.
  615.  
  616.  
  617. */
  618. extern OSStatus FSObjectIteratorDispose(FSObjectIteratorObjID iterator_t);
  619.  
  620. extern OSStatus FSObjectIteratorDisposeAsync(FSObjectIteratorObjID iterator_t, const KernelNotification *completion_i, MessageID *requestID_o);
  621.  
  622. /**/
  623. extern OSStatus FSObjectIteratorGetInformation(FSObjectIteratorObjID iterator_t, FSObjectRef *outermostScope_o, FSObjectRef *currentScope_o, FSObjectIteratorCreationOptions *options_o, FSObjectIteratorState *state_o);
  624.  
  625. extern OSStatus FSObjectIteratorGetInformationAsync(FSObjectIteratorObjID iterator_t, const KernelNotification *completion_i, FSObjectRef *outermostScope_o, FSObjectRef *currentScope_o, FSObjectIteratorCreationOptions *options_o, FSObjectIteratorState *state_o, MessageID *requestID_o);
  626.  
  627. /**/
  628. extern OSStatus FSObjectIteratorRecreate(FSObjectIteratorObjID iterator_t, FSObjectRef outermostScope_i, Boolean preserveCurrentOptions_i, FSObjectIteratorCreationOptions options_i);
  629.  
  630. extern OSStatus FSObjectIteratorRecreateAsync(FSObjectIteratorObjID iterator_t, FSObjectRef outermostScope_i, Boolean preserveCurrentOptions_i, FSObjectIteratorCreationOptions options_i, const KernelNotification *completion_i, MessageID *requestID_o);
  631.  
  632. /*
  633.     Function:    FSObjectIteratorRestart
  634.     Purpose:    Place an object iterator in the Start Of Iterator state, in its current scope.
  635.     Inputs:
  636.                 iterator_t        The object iterator.
  637.     Outputs:
  638.     Notes:
  639.                 The iterator is not positioned on any object.  The iterator is put into "Start Of
  640.                 Iteration" state, meaning that all objects in the current scope have yet to be
  641.                 returned.
  642.                 
  643.                 You would use this call to completely restart iteration within the current scope,
  644.                 ignoring any state about objects previously returned in the current scope.  The
  645.                 outermost scope is not affected.  State information about which objects have been
  646.                 returned from scopes outside the current scope is unchanged.
  647. */
  648. extern OSStatus FSObjectIteratorRestart(FSObjectIteratorObjID iterator_t);
  649.  
  650. extern OSStatus FSObjectIteratorRestartAsync(FSObjectIteratorObjID iterator_t, const KernelNotification *completion_i, MessageID *requestID_o);
  651.  
  652. /*
  653. ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  654.     Object Resolution
  655. ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  656. */
  657. /*
  658.     Function:    FSObjectExchange
  659.     Purpose:    Exchange the properties of two objects.  Typically used for "safe
  660.                 saving", while maintaining an object's persistent reference.
  661.     Inputs:
  662.                 object1_i        One object.
  663.                 object2_i        The object to exchange it with.
  664.     Outputs:
  665.     Notes:
  666.                 This call is used to allow a "safe save" that preserves an object's
  667.                 persistent reference.  For example, you might want to save an updated
  668.                 set of properties to an object so that any errors while saving result
  669.                 in the object being unchanged; but, you also want the object's persistent
  670.                 reference to remain unchanged (so that things like aliases still work).
  671.                 
  672.                 What you would do is create a second object somewhere (in a temporary
  673.                 folder, for example).  Write out all of the properties, both unchanged
  674.                 and changed, to the second object.  When done saving, you would call
  675.                 FSObjectExchange with both objects; the contents of the two objects get
  676.                 swapped in such a way that the original object has the new properties,
  677.                 but retains its old persistent reference.
  678.  
  679.  
  680. */
  681. extern OSStatus FSObjectExchange(FSObjectRef object1_i, FSObjectRef object2_i);
  682.  
  683. extern OSStatus FSObjectExchangeAsync(FSObjectRef object1_i, FSObjectRef object2_i, const KernelNotification *completion_i, MessageID *requestID_o);
  684.  
  685. /*
  686.     Function:    FSObjectRefGetFSSpec
  687.     Purpose:    Return an FSSpec for an object (suitable for use with the Files API).
  688.     Inputs:
  689.                 object_t            The object.
  690.     Outputs:
  691.                 fSSpec_o            An FSSpec that specifies the same object as object_t,
  692.                                     suitable for use with the Files API.
  693.     Notes:
  694.                 This call is intended to be used by code that is required to use both the
  695.                 Files API and the FileManager API (or has clients that use both APIs).
  696.                 For example, a piece of code may already exist with an API that uses FSSpecs,
  697.                 but has been converted internally to use the FSObjectRefs; it would use this
  698.                 call to produce an FSSpec as an output for the pre-existing API.
  699.                 
  700.                 It would be best to provide an API that allows its clients to use FSObjectRefs.
  701. */
  702. extern OSStatus FSObjectRefGetFSSpec(FSObjectRef object_t, FSSpec *fSSpec_o);
  703.  
  704. extern OSStatus FSObjectRefGetFSSpecAsync(FSObjectRef object_t, const KernelNotification *completion_i, FSSpec *fSSpec_o, MessageID *requestID_o);
  705.  
  706. /**/
  707. extern OSStatus FSObjectLocate(FSObjectRef container_t, ItemCount elementCount_i, const FSObjectPathwayElement pathway_i[], const FSBufferDescriptor *pathwayPropertiesBuffer_i, FSObjectRef *object_o);
  708.  
  709. extern OSStatus FSObjectLocateAsync(FSObjectRef container_t, ItemCount elementCount_i, const FSObjectPathwayElement pathway_i[], const FSBufferDescriptor *pathwayPropertiesBuffer_i, const KernelNotification *completion_i, FSObjectRef *object_o, MessageID *requestID_o);
  710.  
  711. /**/
  712. extern OSStatus FSObjectPersistentReferenceResolve(FSVolumeObjID volume_t, const FSObjectPersistentReference *persistentReference_i, FSObjectRef *object_o);
  713.  
  714. extern OSStatus FSObjectPersistentReferenceResolveAsync(FSVolumeObjID volume_t, const FSObjectPersistentReference *persistentReference_i, const KernelNotification *completion_i, FSObjectRef *object_o, MessageID *requestID_o);
  715.  
  716. /* */
  717. extern OSStatus FSObjectRefResolve(FSObjectRef object_t, FSVolumeObjID *objectsVolume_o, FSVolumeSetObjID *objectsVolumeSet_o);
  718.  
  719. extern OSStatus FSObjectRefResolveAsync(FSObjectRef object_t, const KernelNotification *completion_i, FSVolumeObjID *objectsVolume_o, FSVolumeSetObjID *objectsVolumeSet_o, MessageID *requestID_o);
  720.  
  721. /*
  722.     Function:    FSSpecGetFSObjectRef
  723.     Purpose:    Return an FSObjectRef for an object specified via an FSSpec.
  724.     Inputs:
  725.                 theFSSpec_t            An FSSpec for the object.
  726.     Outputs:
  727.                 theObject_o            An FSObjectRef for the object.
  728.     Notes:
  729.                 This call is intended to be used by code that is required to use both the
  730.                 Files API and the FileManager API (or has clients that use both APIs).
  731.                 For example, a piece of code may already exist with an API that uses FSSpecs,
  732.                 but has been converted internally to use the FSObjectRefs; it would use this
  733.                 call to take an input FSSpec and convert it to an FSObjectRef to use internally;
  734.                 the FSObjectRef would then be disposed before completing the call.
  735.                 
  736.                 It would be best to provide an API that allows its clients to use FSObjectRefs.
  737. */
  738. extern OSStatus FSSpecGetFSObjectRef(const FSSpec *theFSSpec_t, FSObjectRef *theObject_o);
  739.  
  740. /* */
  741. extern OSStatus FSUniverseResolve(FSObjectRef *theUniverse_o);
  742.  
  743. extern OSStatus FSUniverseResolveAsync(FSObjectRef *theUniverse_o, const KernelNotification *theCompletion_i, MessageID *theRequestID_o);
  744.  
  745. /*>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> F a c i l i t i e s <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<*/
  746. /*
  747. ============================================================================
  748.     Cache Flush Routines
  749. ============================================================================
  750. */
  751. /*
  752.     Function:    FSObjectFlush
  753.     Purpose:    Flushes any data cached by the File Manager for the given object.
  754.     Inputs:
  755.                 object_t        The object to be flushed.
  756.     Outputs:
  757.     Notes:
  758.                 If object_t is a file, then any data written to that file (via a stream or backing store,
  759.                 regardless of the process that opened the stream or backing store) will be written by the
  760.                 File Manager to any underlying device.  If object_t is a volume, then any data written to
  761.                 any file on that volume will be flushed.
  762.                 
  763.                 Any change to properties of object_t will be flushed (regardless of the object's type).
  764.                 
  765.                 Data about the object (or contained in the object) may still reside in the File Manager's
  766.                 caches, but any changes will have been written out by the File Manager.  Note that the
  767.                 underlying device's driver, or the device itself, may cache some data, so the File Manager
  768.                 cannot guarantee that all data has actually been written to the underlying media.
  769.  
  770.  
  771.  
  772. */
  773. extern OSStatus FSObjectFlush(FSObjectRef object_t);
  774.  
  775. extern OSStatus FSObjectFlushAsync(FSObjectRef object_t, const KernelNotification *completion_i, MessageID *requestID_o);
  776.  
  777. /*
  778. ============================================================================
  779.     Request Cancellation Routines
  780. ============================================================================
  781. */
  782. /* */
  783. extern OSStatus FSRequestCancel(MessageID theRequestID_i);
  784.  
  785. #define FSObjectGetPropertyValues            FSObjectGetProperties
  786. #define FSObjectSetPropertyValues            FSObjectSetProperties
  787. #define FSBackingStoreClose                    FSMappedFileClose
  788. #define FSBackingStoreGetEOF                FSMappedFileGetEOF
  789. #define FSBackingStoreGetInformation        FSMappedFileGetInformation
  790. #define FSBackingStoreSetEOF                FSMappedFileSetEOF
  791. #define FSBackingStoreOpenWithConstraints    FSMappedFileOpenWithConstraints
  792. /*
  793. ============================================================================
  794.     Object Property Sizes
  795. ============================================================================
  796. */
  797. /**/
  798. extern OSStatus FSObjectGetForkPropertyPhysicalSizes(FSObjectRef object_t, ItemCount propertyCount_i, const FSPropertyDescriptor properties_i[], FSBufferDescriptor *propertiesBuffer_o, FSBufferDescriptor *statusBuffer_o);
  799.  
  800. /**/
  801. extern OSStatus FSObjectGetPropertySizes(FSObjectRef object_t, ItemCount propertyCount_i, const FSPropertyDescriptor properties_i[], FSBufferDescriptor *propertiesBuffer_o, FSBufferDescriptor *statusBuffer_o);
  802.  
  803. #endif
  804. #endif
  805.  
  806. #pragma options align=reset
  807. #endif /* PRAGMA_ALIGN_SUPPORTED */
  808.  
  809. #if PRAGMA_IMPORT_SUPPORTED
  810. #pragma import off
  811. #endif
  812.  
  813. #ifdef __cplusplus
  814. }
  815. #endif
  816.  
  817. #endif /* __FILEMANAGERSPI__ */
  818.  
  819.