xref: /aosp_15_r20/external/llvm-libc/src/errno/libc_errno.h (revision 71db0c75aadcf003ffe3238005f61d7618a3fead)
1*71db0c75SAndroid Build Coastguard Worker //===-- Implementation header for libc_errno --------------------*- C++ -*-===//
2*71db0c75SAndroid Build Coastguard Worker //
3*71db0c75SAndroid Build Coastguard Worker // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4*71db0c75SAndroid Build Coastguard Worker // See https://llvm.org/LICENSE.txt for license information.
5*71db0c75SAndroid Build Coastguard Worker // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
6*71db0c75SAndroid Build Coastguard Worker //
7*71db0c75SAndroid Build Coastguard Worker //===----------------------------------------------------------------------===//
8*71db0c75SAndroid Build Coastguard Worker 
9*71db0c75SAndroid Build Coastguard Worker #ifndef LLVM_LIBC_SRC_ERRNO_LIBC_ERRNO_H
10*71db0c75SAndroid Build Coastguard Worker #define LLVM_LIBC_SRC_ERRNO_LIBC_ERRNO_H
11*71db0c75SAndroid Build Coastguard Worker 
12*71db0c75SAndroid Build Coastguard Worker #include "src/__support/macros/attributes.h"
13*71db0c75SAndroid Build Coastguard Worker #include "src/__support/macros/config.h"
14*71db0c75SAndroid Build Coastguard Worker #include "src/__support/macros/properties/architectures.h"
15*71db0c75SAndroid Build Coastguard Worker 
16*71db0c75SAndroid Build Coastguard Worker #include "hdr/errno_macros.h"
17*71db0c75SAndroid Build Coastguard Worker 
18*71db0c75SAndroid Build Coastguard Worker // This header is to be consumed by internal implementations, in which all of
19*71db0c75SAndroid Build Coastguard Worker // them should refer to `libc_errno` instead of using `errno` directly from
20*71db0c75SAndroid Build Coastguard Worker // <errno.h> header.
21*71db0c75SAndroid Build Coastguard Worker 
22*71db0c75SAndroid Build Coastguard Worker // Unit and hermetic tests should:
23*71db0c75SAndroid Build Coastguard Worker // - #include "src/errno/libc_errno.h"
24*71db0c75SAndroid Build Coastguard Worker // - NOT #include <errno.h>
25*71db0c75SAndroid Build Coastguard Worker // - Only use `libc_errno` in the code
26*71db0c75SAndroid Build Coastguard Worker // - Depend on libc.src.errno.errno
27*71db0c75SAndroid Build Coastguard Worker 
28*71db0c75SAndroid Build Coastguard Worker // Integration tests should:
29*71db0c75SAndroid Build Coastguard Worker // - NOT #include "src/errno/libc_errno.h"
30*71db0c75SAndroid Build Coastguard Worker // - #include <errno.h>
31*71db0c75SAndroid Build Coastguard Worker // - Use regular `errno` in the code
32*71db0c75SAndroid Build Coastguard Worker // - Still depend on libc.src.errno.errno
33*71db0c75SAndroid Build Coastguard Worker 
34*71db0c75SAndroid Build Coastguard Worker namespace LIBC_NAMESPACE_DECL {
35*71db0c75SAndroid Build Coastguard Worker 
36*71db0c75SAndroid Build Coastguard Worker extern "C" int *__llvm_libc_errno() noexcept;
37*71db0c75SAndroid Build Coastguard Worker 
38*71db0c75SAndroid Build Coastguard Worker struct Errno {
39*71db0c75SAndroid Build Coastguard Worker   void operator=(int);
40*71db0c75SAndroid Build Coastguard Worker   operator int();
41*71db0c75SAndroid Build Coastguard Worker };
42*71db0c75SAndroid Build Coastguard Worker 
43*71db0c75SAndroid Build Coastguard Worker extern Errno libc_errno;
44*71db0c75SAndroid Build Coastguard Worker 
45*71db0c75SAndroid Build Coastguard Worker } // namespace LIBC_NAMESPACE_DECL
46*71db0c75SAndroid Build Coastguard Worker 
47*71db0c75SAndroid Build Coastguard Worker #endif // LLVM_LIBC_SRC_ERRNO_LIBC_ERRNO_H
48