# [−][src]Function nix::ifaddrs::getifaddrs

    pub fn getifaddrs() -> Result<InterfaceAddressIterator>

Get interface addresses using libc's `getifaddrs`

Note that the underlying implementation differs between OSes. Only the most common address families are supported by the nix crate (due to lack of time and complexity of testing). The address family is encoded in the specific variant of `SockAddr` returned for the fields `address`, `netmask`, `broadcast`, and `destination`. For any entry not supported, the returned list will contain a `None` entry.

# Example

    let addrs = nix::ifaddrs::getifaddrs().unwrap();
    for ifaddr in addrs {
      match ifaddr.address {
        Some(address) => {
          println!("interface {} address {}",
                   ifaddr.interface_name, address);
        },
        None => {
          println!("interface {} with unsupported address family",
                   ifaddr.interface_name);
        }
      }
    }

# Help

## Keyboard Shortcuts

`?`
  Show this help dialog
`S`
  Focus the search field
`↑`
  Move up in search results
`↓`
  Move down in search results
`↹`
  Switch tab
`⏎`
  Go to active search result
`+`
  Expand all sections
`-`
  Collapse all sections

## Search Tricks

Prefix searches with a type followed by a colon (e.g., `fn:`) to restrict the search to a given type.

Accepted types are: `fn`, `mod`, `struct`, `enum`, `trait`, `type`, `macro`, and `const`.

Search functions by type signature (e.g., `vec -> usize` or `* -> vec`)

Search multiple things at once by splitting your query with comma (e.g., `str,u8` or `String,struct:Vec,test`)