libnss-maria" class="reference-link"> libnss-maria

Replacement for old libnss-mysql as a naming service library for Linux.

You can store user and group information in MariaDB or MySQL database. E.g. ls then automatically shows user name from the database, getent shows users and groups.

Features

implements password, shadow and group getters
cmake build system
libconfig for configuration
uses direct queries and real_escape_string
uses threads.c from C11
requirements: Glibc 2.28 or newer, GCC 8 or newer, equivalent of Debian 10 (Buster) or newer, MySQL 5.5+/MariaDB 10.0+, mariadb-connector-c/libmysqlclient. Might work or compile on older systems, but it’s untested
tested systems - latest Archlinux, Debian, Fedora, Ubuntu and Ubuntu LTS
both unix socket and hostname + port are supported
accepts custom mysql client configuration
shouldn’t be used with SUID programs

TODO

deb + rpm packages
mysql/mariadb lib should not be linked and loaded, but separated - architecture like nss_ldapd would be nice
add RHEL (does not have bats) or Rockylinux/AlmaLinux
not sure if MySQL works correctly, the test fails on buff_test which means it does not increase buffer size for long result

Feedback is welcome.

Installation & Usage

See examples and scripts/compile_and_test.sh to see how to set it up and use.

Build && Test in Docker

docker compose up
./scripts/build-docker.sh

The result is in ./Debug/src directory.

Build && Test in Vagrant

brew cask install vagrant
brew cask install virtualbox
vagrant plugin install vagrant-vbguest
vagrant up
./scripts/build-vagrant.sh
# or ./scripts/build-vagrant-release.sh

The result is in ./Debug/src or ./Release/srcdirectory.

Build && Test on a Linux system

Required libraries for building the library and test, browse docker/Dockerfile* to see required packages for other distros:

apt-get install coreutils build-essential cmake libmariadb-dev libconfig-dev syslog-ng-dev bats
apt-get install syslog-ng mariadb-client libconfig9 mariadb-server ruby pkg-config
COMPILE_ONLY=1 ./scripts/build-debug.sh
(sudo) make install
or
mkdir Debug
cd Debug
cmake ..
make
(sudo) make install

Set RELEASE variable to any value to build a release build.

License

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program. If not, see https://www.gnu.org/licenses.

Other Software Included

https://github.com/Snaipe/Criterion used as unit test framework (MIT)
https://stackoverflow.com/questions/779875/what-is-the-function-to-replace-string-in-c - for string replace function (CC4 BY)

Thanks

@xHire for answering and not answering my infinite number of questions about C
and other people answering my quesions

Thanks for the inspiration and help.

Debug

https://github.com/Snaipe/Criterion/issues/206

Save this as criterion.gdb and start gdb with gdb ./yourtest -x criterion.gdb.

Then, from the gdb prompt, just call run, list children with info inferiors, switch inferiors with inferior , and debug just as usual.