linux-utmpx 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c97e1b42f1cdb52f5e36237a34b1fd9a45725577d40fa95c2dc2af60bac191c7
-  data.tar.gz: 5f4fa12738f051bb224b1122883df78ca18f5825f16913a677cc93d446682101
+  metadata.gz: d949aa7d9cedc8ed59720ded4a18a8ec41e2eaaa2c1dea79713dedc8110e1edf
+  data.tar.gz: bcc2c7417e713cc22878bf010002716ca04f27e5859e2c00dfae7a45bbcdd132
 SHA512:
-  metadata.gz: 11be5a0e6b534a53d2b9c2f32b2314c671f8fe9afb85977a5d009bcb4290fb3f65f86ef8390c1d9ce54e3ef4657705a638734ee1c1de8d1186149975ddaa3496
-  data.tar.gz: d0f6585ea4fd7a0a43a44b898c9d6b966f136a56605b67164e77e1f6b976cdbcac6cb5de296f2b1c65eb778d93d36063e8c14aac170de9ebc38d9e9bdd60bd71
+  metadata.gz: '08d56610c4f6c65c8b500ef0ee046cba28d145f59f0f8c1e2b7a327a4e0cee21bf56974cc0abebec2da7983c4d123155c9b9f1a55f66edb26bd5ba3d285a20d4'
+  data.tar.gz: 9659b5f10bd9f48b8ec59d61fe3026d9570caeae77397b97f0829e210f7b022bb9fe41c02c130b3677d6875908a2499d23a4eeca23fea90462d34e08fa2171a8

data/.github/workflows/main.yml

@@ -20,4 +20,4 @@ jobs:
       run: |
         gem install bundler
         bundle install
-        TESTOPTS="--verbose" bundle exec rake
+        TZ=Asia/Tokyo TESTOPTS="--verbose" bundle exec rake

data/README.md

@@ -30,7 +30,31 @@ while !io.eof? do
 end
 ```
 
-
+## Supported fields
+
+`Linux::Utmpx::UtmpxParser` supports to read the following fields.
+
+| parameter | type            | description                 |
+|-----------|-----------------|-----------------------------|
+| ut_type   | integer         | Type of login               |
+| ut_pid    | integer         | Process ID of login process |
+| ut_line   | string          | Device name                 |
+| ut_id     | string          | Inittab ID                  |
+| ut_user   | string          | Username                    |
+| ut_host   | string          | Hostname for remote login   |
+| ut_tv     | BinData::Record | Time entry                  |
+
+For making access easy, these accessor methods are provided.
+
+| parameter | type    | description                                                                                                                                                                   |
+|-----------|---------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| type      | integer | Type of login. It returns `:EMPTY`, `:RUN_LVL`, `:BOOT_TIME`, `:NEW_TIME`, `:OLD_TIME`, `:INIT_PROCESS`, `:LOGIN_PROCESS`, `:USER_PROCESS`, `:DEAD_PROCESS` or `:ACCOUNTING`. |
+| pid       | integer | Process ID of login process                                                                                                                                                   |
+| line      | string  | Device name                                                                                                                                                                   |
+| id        | string  | Inittab ID                                                                                                                                                                    |
+| user      | string  | Username                                                                                                                                                                      |
+| host      | string  | Hostname for remote login                                                                                                                                                     |
+| time      | Time    | Time entry.it returns the value of `Time`.                                                                                                                                    |
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test-unit` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.

data/examples/utmpx.rb

@@ -0,0 +1,49 @@
+require "linux/utmpx"
+require "optparse"
+
+options = {}
+parser = OptionParser.new
+parser.on("-u", "--utmp", "Dump /var/run/utmp") do |v|
+  options[:utmp] = v
+end
+parser.on("-w", "--wtmp", "Dump /var/log/wtmp") do |v|
+  options[:wtmp] = v
+end
+parser.on("-d", "--delayed", "Dump with delayed IO") do |v|
+  options[:delayed] = v
+end
+parser.parse!(ARGV)
+
+path = "/var/run/utmp"
+if options[:utmp]
+  path = "/var/run/utmp"
+end
+if options[:wtmp]
+  path = "/var/log/wtmp"
+end
+
+unless options[:utmp] or options[:wtmp]
+  puts parser.help
+  exit 1
+end
+
+File.open(path, "rb") do |io|
+  utmpx = Linux::Utmpx::UtmpxParser.new
+  printf("%25s %14s %7s %10s %20s %10s %10s\n", "TIME", "TYPE", "PID", "USER", "HOST", "ID", "LINE")
+  if options[:delayed]
+    obj = BinData::DelayedIO.new(type: Linux::Utmpx::UtmpxParser, read_abs_offset: 0)
+    while !io.eof?
+      obj.read(io.read(384)) do
+        obj.read_now!
+        printf("%25s %14s %7d %10s %20s %10s %10s\n",
+               obj.time, obj.type, obj.pid, obj.user, obj.host, obj.id, obj.line)
+      end
+    end
+  else
+    while !io.eof?
+      entry = utmpx.read(io)
+      printf("%25s %14s %7d %10s %20s %10s %10s\n",
+             entry.time, entry.type, entry.pid, entry.user, entry.host, entry.id, entry.line)
+    end
+  end
+end

data/lib/linux/utmpx/parser.rb

@@ -33,12 +33,12 @@ module Linux
       int32 :ut_session
       uttv  :ut_tv
       array :ut_addr_v6, :initial_length => 4 do
-        int32
+        int32be
       end
       string :reserved, :length => 20
 
       def time
-        Time.at(ut_tv.tv_sec, ut_tv.tv_usec)
+        Time.at(ut_tv.tv_sec, ut_tv.tv_usec).iso8601
       end
 
       def type

data/lib/linux/utmpx/version.rb

@@ -2,6 +2,6 @@
 
 module Linux
   module Utmpx
-    VERSION = "0.1.0"
+    VERSION = "0.2.0"
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: linux-utmpx
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Kentaro Hayashi
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2021-03-24 00:00:00.000000000 Z
+date: 2021-03-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bindata
@@ -53,6 +53,7 @@ files:
 - Rakefile
 - bin/console
 - bin/setup
+- examples/utmpx.rb
 - lib/linux/utmpx.rb
 - lib/linux/utmpx/parser.rb
 - lib/linux/utmpx/type.rb