annotate common/system.h @ 0:1158cffe5a5e

Initial import
author David Demelier <markand@malikania.fr>
date Mon, 08 Feb 2016 16:43:14 +0100
parents
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
1 /*
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
2 * system.h -- platform dependent functions for system inspection
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
3 *
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
4 * Copyright (c) 2013-2016 David Demelier <markand@malikania.fr>
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
5 *
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
6 * Permission to use, copy, modify, and/or distribute this software for any
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
7 * purpose with or without fee is hereby granted, provided that the above
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
8 * copyright notice and this permission notice appear in all copies.
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
9 *
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
10 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
11 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
12 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
13 * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
14 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
15 * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
16 * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
17 */
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
18
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
19 #ifndef _IRCCD_SYSTEM_H_
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
20 #define _IRCCD_SYSTEM_H_
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
21
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
22 /**
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
23 * @file system.h
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
24 * @brief System dependant functions
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
25 */
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
26
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
27 #include <irccd-config.h>
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
28
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
29 #include <cstdint>
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
30 #include <string>
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
31
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
32 namespace irccd {
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
33
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
34 namespace sys {
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
35
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
36 /**
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
37 * Set the program name, needed for some functions or some systems.
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
38 *
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
39 * @param name the program name
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
40 */
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
41 void setProgramName(std::string name) noexcept;
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
42
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
43 /**
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
44 * Get the program name.
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
45 *
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
46 * @return the program name
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
47 */
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
48 const std::string &programName() noexcept;
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
49
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
50 /**
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
51 * Get the system name.
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
52 *
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
53 * @return the name
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
54 */
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
55 std::string name();
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
56
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
57 /**
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
58 * Get the system version.
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
59 *
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
60 * @return the version
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
61 */
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
62 std::string version();
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
63
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
64 /**
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
65 * Get the number of seconds elapsed since the boottime.
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
66 *
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
67 * @return the number of seconds
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
68 */
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
69 uint64_t uptime();
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
70
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
71 /**
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
72 * Get the milliseconds elapsed since the application
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
73 * startup.
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
74 *
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
75 * @return the milliseconds
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
76 */
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
77 uint64_t ticks();
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
78
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
79 /**
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
80 * Get an environment variable.
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
81 *
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
82 * @return the value or empty string
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
83 */
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
84 std::string env(const std::string &var);
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
85
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
86 /**
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
87 * Get home directory usually /home/foo
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
88 *
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
89 * @return the home directory
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
90 */
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
91 std::string home();
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
92
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
93 #if defined(HAVE_SETUID)
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
94
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
95 /**
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
96 * Set the effective uid by name or numeric value.
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
97 *
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
98 * @param value the value
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
99 */
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
100 void setUid(const std::string &value);
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
101
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
102 #endif
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
103
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
104 #if defined(HAVE_SETGID)
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
105
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
106 /**
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
107 * Set the effective gid by name or numeric value.
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
108 *
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
109 * @param value the value
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
110 */
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
111 void setGid(const std::string &value);
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
112
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
113 #endif
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
114
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
115 } // !sys
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
116
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
117 } // !irccd
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
118
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
119 #endif // !_IRCCD_SYSTEM_H_