os-interface 0.2.1

Interface to retrieve OS information.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
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
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91

# OS-Interface

Crate holding easy to use functions for retrieving information from the
operating system.

PR contributions are welcome. Contributions could be in the form of
improvements to existing functionality, adding new functionality or adding
support for other operating systems.

## Goals

* This crate aims to give an easy-to-use interface for retrieving data from the
OS, e.g. network information.
* Expand with more functionality as long as it adheres to above point.
* Have as few dependencies as possible. For example, in the Unix environments,
this crate only depends on libc which in turn does not depend on anything else.
* Encapsulate unsafe code.
* Return data in a Rust-like manner.

## Usage

Example usage

```rust
use os_interface::network::network_interfaces;

fn main() {
    let network_interfaces = network_interfaces().unwrap();

    println!("Network interfaces: {:#?}", network_interfaces);
}
```

gives an output similar to the following
```bash
Network interfaces: [
    NetworkInterface {
        index: 1,
        name: "lo",
        addr: [
            IPv4(
                IfAddrV4 {
                    ip: 127.0.0.1,
                    netmask: Some(
                        255.0.0.0,
                    ),
                    broadcast: None,
                },
            ),
            IPv6(
                IfAddrV6 {
                    ip: ::1,
                    netmask: Some(
                        ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff,
                    ),
                },
            ),
        ],
        mac_addr: Some(
            "00:00:00:00:00:00",
        ),
        flags: Flags {
            up: true,
            loopback: true,
            running: true,
            multicast: false,
            broadcast: false,
        },
    },
    ...
]
```

## Supported functions per operating system

function | linux | macos | windows | freebsd | android | ios
--- | --- | --- | --- | --- | --- | ---
network_interfaces() | yes | yes | no | yes | yes | yes
local_ipv4_addresses() | yes | yes | no | yes | yes | yes
local_ipv6_addresses() | yes | yes | no | yes | yes | yes
hostname() | yes | yes | no | yes | yes | yes

<!---
## API documentation
API documentation can be found [here](https://docs.rs/os-interface/)
--->

## License

Distributed under the terms of both the MIT license and the Apache License
(Version 2.0)