Module: OsCtld::Utils::Ip
- Defined in:
- lib/osctld/utils/ip.rb
Defined Under Namespace
Classes: LinkIdentityError, LinkNotFound
Instance Method Summary collapse
-
#delete_link_by_ifindex(ifindex, expected_name:, expected_kind:) ⇒ Object
Delete a recorded link only while the live object at
ifindexstill has its expected name and kernel link kind. - #ip(ip_v, args, **opts) ⇒ OsCtl::Lib::SystemCommandResult
-
#link_ifindex_by_name(expected_name:, expected_kind:) ⇒ Object
Resolve a live link by name and require the expected kernel kind before returning its positive ifindex.
- #tc(args, **opts) ⇒ OsCtl::Lib::SystemCommandResult
Instance Method Details
#delete_link_by_ifindex(ifindex, expected_name:, expected_kind:) ⇒ Object
Delete a recorded link only while the live object at ifindex still has
its expected name and kernel link kind. An index can be reused after the
original link disappears, so the index alone is not an identity proof.
RTM_DELLINK ignores IFLA_IFNAME whenever ifi_index is positive. Delete by
the daemon-reserved name instead, so the kernel resolves that name and
removes the selected object under one RTNL critical section. This keeps a
link which reuses ifindex between the lookup and deletion out of scope.
77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 |
# File 'lib/osctld/utils/ip.rb', line 77 def delete_link_by_ifindex(ifindex, expected_name:, expected_kind:) unless ifindex.is_a?(Integer) && ifindex > 0 raise ArgumentError, "invalid network interface index #{ifindex.inspect}" end unless expected_name.is_a?(String) && !expected_name.empty? raise ArgumentError, "invalid expected network interface name #{expected_name.inspect}" end unless expected_kind.is_a?(String) && !expected_kind.empty? raise ArgumentError, "invalid expected network interface kind #{expected_kind.inspect}" end Linux::Netlink::Route::Socket.open do |nl| begin link = nl.link[ifindex] rescue KeyError, Errno::ENODEV link = nil end unless link raise LinkIdentityError, "recorded network interface #{expected_name.inspect} " \ "(ifindex #{ifindex}, kind #{expected_kind.inspect}) is absent" end unless link.index == ifindex && link.ifname == expected_name && link.kind == expected_kind raise LinkIdentityError, "recorded network interface #{expected_name.inspect} " \ "(ifindex #{ifindex}, kind #{expected_kind.inspect}) is now " \ "#{link.ifname.inspect} (ifindex #{link.index}, kind #{link.kind.inspect})" end nl.cmd( Linux::RTM_DELLINK, Linux::Netlink::IFInfo.new( index: 0, ifname: expected_name ) ) end end |
#ip(ip_v, args, **opts) ⇒ OsCtl::Lib::SystemCommandResult
10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 |
# File 'lib/osctld/utils/ip.rb', line 10 def ip(ip_v, args, **opts) cmd = ['ip'] case ip_v when 4 cmd << '-4' when 6 cmd << '-6' when :all # nothing to do else raise "unknown IP version '#{ip_v}'" end cmd.concat(args.map(&:to_s)) syscmd_argv(cmd, opts) end |
#link_ifindex_by_name(expected_name:, expected_kind:) ⇒ Object
Resolve a live link by name and require the expected kernel kind before returning its positive ifindex.
36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 |
# File 'lib/osctld/utils/ip.rb', line 36 def link_ifindex_by_name(expected_name:, expected_kind:) unless expected_name.is_a?(String) && !expected_name.empty? raise ArgumentError, "invalid expected network interface name #{expected_name.inspect}" end unless expected_kind.is_a?(String) && !expected_kind.empty? raise ArgumentError, "invalid expected network interface kind #{expected_kind.inspect}" end Linux::Netlink::Route::Socket.open do |nl| begin link = nl.link[expected_name] rescue KeyError, Errno::ENODEV link = nil end unless link raise LinkNotFound, "network interface #{expected_name.inspect} " \ "(kind #{expected_kind.inspect}) is absent" end unless link.index.is_a?(Integer) && link.index > 0 && link.ifname == expected_name && link.kind == expected_kind raise LinkIdentityError, "network interface #{expected_name.inspect} " \ "(kind #{expected_kind.inspect}) is now #{link.ifname.inspect} " \ "(ifindex #{link.index.inspect}, kind #{link.kind.inspect})" end link.index end end |
#tc(args, **opts) ⇒ OsCtl::Lib::SystemCommandResult
29 30 31 32 |
# File 'lib/osctld/utils/ip.rb', line 29 def tc(args, **opts) cmd = ['tc'].concat(args.map(&:to_s)) syscmd_argv(cmd, opts) end |