From 73aea4ba722239627b7bcd9c70d0edb1d0a1198b Mon Sep 17 00:00:00 2001 From: Russtopia Date: Thu, 2 Feb 2023 19:01:13 -0800 Subject: [PATCH] Update 'README.md' --- README.md | 24 +++++++++++++++++++++--- 1 file changed, 21 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index cb956fc..ef45cad 100644 --- a/README.md +++ b/README.md @@ -3,15 +3,33 @@ goutmp - Minimal bindings to C stdlib pututmpx(), getutmpx() (/var/log/wtmp) and Any Go program which allows user shell access should update the standard UNIX files which track user sessions: /var/log/wtmp (for the 'w' and 'who' commands), and /var/log/lastlog (the 'last' and 'lastlog' commands). ``` -go doc +$ go doc -all package goutmp // import "blitter.com/go/goutmp" Golang bindings for basic login/utmp accounting -type UtmpEntry struct{ ... } +FUNCTIONS + +func GetHost(addr string) (h string) + return remote client hostname or IP if host lookup fails addr is expected to + be of the format given by net.Addr.String() eg., "127.0.0.1:80" or + "[::1]:80" func Put_lastlog_entry(app, usr, ptsname, host string) + Put the login app, username and originating host/IP to lastlog + func Unput_utmp(entry UtmpEntry) -func Put_utmp(user, ptsname, host string) UtmpEntry + Remove a username/host entry from utmp + + +TYPES + +type UtmpEntry struct { + // Has unexported fields. +} + UtmpEntry wraps the C struct utmp + +func Put_utmp(user, ptsName, host string) UtmpEntry + Put a username and the originating host/IP to utmp ```