File: README.md

package info (click to toggle)
golang-github-astromechza-etcpwdparse 0.0~git20170319.f0e5f07-3
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 76 kB
  • sloc: makefile: 2
file content (31 lines) | stat: -rw-r--r-- 959 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
# Golang library `etcpwdparse`

This library provides simple access to the entries in the `/etc/passwd` file.

It was made for programs that need to be able to pull home directories, user id's and the
like but do not want the cgo-dependence of the core `os/user` package.

The only real caveat is that it doesn't pull user entries from other sources like PAM or
LDAP since it only operates by reading the file on disk.

## Usage:

```
go get github.com/AstromechZA/etcpwdparse
```

```golang
// load the passwd entries
// err will be non-nill if there was an IO or parsing error while loading the file
cache, err := NewLoadedEtcPasswdCache()
if err != nil {
    panic(err)
}

// pull the home directory
// there will be an err if the user could not be found
homedir, err := cache.HomeDirForUsername("bob")
```

See the documentation at [godoc.org/github.com/AstromechZA/etcpwdparse](https://godoc.org/github.com/AstromechZA/etcpwdparse)
for more information.