xref: /aosp_15_r20/external/libnl/python/doc/route_addr.rst (revision 4dc78e53d49367fa8e61b07018507c90983a077d)
1*4dc78e53SAndroid Build Coastguard Worker=================
2*4dc78e53SAndroid Build Coastguard WorkerNetwork Addresses
3*4dc78e53SAndroid Build Coastguard Worker=================
4*4dc78e53SAndroid Build Coastguard Worker
5*4dc78e53SAndroid Build Coastguard WorkerThe **Address** module provides access to the network address configuration
6*4dc78e53SAndroid Build Coastguard Workerof the kernel. It provides an interface to fetch all configured addresses,
7*4dc78e53SAndroid Build Coastguard Workeradd new addresses and to delete existing addresses.
8*4dc78e53SAndroid Build Coastguard Worker
9*4dc78e53SAndroid Build Coastguard WorkerFetching the list of network addresses is achieved by creating a new
10*4dc78e53SAndroid Build Coastguard Workeraddress cache::
11*4dc78e53SAndroid Build Coastguard Worker
12*4dc78e53SAndroid Build Coastguard Worker	import netlink.route.address as Address
13*4dc78e53SAndroid Build Coastguard Worker
14*4dc78e53SAndroid Build Coastguard Worker        addr_cache = Address.AddressCache()
15*4dc78e53SAndroid Build Coastguard Worker        addr_cache.refill()
16*4dc78e53SAndroid Build Coastguard Worker
17*4dc78e53SAndroid Build Coastguard Worker        for addr in addr_cache:
18*4dc78e53SAndroid Build Coastguard Worker                print addr
19*4dc78e53SAndroid Build Coastguard Worker
20*4dc78e53SAndroid Build Coastguard Worker.. py:module:: netlink.route.addr
21*4dc78e53SAndroid Build Coastguard Worker
22*4dc78e53SAndroid Build Coastguard Worker
23*4dc78e53SAndroid Build Coastguard WorkerAddressCache
24*4dc78e53SAndroid Build Coastguard Worker------------
25*4dc78e53SAndroid Build Coastguard Worker
26*4dc78e53SAndroid Build Coastguard Worker.. py:class:: AddressCache
27*4dc78e53SAndroid Build Coastguard Worker
28*4dc78e53SAndroid Build Coastguard Worker   Represents a cache containing all or a subset of network addresses.
29*4dc78e53SAndroid Build Coastguard Worker
30*4dc78e53SAndroid Build Coastguard Worker   .. py:method:: lookup(ifindex, local)
31*4dc78e53SAndroid Build Coastguard Worker
32*4dc78e53SAndroid Build Coastguard Worker      Lookup the address which matches ifindex and local address
33*4dc78e53SAndroid Build Coastguard Worker
34*4dc78e53SAndroid Build Coastguard Worker      :raises: KeyError if address is not found.
35*4dc78e53SAndroid Build Coastguard Worker
36*4dc78e53SAndroid Build Coastguard WorkerAddress
37*4dc78e53SAndroid Build Coastguard Worker-------
38*4dc78e53SAndroid Build Coastguard Worker
39*4dc78e53SAndroid Build Coastguard Worker.. py:class:: Address
40*4dc78e53SAndroid Build Coastguard Worker
41*4dc78e53SAndroid Build Coastguard Worker   Representation of a configured network address.
42*4dc78e53SAndroid Build Coastguard Worker
43*4dc78e53SAndroid Build Coastguard Worker   .. py:attribute:: ifindex
44*4dc78e53SAndroid Build Coastguard Worker
45*4dc78e53SAndroid Build Coastguard Worker      Interface index
46*4dc78e53SAndroid Build Coastguard Worker
47*4dc78e53SAndroid Build Coastguard Worker      :rtype: int
48