A basic Erlang interface to the POSIX user database (e.g. getpwnam() and friends), via Rust bindings. Currently only two fuctions are exposed, the ones that are needed for the tanuki project.
- Erlang/OTP R17 or higher
- Rebar3 3.0.0 or higher
- Rust (1.11 or higher should work)
- Cargo
The following should build and test everything:
$ rebar3 ct
...
===> Running Common Test suites...
%%% epwd_rs_SUITE ==> test_getpwnam: OK
%%% epwd_rs_SUITE ==> test_getpwuid: OK
All 2 tests passed.
Include as a dependency in your release, using rebar3...
{deps, [
{epwd_rs, {git, "https://github.com/nlfiedler/epwd_rs", {tag, "0.2.0"}}}
]}.
Be sure to include epwd_rs in the included_applications list of your Erlang application configuration before building a release. For Elixir, simply list it as a dependency and add the runtime: false option to prevent starting it, as it does not have an application start function.
defp deps do
[
{:epwd_rs, github: "nlfiedler/epwd.rs", tag: "0.2.0", runtime: false}
]
end
Fetching the details of a user by their name...
Username = os:getenv("USER", "root"),
{ok, Results} = epwd_rs:getpwnam(Username),
Uid = proplists:lookup(pw_uid, Results),
io:format("User ~p ID: ~p~n", [Username, Uid]).