darwin/subsystem.h

   1 /*
   2 * Copyright (c) 2019 Apple Inc. All rights reserved.
   3 *
   4 * @APPLE_LICENSE_HEADER_START@
   5 *
   6 * This file contains Original Code and/or Modifications of Original Code
   7 * as defined in and that are subject to the Apple Public Source License
   8 * Version 2.0 (the 'License'). You may not use this file except in
   9 * compliance with the License. Please obtain a copy of the License at
  10 * http://www.opensource.apple.com/apsl/ and read it before using this
  11 * file.
  12 *
  13 * The Original Code and all software distributed under the License are
  14 * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
  15 * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
  16 * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
  17 * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
  18 * Please see the License for the specific language governing rights and
  19 * limitations under the License.
  20 *
  21 * @APPLE_LICENSE_HEADER_END@
  22 */
  23
  24 #ifndef __SUBSYSTEM_H__
  25 #define __SUBSYSTEM_H__
  26
  27 #include <sys/stat.h>
  28
  29 __BEGIN_DECLS
  30 /*
  31  * Returns an fd for the given path, relative to root or to
  32  * the subsystem root for the process.  Behaves exactly like
  33  * open in every way, except O_CREAT is forbidden.
  34  *
  35  * Returns a file descriptor on success, or -1 on failure.
  36  * errno is set exactly as open would have set it, except
  37  * that O_CREAT will result in EINVAL.
  38  */
  39 int open_with_subsystem(const char * path, int oflag);
  40
  41 /*
  42  * Invokes stat for the given path, relative to root or to
  43  * the subsystem root for the process.  Behaves exactly like
  44  * stat in every way.
  45  *
  46  * Returns 0 on success, or -1 on failure.  On failure, errno
  47  * is set exactly as stat would have set it.
  48  */
  49 int stat_with_subsystem(const char *__restrict path, struct stat *__restrict buf);
  50 __END_DECLS
  51
  52 #endif /* __SUBSYSTEM_H__ */