nxde

h2. Bash library nxhshlib

<pre>

prime_user

</pre>

Returns the username of the first user having an X session running. This is used in various nxhelper tools, for example for screen locking or messegae sending.

> This is kind of stub.\

> Screen locking should happen for all X session, all logged in VTs and even for all Wayland sessions.\

> Messages should also go to all users. Or maybe not, because of security.\

> This is all kind of a mess to be sorted out. For now, it works for me in a single seat scenario. It most certainly will NOT work in a multi-seat setup.

> **WARNING** this is probably a security issue. At least for multi seat and/or multi user setups.

<pre>

mount_dev_is_blocked dev

</pre>

Returns 0 if `dev` is blocked by key _mount_block_ in either system or session config. 1 otherwise.

> This is buggy: The user should be able to block additional devices, but not mask devices blocked by system. But right now, any user blocked device masks all system blocked devices.

<pre>

umount_dev_is_auto_blocked dev

</pre>

Returns 0 if `dev` is blocked for auto-mount by key umount_auto_skip in either system or session config. 1 otherwise.

> This is buggy: The user should be able to block additional devices, but not mask devices blocked by system. But right now, any user blocked device masks all system blocked devices.

<pre>

dev_is_mountable dev mounted

</pre>

Returns 0 if `dev` is mountable, eg its neither blocked nor already mounted (as by the list of mounted deviced `mounted`). 

<pre>

get_mountable_devs

</pre>

Stores a list of "mountable devices" in `$devices`. This list is dependant on the type of mounter which is configured by key _mount_method_: udiskie or pmount.

* For udiskie, those are all devices reported by `udiskie-info -a -f is_filesystem` which are mountable according to **dev_is_mountable**

* For pmount, those are all devices stated in key _mount_devs_ which are mountable according to **dev_is_mountable**

<pre>

get_unmountable_devs

</pre>

Stores a list of "unmountable devices" in `$devices`. This list is dependant on the type of mounter which is configured by key _mount_method_: udiskie or pmount.

* For udiskie, those are all devices mounted under _/run/media/USER_

* For pmount, those are all devices mounted under _/media_

<pre>

display_by_username user

</pre>

Echoes the X11 Display (as in `$DISPLAY`) for `user` (if any). Returns 0 if `user` has one, 1 otherwise.

> This is not much tested and may fail.

<pre>

is_docked

</pre>

Return 0 if the system is docked, 1 otherwise. Does (in theory) the same as **is_docked** from nxhclib (Parameter `pseudo_dock` is read as value of key _pseudo_dock_.