https://github.com/csnewman/libnss-rs

Rust bindings for creating libnss modules
https://github.com/csnewman/libnss-rs

Last synced: about 8 hours ago
JSON representation

Rust bindings for creating libnss modules

• Host: GitHub
• URL: https://github.com/csnewman/libnss-rs
• Owner: csnewman
• License: lgpl-3.0
• Created: 2019-06-09T11:16:49.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2024-05-18T15:09:12.000Z (7 months ago)
• Last Synced: 2024-12-17T15:31:14.370Z (8 days ago)
• Language: Rust
• Size: 90.8 KB
• Stars: 25
• Watchers: 3
• Forks: 14
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

        
# libnss-rs

Rust bindings for creating libnss modules.

Currently supports the following databases:

- passwd

- shadow

- group

- hosts

## Getting started

- Create a new library

  ```bash

  cargo new nss_example --lib

  ```

- Change library type to ```cdylib``` in your ```Cargo.toml```

  ```yaml

  [lib]

  name = "nss_example"

  crate-type = [ "cdylib" ]

  ```

  *** NOTE *** The name of the crate itself is not important, however the library itself must follow the ```nss_xxx``` pattern.

- Add ```libnss``` to your ```Cargo.toml```

  ```yaml

  [dependencies]

  libc = "0.2.0"

  libnss = "0.8.0"

  ```

- Implement a ```passwd``` database

  ```rust

  use libnss::passwd::{PasswdHooks, Passwd};

  use libnss::libnss_passwd_hooks;

  

  struct ExamplePasswd;

  libnss_passwd_hooks!(example, ExamplePasswd);

  ```

  It is important that the first param of ```libnss_passwd_hooks``` is the name of your final library ```libnss_example.so.2```

  ````rust

  impl PasswdHooks for HardcodedPasswd {

      fn get_all_entries() -> Vec {

          vec![

              Passwd {

                  name: "test".to_string(),

                  passwd: "x".to_string(),

                  uid: 1005,

                  gid: 1005,

                  gecos: "Test Account".to_string(),

                  dir: "/home/test".to_string(),

                  shell: "/bin/bash".to_string(),

              }

          ]

      }

  

      fn get_entry_by_uid(uid: libc::uid_t) -> Option {

          if uid == 1005 {

              return Some(Passwd {

                  name: "test".to_string(),

                  passwd: "x".to_string(),

                  uid: 1005,

                  gid: 1005,

                  gecos: "Test Account".to_string(),

                  dir: "/home/test".to_string(),

                  shell: "/bin/bash".to_string(),

              });

          }

  

          None

      }

  

      fn get_entry_by_name(name: String) -> Option {

          if name == "test" {

              return Some(Passwd {

                  name: "test".to_string(),

                  passwd: "x".to_string(),

                  uid: 1005,

                  gid: 1005,

                  gecos: "Test Account".to_string(),

                  dir: "/home/test".to_string(),

                  shell: "/bin/bash".to_string(),

              });

          }

  

          None

      }

  }

  ````

- Build

  ```

  cargo build --release

  ```

- Install the library

  ```bash

  cd target/release

  cp libnss_example.so libnss_example.so.2

  sudo install -m 0644 libnss_example.so.2 /lib

  sudo /sbin/ldconfig -n /lib /usr/lib

  ```

- Enable your nss module in ```/etc/nsswitch.conf```

  eg:

  ```

  passwd:         example files systemd

  ```

  The name in here must follow the final library name ```libnss_example.so.2```

- Look at the examples for more information