https://github.com/dcuddeback/libudev-rs

Rust wrapper for libudev
https://github.com/dcuddeback/libudev-rs

Last synced: 5 days ago
JSON representation

Rust wrapper for libudev

• Host: GitHub
• URL: https://github.com/dcuddeback/libudev-rs
• Owner: dcuddeback
• License: mit
• Created: 2015-04-05T05:16:15.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2021-01-17T22:40:09.000Z (almost 4 years ago)
• Last Synced: 2024-04-24T15:13:41.833Z (7 months ago)
• Language: Rust
• Size: 1.31 MB
• Stars: 23
• Watchers: 7
• Forks: 16
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-systemd - libudev (Rust)
• awesome-systemd - libudev (Rust)

README

        
# Libudev

This crate provides a safe wrapper around the native `libudev` library.

* [Documentation](http://dcuddeback.github.io/libudev-rs/libudev/)

## Dependencies

In order to use the `libudev` crate, you must have a Linux system with the `libudev` library

installed where it can be found by `pkg-config`. To install `libudev` on Debian-based Linux

distributions, execute the following command:

```

sudo apt-get install libudev-dev

```

`libudev` is a Linux-specific package. It is not available for Windows, OS X, or other operating

systems.

### Cross-Compiling

The `libudev` crate can be used when cross-compiling to a foreign target. Details on how to

cross-compile `libudev` are explained in the [`libudev-sys` crate's

README](https://github.com/dcuddeback/libudev-sys#cross-compiling).

## Usage

Add `libudev` as a dependency in `Cargo.toml`:

```toml

[dependencies]

libudev = "0.3"

```

If you plan to support operating systems other than Linux, you'll need to add `libudev` as a

target-specific dependency:

```toml

[target.x86_64-unknown-linux-gnu.dependencies]

libudev = "0.3"

```

Import the `libudev` crate. The starting point for nearly all `libudev` functionality is to create a

context object.

```rust

extern crate libudev;

fn main() {

    let context = libudev::Context::new().unwrap();

    let mut enumerator = libudev::Enumerator::new(&context).unwrap();

    enumerator.match_subsystem("tty").unwrap();

    for device in enumerator.scan_devices().unwrap() {

        println!("found device: {:?}", device.syspath());

    }

}

```

## License

Copyright © 2015 David Cuddeback

Distributed under the [MIT License](LICENSE).