mirror of
https://gitlab.freedesktop.org/mesa/mesa.git
synced 2026-01-06 11:00:11 +01:00
eeb54aa92d
Signed-off-by: Yonggang Luo <luoyonggang@gmail.com> Reviewed-by: Yiwei Zhang <zzyiwei@chromium.org> Acked-by: Antonio Ospite <antonio.ospite@collabora.com> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/38128>
155 lines
4.2 KiB
C
155 lines
4.2 KiB
C
/**************************************************************************
|
|
*
|
|
* Copyright 2010 VMware, Inc.
|
|
* All Rights Reserved.
|
|
*
|
|
* Permission is hereby granted, free of charge, to any person obtaining a
|
|
* copy of this software and associated documentation files (the
|
|
* "Software"), to deal in the Software without restriction, including
|
|
* without limitation the rights to use, copy, modify, merge, publish,
|
|
* distribute, sub license, and/or sell copies of the Software, and to
|
|
* permit persons to whom the Software is furnished to do so, subject to
|
|
* the following conditions:
|
|
*
|
|
* The above copyright notice and this permission notice (including the
|
|
* next paragraph) shall be included in all copies or substantial portions
|
|
* of the Software.
|
|
*
|
|
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
|
|
* OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
|
|
* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.
|
|
* IN NO EVENT SHALL VMWARE AND/OR ITS SUPPLIERS BE LIABLE FOR
|
|
* ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
|
|
* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
|
|
* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
|
*
|
|
**************************************************************************/
|
|
|
|
|
|
/*
|
|
* Miscellaneous OS services.
|
|
*/
|
|
|
|
|
|
#ifndef _OS_MISC_H_
|
|
#define _OS_MISC_H_
|
|
|
|
#include <stdint.h>
|
|
#include <stdbool.h>
|
|
|
|
#include "util/detect.h"
|
|
|
|
|
|
#if DETECT_OS_POSIX
|
|
# include <signal.h> /* for kill() */
|
|
# include <unistd.h> /* getpid() */
|
|
#endif
|
|
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
|
|
/*
|
|
* Trap into the debugger.
|
|
*/
|
|
#if (DETECT_ARCH_X86 || DETECT_ARCH_X86_64) && DETECT_CC_GCC
|
|
# define os_break() __asm("int3")
|
|
#elif DETECT_CC_MSVC
|
|
# define os_break() __debugbreak()
|
|
#elif DETECT_OS_POSIX
|
|
# define os_break() kill(getpid(), SIGTRAP)
|
|
#else
|
|
# define os_break() abort()
|
|
#endif
|
|
|
|
|
|
/*
|
|
* Abort the program.
|
|
*/
|
|
#if MESA_DEBUG
|
|
# define os_abort() do { os_break(); abort(); } while(0)
|
|
#else
|
|
# define os_abort() abort()
|
|
#endif
|
|
|
|
|
|
/*
|
|
* Output a message. Message should preferably end in a newline.
|
|
*/
|
|
void
|
|
os_log_message(const char *message);
|
|
|
|
|
|
/*
|
|
* Get an option. Should return NULL if specified option is not set.
|
|
* It has the same disadvantage as getenv, see
|
|
* https://wiki.sei.cmu.edu/confluence/display/c/ENV34-C.+Do+not+store+pointers+returned+by+certain+functions
|
|
*/
|
|
const char *
|
|
os_get_option(const char *name);
|
|
|
|
/*
|
|
* Equivalent to os_get_option except the return value need to be `free()`
|
|
* os_get_option is not safe when the returned value is not immediately used.
|
|
* E.g.
|
|
* 1. when multiple consecutive calls to os_get_option are performed before using the returned values
|
|
* 2. when the value returned by os_get_option is assigned to a struct member
|
|
*/
|
|
char *
|
|
os_get_option_dup(const char *name);
|
|
|
|
/*
|
|
* Get an option. Should return NULL if specified option is not set.
|
|
* Same as `os_get_option()` but uses `secure_getenv()` instead of `getenv()`
|
|
*/
|
|
const char *
|
|
os_get_option_secure(const char *name);
|
|
|
|
/*
|
|
* Equivalent to os_get_option_secure except the return value need to be `free()`
|
|
* os_get_option_secure is not safe when the returned value is not immediately used.
|
|
* E.g.
|
|
* 1. when multiple consecutive calls to os_get_option_secure are performed before using the returned values
|
|
* 2. when the value returned by os_get_option_secure is assigned to a struct member
|
|
*/
|
|
char *
|
|
os_get_option_secure_dup(const char *name);
|
|
|
|
/*
|
|
* Get an option. Should return NULL if specified option is not set.
|
|
* It's will save the option into hash table for the first time, and
|
|
* for latter calling, it's will return the value comes from hash table
|
|
* directly, and the returned value will always be valid before program exit
|
|
* The disadvantage is that setenv, unsetenv, putenv won't take effect
|
|
* after this function is called
|
|
*/
|
|
const char *
|
|
os_get_option_cached(const char *name);
|
|
|
|
/*
|
|
* Get the total amount of physical memory available on the system.
|
|
*/
|
|
bool
|
|
os_get_total_physical_memory(uint64_t *size);
|
|
|
|
/*
|
|
* Amount of physical memory available to a process
|
|
*/
|
|
bool
|
|
os_get_available_system_memory(uint64_t *size);
|
|
|
|
/*
|
|
* Size of a page
|
|
*/
|
|
bool
|
|
os_get_page_size(uint64_t *size);
|
|
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
|
|
#endif /* _OS_MISC_H_ */
|