rswap 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: c78cb324adbac507c04b943c46b09237530558ed55cda541c634ee87270e68ed
+  data.tar.gz: d3f9fe2c1c2e8ffe2ec1c23956ca4ef4b56a23883299f6ae3c38927d48f259b9
+SHA512:
+  metadata.gz: 2e59db26877c8d3a54e802dbea279e21335fd154c49aadf539dca130a6171a4483da2fe0b5e19b78f95101785cff8ef64b502d2f88a7ab2800ad71a0cb504062
+  data.tar.gz: b84789bbd7c4c62fa9d25272a447f900f50787daf699345742e585cdcb39a425ea64c1525152bf0387f6697c52a0bfec4e1ca45e884343347e426a26d9468606

data/bin/rswap

@@ -0,0 +1,8 @@
+#!/usr/bin/env ruby
+# bin/rswap - Entry point
+
+$LOAD_PATH.unshift(File.expand_path('../lib', __dir__))
+
+require 'rswap'
+
+Rswap.run(ARGV)

data/ext/rswap/Makefile

@@ -0,0 +1,273 @@
+
+SHELL = /bin/sh
+
+# V=0 quiet, V=1 verbose.  other values don't work.
+V = 0
+V0 = $(V:0=)
+Q1 = $(V:1=)
+Q = $(Q1:0=@)
+ECHO1 = $(V:1=@ :)
+ECHO = $(ECHO1:0=@ echo)
+NULLCMD = :
+
+#### Start of system configuration section. ####
+
+srcdir = .
+topdir = /usr/include/ruby-3.4.0
+hdrdir = $(topdir)
+arch_hdrdir = /usr/include/ruby-3.4.0/x86_64-linux
+PATH_SEPARATOR = :
+VPATH = $(srcdir):$(arch_hdrdir)/ruby:$(hdrdir)/ruby
+prefix = $(DESTDIR)/usr
+rubysitearchprefix = $(rubylibprefix)/$(sitearch)
+rubyarchprefix = $(rubylibprefix)/$(arch)
+rubylibprefix = $(libdir)/$(RUBY_BASE_NAME)
+exec_prefix = $(prefix)
+vendorarchhdrdir = $(vendorhdrdir)/$(sitearch)
+sitearchhdrdir = $(sitehdrdir)/$(sitearch)
+rubyarchhdrdir = $(rubyhdrdir)/$(arch)
+vendorhdrdir = $(rubyhdrdir)/vendor_ruby
+sitehdrdir = $(rubyhdrdir)/site_ruby
+rubyhdrdir = $(includedir)/$(RUBY_VERSION_NAME)
+vendorarchdir = $(vendorlibdir)/$(sitearch)
+vendorlibdir = $(vendordir)/$(ruby_version)
+vendordir = $(rubylibprefix)/vendor_ruby
+sitearchdir = $(sitelibdir)/$(sitearch)
+sitelibdir = $(sitedir)/$(ruby_version)
+sitedir = $(rubylibprefix)/site_ruby
+rubyarchdir = $(rubylibdir)/$(arch)
+rubylibdir = $(rubylibprefix)/$(ruby_version)
+sitearchincludedir = $(includedir)/$(sitearch)
+archincludedir = $(includedir)/$(arch)
+sitearchlibdir = $(libdir)/$(sitearch)
+archlibdir = $(libdir)/$(arch)
+ridir = $(datarootdir)/$(RI_BASE_NAME)
+modular_gc_dir = $(DESTDIR)
+mandir = $(DESTDIR)/usr/share/man
+localedir = $(datarootdir)/locale
+libdir = $(exec_prefix)/lib64
+psdir = $(docdir)
+pdfdir = $(docdir)
+dvidir = $(docdir)
+htmldir = $(docdir)
+infodir = $(DESTDIR)/usr/share/info
+docdir = $(datarootdir)/doc/$(PACKAGE)
+oldincludedir = $(DESTDIR)/usr/include
+includedir = $(prefix)/include
+runstatedir = $(localstatedir)/run
+localstatedir = $(DESTDIR)/var
+sharedstatedir = $(prefix)/com
+sysconfdir = $(DESTDIR)/etc
+datadir = $(datarootdir)
+datarootdir = $(prefix)/share
+libexecdir = $(exec_prefix)/libexec
+sbindir = $(DESTDIR)/usr/bin
+bindir = $(exec_prefix)/bin
+archdir = $(rubyarchdir)
+
+
+CC_WRAPPER = 
+CC = cc
+CXX = g++
+LIBRUBY = $(LIBRUBY_SO)
+LIBRUBY_A = lib$(RUBY_SO_NAME)-static.a
+LIBRUBYARG_SHARED = -l$(RUBY_SO_NAME)
+LIBRUBYARG_STATIC = -l$(RUBY_SO_NAME)-static $(MAINLIBS)
+empty =
+OUTFLAG = -o $(empty)
+COUTFLAG = -o $(empty)
+CSRCFLAG = $(empty)
+
+RUBY_EXTCONF_H = 
+cflags   = $(hardenflags)  $(optflags) $(debugflags) $(warnflags)
+cxxflags = 
+optflags = -O3 -fno-fast-math
+debugflags = -ggdb3
+warnflags = -Wall -Wextra -Wdeprecated-declarations -Wdiv-by-zero -Wduplicated-cond -Wimplicit-function-declaration -Wimplicit-int -Wpointer-arith -Wwrite-strings -Wold-style-definition -Wimplicit-fallthrough=0 -Wmissing-noreturn -Wno-cast-function-type -Wno-constant-logical-operand -Wno-long-long -Wno-missing-field-initializers -Wno-overlength-strings -Wno-packed-bitfield-compat -Wno-parentheses-equality -Wno-self-assign -Wno-tautological-compare -Wno-unused-parameter -Wno-unused-value -Wsuggest-attribute=format -Wsuggest-attribute=noreturn -Wunused-variable -Wmisleading-indentation -Wundef
+cppflags = 
+CCDLFLAGS = -fPIC
+CFLAGS   = $(CCDLFLAGS) -fstack-clash-protection -D_FORTIFY_SOURCE=2 -mtune=generic -O2 -pipe   -g -ffile-prefix-map=/builddir/ruby-3.4.10=. -fPIC $(ARCH_FLAG)
+INCFLAGS = -I. -I$(arch_hdrdir) -I$(hdrdir)/ruby/backward -I$(hdrdir) -I$(srcdir)
+DEFS     = 
+CPPFLAGS =      $(DEFS) $(cppflags)
+CXXFLAGS = $(CCDLFLAGS) -fstack-clash-protection -D_FORTIFY_SOURCE=2 -mtune=generic -O2 -pipe   -g -ffile-prefix-map=/builddir/ruby-3.4.10=. -std=c++23 -fPIC $(ARCH_FLAG)
+ldflags  = -L. -Wl,-z,relro -Wl,-z,now -Wl,--as-needed     -fstack-protector-strong -rdynamic -Wl,-export-dynamic -Wl,--no-as-needed -shared
+dldflags = -Wl,-z,relro -Wl,-z,now -Wl,--as-needed     -Wl,--compress-debug-sections=zlib 
+ARCH_FLAG = 
+DLDFLAGS = $(ldflags) $(dldflags) $(ARCH_FLAG)
+LDSHARED = $(CC) -shared
+LDSHAREDXX = $(CXX) -shared
+POSTLINK = :
+AR = ar
+LD = ld
+EXEEXT = 
+
+RUBY_INSTALL_NAME = $(RUBY_BASE_NAME)
+RUBY_SO_NAME = ruby
+RUBYW_INSTALL_NAME = 
+RUBY_VERSION_NAME = $(RUBY_BASE_NAME)-$(ruby_version)
+RUBYW_BASE_NAME = rubyw
+RUBY_BASE_NAME = ruby
+
+arch = x86_64-linux
+sitearch = $(arch)
+ruby_version = 3.4.0
+ruby = $(bindir)/$(RUBY_BASE_NAME)
+RUBY = $(ruby)
+BUILTRUBY = $(bindir)/$(RUBY_BASE_NAME)
+ruby_headers = $(hdrdir)/ruby.h $(hdrdir)/ruby/backward.h $(hdrdir)/ruby/ruby.h $(hdrdir)/ruby/defines.h $(hdrdir)/ruby/missing.h $(hdrdir)/ruby/intern.h $(hdrdir)/ruby/st.h $(hdrdir)/ruby/subst.h $(arch_hdrdir)/ruby/config.h
+
+RM = rm -f
+RM_RF = rm -fr
+RMDIRS = rmdir --ignore-fail-on-non-empty -p
+MAKEDIRS = /usr/bin/mkdir -p
+INSTALL = /usr/bin/install -c
+INSTALL_PROG = $(INSTALL) -m 0755
+INSTALL_DATA = $(INSTALL) -m 644
+COPY = cp
+TOUCH = exit >
+
+#### End of system configuration section. ####
+
+preload = 
+libpath = . $(libdir)
+LIBPATH = -L. -L$(libdir)
+DEFFILE = 
+
+CLEANFILES = mkmf.log
+DISTCLEANFILES = 
+DISTCLEANDIRS = 
+
+extout = 
+extout_prefix = 
+target_prefix = 
+LOCAL_LIBS = 
+LIBS = $(LIBRUBYARG_SHARED)  -lm -lpthread  -lc
+ORIG_SRCS = native.cpp
+SRCS = $(ORIG_SRCS) 
+OBJS = native.o
+HDRS = 
+LOCAL_HDRS = 
+TARGET = rswap_native
+TARGET_NAME = rswap_native
+TARGET_ENTRY = Init_$(TARGET_NAME)
+DLLIB = $(TARGET).so
+EXTSTATIC = 
+STATIC_LIB = 
+
+TIMESTAMP_DIR = .
+BINDIR        = $(bindir)
+RUBYCOMMONDIR = $(sitedir)$(target_prefix)
+RUBYLIBDIR    = $(sitelibdir)$(target_prefix)
+RUBYARCHDIR   = $(sitearchdir)$(target_prefix)
+HDRDIR        = $(sitehdrdir)$(target_prefix)
+ARCHHDRDIR    = $(sitearchhdrdir)$(target_prefix)
+TARGET_SO_DIR =
+TARGET_SO     = $(TARGET_SO_DIR)$(DLLIB)
+CLEANLIBS     = $(TARGET_SO) false
+CLEANOBJS     = $(OBJS) *.bak
+TARGET_SO_DIR_TIMESTAMP = $(TIMESTAMP_DIR)/.sitearchdir.time
+
+all:    $(DLLIB)
+static: $(STATIC_LIB)
+.PHONY: all install static install-so install-rb
+.PHONY: clean clean-so clean-static clean-rb
+
+clean-static::
+clean-rb-default::
+clean-rb::
+clean-so::
+clean: clean-so clean-static clean-rb-default clean-rb
+		-$(Q)$(RM_RF) $(CLEANLIBS) $(CLEANOBJS) $(CLEANFILES) .*.time
+
+distclean-rb-default::
+distclean-rb::
+distclean-so::
+distclean-static::
+distclean: clean distclean-so distclean-static distclean-rb-default distclean-rb
+		-$(Q)$(RM) Makefile $(RUBY_EXTCONF_H) conftest.* mkmf.log
+		-$(Q)$(RM) core ruby$(EXEEXT) *~ $(DISTCLEANFILES)
+		-$(Q)$(RMDIRS) $(DISTCLEANDIRS) 2> /dev/null || true
+
+realclean: distclean
+install: install-so install-rb
+
+install-so: $(DLLIB) $(TARGET_SO_DIR_TIMESTAMP)
+	$(INSTALL_PROG) $(DLLIB) $(RUBYARCHDIR)
+clean-static::
+	-$(Q)$(RM) $(STATIC_LIB)
+install-rb: pre-install-rb do-install-rb install-rb-default
+install-rb-default: pre-install-rb-default do-install-rb-default
+pre-install-rb: Makefile
+pre-install-rb-default: Makefile
+do-install-rb:
+do-install-rb-default:
+pre-install-rb-default:
+	@$(NULLCMD)
+$(TARGET_SO_DIR_TIMESTAMP):
+	$(Q) $(MAKEDIRS) $(@D) $(RUBYARCHDIR)
+	$(Q) $(TOUCH) $@
+
+site-install: site-install-so site-install-rb
+site-install-so: install-so
+site-install-rb: install-rb
+
+.SUFFIXES: .c .m .cc .mm .cxx .cpp .o .S
+
+.cc.o:
+	$(ECHO) compiling $(<)
+	$(Q) $(CXX) $(INCFLAGS) $(CPPFLAGS) $(CXXFLAGS) $(COUTFLAG)$@ -c $(CSRCFLAG)$<
+
+.cc.S:
+	$(ECHO) translating $(<)
+	$(Q) $(CXX) $(INCFLAGS) $(CPPFLAGS) $(CXXFLAGS) $(COUTFLAG)$@ -S $(CSRCFLAG)$<
+
+.mm.o:
+	$(ECHO) compiling $(<)
+	$(Q) $(CXX) $(INCFLAGS) $(CPPFLAGS) $(CXXFLAGS) $(COUTFLAG)$@ -c $(CSRCFLAG)$<
+
+.mm.S:
+	$(ECHO) translating $(<)
+	$(Q) $(CXX) $(INCFLAGS) $(CPPFLAGS) $(CXXFLAGS) $(COUTFLAG)$@ -S $(CSRCFLAG)$<
+
+.cxx.o:
+	$(ECHO) compiling $(<)
+	$(Q) $(CXX) $(INCFLAGS) $(CPPFLAGS) $(CXXFLAGS) $(COUTFLAG)$@ -c $(CSRCFLAG)$<
+
+.cxx.S:
+	$(ECHO) translating $(<)
+	$(Q) $(CXX) $(INCFLAGS) $(CPPFLAGS) $(CXXFLAGS) $(COUTFLAG)$@ -S $(CSRCFLAG)$<
+
+.cpp.o:
+	$(ECHO) compiling $(<)
+	$(Q) $(CXX) $(INCFLAGS) $(CPPFLAGS) $(CXXFLAGS) $(COUTFLAG)$@ -c $(CSRCFLAG)$<
+
+.cpp.S:
+	$(ECHO) translating $(<)
+	$(Q) $(CXX) $(INCFLAGS) $(CPPFLAGS) $(CXXFLAGS) $(COUTFLAG)$@ -S $(CSRCFLAG)$<
+
+.c.o:
+	$(ECHO) compiling $(<)
+	$(Q) $(CC) $(INCFLAGS) $(CPPFLAGS) $(CFLAGS) $(COUTFLAG)$@ -c $(CSRCFLAG)$<
+
+.c.S:
+	$(ECHO) translating $(<)
+	$(Q) $(CC) $(INCFLAGS) $(CPPFLAGS) $(CFLAGS) $(COUTFLAG)$@ -S $(CSRCFLAG)$<
+
+.m.o:
+	$(ECHO) compiling $(<)
+	$(Q) $(CC) $(INCFLAGS) $(CPPFLAGS) $(CFLAGS) $(COUTFLAG)$@ -c $(CSRCFLAG)$<
+
+.m.S:
+	$(ECHO) translating $(<)
+	$(Q) $(CC) $(INCFLAGS) $(CPPFLAGS) $(CFLAGS) $(COUTFLAG)$@ -S $(CSRCFLAG)$<
+
+$(TARGET_SO): $(OBJS) Makefile
+	$(ECHO) linking shared-object $(DLLIB)
+	-$(Q)$(RM) $(@)
+	$(Q) $(LDSHAREDXX) -o $@ $(OBJS) $(LIBPATH) $(DLDFLAGS) $(LOCAL_LIBS) $(LIBS)
+	$(Q) $(POSTLINK)
+
+
+
+$(OBJS): $(HDRS) $(ruby_headers)

data/ext/rswap/extconf.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+# ext/rswap/extconf.rb
+require 'mkmf'
+
+if try_compile('int main(){ return 0; }', '-std=c++23')
+  $CXXFLAGS << ' -std=c++23'
+else
+  abort 'C++23 compiler required'
+end
+
+# Position independent code for shared library
+$CXXFLAGS << ' -fPIC'
+$LDFLAGS << ' -shared'
+
+create_makefile('rswap_native')

data/ext/rswap/mkmf.log

@@ -0,0 +1,20 @@
+LD_LIBRARY_PATH=.:/usr/lib64 ASAN_OPTIONS=detect_leaks=0 "cc -o conftest -I/usr/include/ruby-3.4.0/x86_64-linux -I/usr/include/ruby-3.4.0/ruby/backward -I/usr/include/ruby-3.4.0 -I.       -fstack-clash-protection -D_FORTIFY_SOURCE=2 -mtune=generic -O2 -pipe   -g -ffile-prefix-map=/builddir/ruby-3.4.10=. -fPIC conftest.c -L. -L/usr/lib64 -L. -Wl,-z,relro -Wl,-z,now -Wl,--as-needed     -fstack-protector-strong -rdynamic -Wl,-export-dynamic -Wl,--no-as-needed     -lruby  -lm -lpthread  -lc"
+checked program was:
+/* begin */
+1: #include "ruby.h"
+2: 
+3: int main(int argc, char **argv)
+4: {
+5:   return !!argv[argc];
+6: }
+/* end */
+
+LD_LIBRARY_PATH=.:/usr/lib64 ASAN_OPTIONS=detect_leaks=0 "cc -I/usr/include/ruby-3.4.0/x86_64-linux -I/usr/include/ruby-3.4.0/ruby/backward -I/usr/include/ruby-3.4.0 -I.       -fstack-clash-protection -D_FORTIFY_SOURCE=2 -mtune=generic -O2 -pipe   -g -ffile-prefix-map=/builddir/ruby-3.4.10=. -fPIC  -std=c++23 -c conftest.c"
+cc1: warning: command-line option '-std=c++23' is valid for C++/ObjC++ but not for C
+checked program was:
+/* begin */
+1: #include "ruby.h"
+2: 
+3: int main(){ return 0; }
+/* end */
+

data/ext/rswap/native.cpp

@@ -0,0 +1,134 @@
+// ext/rswap/native.cpp
+// C++ Backend - 8 exported functions
+#include <cstdlib>
+#include <cstring>
+#include <filesystem>
+#include <fstream>
+#include <memory>
+#include <sstream>
+
+namespace fs = std::filesystem;
+
+constexpr ssize_t SIZE = 1024 * 1024;
+
+struct Ctrl {
+    std::string path;
+    explicit Ctrl(const char* p) : path(p ? p : "") {}
+};
+
+struct SwapInfo {
+    bool active = false;
+    long long used = 0;
+};
+
+// Helper: Parse /proc/swaps for swap status and memory usage
+SwapInfo get_swap_info(const std::string& path) {
+    SwapInfo info;
+    std::ifstream p("/proc/swaps");
+    if (!p.is_open()) return info;
+
+    std::string line;
+    while (std::getline(p, line)) {
+        if (line.find(path) != std::string::npos) {
+            std::istringstream s(line);
+            std::string f, t;
+            ssize_t sz, used;
+            int pri;
+            if (s >> f >> t >> sz >> used >> pri) {
+                info.active = true;
+                info.used = static_cast<long long>(used) * 1024;
+            }
+            break;
+        }
+    }
+    return info;
+}
+
+// Helper: System command execution
+int exec_cmd(const std::string& cmd) {
+    return std::system(cmd.c_str()) == 0 ? 0 : 2;
+}
+
+extern "C" {
+
+Ctrl* swap_new(const char* path) {
+    if (!path) return nullptr;
+    try {
+        auto ctrl = std::make_unique<Ctrl>(path);
+        return ctrl.release();
+    } catch (...) {
+        return nullptr;
+    }
+}
+
+void swap_free(const Ctrl* c) {
+    delete c;
+}
+
+int swap_create(Ctrl* c, ssize_t bytes) {
+    if (!c || c->path.empty()) return 1;
+    if (fs::exists(c->path)) return 5;
+
+    std::string bytes_str = std::to_string(bytes);
+    std::string mb_str = std::to_string(bytes / SIZE);
+
+    // 1. Create empty file (touch)
+    // 2. Set NOCOW (+C) for Btrfs filesystems before writing data
+    // 3. Allocate file space via fallocate (fallback to dd)
+    // 4. Restrict permissions (chmod 600)
+    // 5. Format as swap space (mkswap)
+    std::string cmd =
+        "touch '" + c->path + "' && "
+        "chattr +C '" + c->path + "' 2>/dev/null; "
+        "(fallocate -l " + bytes_str + " '" + c->path + "' 2>/dev/null || "
+        "dd if=/dev/zero of='" + c->path + "' bs=1M count=" + mb_str + " status=none) && "
+        "chmod 600 '" + c->path + "' && "
+        "mkswap '" + c->path + "'";
+
+    return exec_cmd(cmd);
+}
+
+int swap_enable(Ctrl* c) {
+    if (!c || c->path.empty()) return 1;
+    return exec_cmd("swapon '" + c->path + "' 2>/dev/null");
+}
+
+int swap_disable(Ctrl* c) {
+    if (!c || c->path.empty()) return 1;
+
+    auto info = get_swap_info(c->path);
+    if (!info.active) return 4;
+
+    return exec_cmd("swapoff '" + c->path + "' 2>/dev/null");
+}
+
+int swap_remove(Ctrl* c) {
+    if (!c || c->path.empty()) return 1;
+    std::error_code ec;
+    return fs::remove(c->path, ec) ? 0 : 6;
+}
+
+char* swap_status(Ctrl* c) {
+    if (!c || c->path.empty()) return strdup("{}");
+
+    auto info = get_swap_info(c->path);
+    bool exists = fs::exists(c->path);
+    std::uintmax_t file_sz = exists ? fs::file_size(c->path) : 0;
+
+    std::ostringstream j;
+    j << "{"
+      << "\"p\":\"" << c->path << "\","
+      << "\"x\":" << (exists ? "true" : "false") << ","
+      << "\"s\":" << (exists ? static_cast<long long>(file_sz) : -1) << ","
+      << "\"a\":" << (info.active ? "true" : "false") << ","
+      << "\"u\":" << info.used
+      << "}";
+
+    return strdup(j.str().c_str());
+}
+
+void swap_free_str(char* s) {
+    free(s);
+}
+
+} // extern "C"

data/lib/rswap/cli.rb

@@ -0,0 +1,175 @@
+# frozen_string_literal: true
+
+require 'rainbow'
+require 'optparse'
+require_relative 'native'
+
+module Rswap
+  class CLI
+    HELP = <<~USAGE
+      Usage: rswap <command> [options]
+
+      Commands:
+        add [SIZE]   Create and enable swap (default: 8GB)
+        on          Enable existing swap
+        off         Disable existing swap
+        status      Show current state
+
+      Options:
+        --swapfile PATH  Path to swap file (default: /swapfile)
+    USAGE
+
+    ERR = {
+      0 => 'OK',
+      1 => 'internal error',
+      2 => 'command failed',
+      3 => 'cannot read /proc/swaps',
+      4 => 'already disabled',
+      5 => 'file exists',
+      6 => 'remove failed'
+    }.freeze
+
+    def self.run(argv)
+      sf = '/swapfile'
+
+      parser = OptionParser.new do |opts|
+        opts.on('--swapfile PATH') { |path| sf = path }
+      end
+
+      begin
+        parser.order!(argv)
+      rescue OptionParser::InvalidOption => e
+        puts Rainbow("ERR: #{e.message}").red
+        exit 1
+      end
+
+      cmd = argv.shift
+      if cmd.nil?
+        puts HELP
+        exit 1
+      end
+
+      c = Rswap::Native::Ctrl.new(sf)
+
+      case cmd
+      when 'add'    then add(c, argv[0] || '8GB')
+      when 'on'     then on(c)
+      when 'off'    then off(c)
+      when 'status' then status(c)
+      else
+        puts Rainbow("ERR: unknown '#{cmd}'").red
+        puts 'Valid: add, on, off, status'
+        exit 1
+      end
+    end
+
+    def self.add(c, sz)
+      bytes = parse(sz)
+      st = c.status
+      size_h = human(bytes)
+
+      case st
+      in { x: true, s: ^bytes }
+        puts Rainbow("OK: exists (#{size_h})").green
+        return
+      in { x: true, s: cur } if cur != bytes
+        puts Rainbow("WARN: size mismatch (#{human(cur)} vs #{size_h})").yellow
+        print 'Remove and recreate? [y/N]: '
+        return unless $stdin.gets.chomp.downcase == 'y'
+
+        # if active -> disable and remove
+        c.disable if st[:a]
+
+        if c.remove != 0
+          puts Rainbow('ERR: failed to remove existing swapfile').red
+          return
+        end
+      else
+        # Hey
+      end
+
+      case [c.create(bytes), c.enable]
+      in [0, 0]
+        puts Rainbow("OK: created + enabled (#{size_h})").green
+      in [0, e]
+        puts Rainbow("ERR: created but enable failed: #{ERR[e]}").red
+      in [cr, _]
+        puts Rainbow("ERR: create failed: #{ERR[cr]}").red
+      end
+    end
+
+    def self.on(c)
+      st = c.status
+
+      case st
+      in { x: false }
+        puts Rainbow('ERR: file not found').red
+      in { a: true }
+        puts Rainbow('OK: already active').green
+      else
+        case c.enable
+        in 0 then puts Rainbow('OK: enabled').green
+        in e then puts Rainbow("ERR: #{ERR[e]}").red
+        end
+      end
+    end
+
+    def self.off(c)
+      st = c.status
+
+      case st
+      in { x: false }
+        puts Rainbow('ERR: file not found').red
+      in { a: false }
+        puts Rainbow('OK: already off').green
+      in { a: true, u: usage } if usage && usage > 0
+        puts Rainbow("WARN: #{human(usage)} in use").yellow
+        case c.disable
+        in 0 then puts Rainbow('OK: off').green
+        in e then puts Rainbow("ERR: #{ERR[e]} (tty: sudo swapoff -a)").red
+        end
+      in { a: true }
+        case c.disable
+        in 0 then puts Rainbow('OK: off').green
+        in e then puts Rainbow("ERR: #{ERR[e]} (tty: sudo swapoff -a)").red
+        end
+      end
+    end
+
+    def self.status(c)
+      st = c.status
+
+      puts Rainbow('--- Swap ---').bright
+      puts "Path: #{st[:p]}"
+      puts "Exists: #{st[:x] ? 'yes' : 'no'}"
+      puts "Size: #{human(st[:s])}" if st[:s] && st[:s] > 0
+
+      case st[:a]
+      in true then puts "Active: #{Rainbow('yes').green}"
+      in false then puts "Active: #{Rainbow('no').red}"
+      else puts "Active: #{Rainbow('no').red}"
+      end
+
+      puts "Usage: #{human(st[:u])}" if st[:u] && st[:u] >= 0
+    end
+
+    def self.human(b)
+      case b
+      when nil, 0 then '0B'
+      when (1024**3..) then sprintf('%.2fGB', b.to_f / 1024**3)
+      when (1024**2..) then sprintf('%.2fMB', b.to_f / 1024**2)
+      when (1024..)    then sprintf('%.2fKB', b.to_f / 1024)
+      else "#{b}B"
+      end
+    end
+
+    def self.parse(s)
+      case s.to_s.upcase
+      when /^([\d.]+)GB?$/ then ($1.to_f * 1024**3).to_i
+      when /^([\d.]+)MB?$/ then ($1.to_f * 1024**2).to_i
+      when /^([\d.]+)KB?$/ then ($1.to_f * 1024).to_i
+      else s.to_i
+      end
+    end
+  end
+end

data/lib/rswap/native.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+require 'ffi'
+require 'json'
+
+module Rswap
+  module Native
+    extend FFI::Library
+
+    lib_dir = File.expand_path('../../ext/rswap', __dir__)
+    ffi_lib File.join(lib_dir, 'rswap_native.so')
+
+    attach_function :swap_new, [:string], :pointer
+    attach_function :swap_free, [:pointer], :void
+    attach_function :swap_create, [:pointer, :ssize_t], :int
+    attach_function :swap_enable, [:pointer], :int
+    attach_function :swap_disable, [:pointer], :int
+    attach_function :swap_remove, [:pointer], :int
+    attach_function :swap_status, [:pointer], :pointer
+    attach_function :swap_free_str, [:pointer], :void
+
+    class Ctrl
+      def initialize(path)
+        @p = Native.swap_new(path)
+        raise 'init failed' if @p.null?
+
+        ObjectSpace.define_finalizer(self, self.class.finalizer(@p))
+      end
+
+      def self.finalizer(p)
+        proc { Native.swap_free(p) }
+      end
+
+      def create(sz) = Native.swap_create(@p, sz)
+      def enable = Native.swap_enable(@p)
+      def disable = Native.swap_disable(@p)
+      def remove = Native.swap_remove(@p)
+
+      def status
+        ptr = Native.swap_status(@p)
+        return {} if ptr.null?
+
+        begin
+          json_str = ptr.read_string
+          JSON.parse(json_str, symbolize_names: true)
+        ensure
+          Native.swap_free_str(ptr)
+          # The C++ side frees up the memory that was accessed via strdup to prevent memory leaks.
+        end
+      end
+    end
+  end
+end

data/lib/rswap/version.rb

@@ -0,0 +1,4 @@
+# lib/rswap/version.rb
+module Rswap
+  VERSION = "1.0.0"
+end

data/lib/rswap.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+require_relative 'rswap/version'
+require_relative 'rswap/cli'
+
+module Rswap
+  # Entry Point
+  def self.run(args)
+    CLI.run(args)
+  end
+end

metadata

@@ -0,0 +1,95 @@
+--- !ruby/object:Gem::Specification
+name: rswap
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- KennedySilverDollar
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: ffi
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.17'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.17'
+- !ruby/object:Gem::Dependency
+  name: rainbow
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+description: Create/enable/disable rswap files with extreme efficiency
+email:
+- kenshinlights@tutamail.com
+executables:
+- rswap
+extensions:
+- ext/rswap/extconf.rb
+extra_rdoc_files: []
+files:
+- bin/rswap
+- ext/rswap/Makefile
+- ext/rswap/extconf.rb
+- ext/rswap/mkmf.log
+- ext/rswap/native.cpp
+- ext/rswap/native.o
+- ext/rswap/rswap_native.so
+- lib/rswap.rb
+- lib/rswap/cli.rb
+- lib/rswap/native.rb
+- lib/rswap/version.rb
+homepage: https://github.com/KennedySilverDollar/rswap-tool
+licenses:
+- MIT
+metadata: {}
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: Minimal rswap manager with C++23 backend
+test_files: []