nxde

h1. C library nxhclib

<pre><code class="c">

int nxh_base_dir_filter(const struct dirent *dir);

</code></pre>

Basic filter for scandir: filter '.' and '..'.

<pre><code class="c">

int nxh_isexecutable(const char *filename);

int nxh_isfifo(const char *filename);

int nxh_fileexists(const char* filename);

int nxh_direxists(const char* dirname);

</code></pre>

Exactly what it says on the tin. Return 1 on full succes, 0 on successful test but unmatched condition and -1 on unsuccessful test.

<pre><code class="c">

char* nxh_which(const char *cmd);

</code></pre>

Hopefully the same as the shell command `which`. Return has to be freed. NULL if not found.

<pre><code class="c">

int nxh_has_sysdaemon();

</code></pre>

Returns 1 if **nxsysdaemon** is running, responsive and has a matching protocol version. 0 else.

<pre><code class="c">

int nxh_whisper(char *answer, int len, const char *question);

</code></pre>

Whispers a `question` to **nxsysdaemon**, stores the answer (up to `len` characters) in `answer`. Returns number of bytes read on success, -1 else.

<pre><code class="c">

int nxh_get_curbright();

</code></pre>

Gets the currently set display brightness (see **nxsysdaemon** for details).

<pre><code class="c">

int nxh_get_maxbright();

</code></pre>

Gets the maximum display brightness (see **nxsysdaemon** for details).

<pre><code class="c">

int nxh_set_bright();

</code></pre>

Sets the current display brightness (see **nxsysdaemon** for details).

<pre><code class="c">

int nxh_is_onac();

</code></pre>

Returns 1 if the system is on AC, 0 otherwise (see **nxsysdaemon** for details).

<pre><code class="c">

int nxh_is_save_wifi(const char *save_networks);

</code></pre>

Returns 1 if the system is connected to a WiFi network with ESSID `save_networks`. 0 if not. -1 if testing was impossible.

<pre><code class="c">

int nxh_is_locked();

</code></pre>

Returns 1 if the system is locked with **nxulock**. 0 if not. -1 if testing was impossible.

<pre><code class="c">

int nxh_is_docked(const char *pseudo_dock);

</code></pre>

Returns 1 if the system is docked. Either with a classic (kernel supported) dock, or to a USB pseudo dock given by pseudo_dock (VENDOR:DEVICE).