NAME

Linux::Sysfs::Device - sysfs devices

SYNOPSIS

my $device = Linux::Sysfs::Device->open($bus, $bus_id);

my $parent = $device->get_parent;
my @attrs  = $device->get_attrs;

$device->close;

DESCRIPTION

Devices represent everything in sysfs under /sys/devices, which is a hierarchical view of system devices.

METHODS

open

my $device = Linux::Sysfs::Device->open($bus, $bus_id);

Given the name of the $bus, this method locates a given device and returns a Linux::Sysfs::Device instance corresponding to the requested $bus_id.

open_path

my $device = Linux::Sysfs::Device->open_path($path);

Opens up a device at a specific $path. It opens the device's directory, reads the directory, and returns a Linux::Sysfs::Device instance on success or undef on failure.

close

$device->close;

Closes up the $device.

close_tree

$device->close_tree;

Closes every device under the supplied root $device.

get_parent

my $parent = $device->get_parent;

Returns the Linux::Sysfs::Device instance for the parent (if present) of the given $device.

get_bus

$device->get_bus or die 'get_bus failed';

Fills in the bus this $device is on. The Linux::Sysfs::Bus instance can be retrieved using the bus() method later on. Returns something true on success or something false on failure.

get_attr

get_attribute

my $attr = $device->get_attr($name);

Searches supplied $device's attributes by $name and returns the corresponding Linux::Sysfs::Attribute instance or undef.

get_attrs

get_attributes

my @attrs = $device->get_attrs;

Returns a list of Linux::Sysfs::Attribute instances for the $device.

name

my $name = $device->name;

Returns the name of the device.

path

my $path = $device->path;

Returns the full path of the device in sysfs.

bus_id

my $bus_id = $device->bus_id;

Returns the $device's bus id.

bus

my $bus = $device->bus;

Returns the Linux::Sysfs::Bus instance this $device is on. You'll need to call get_bus() first.

driver_name

my $driver_name = $device->driver_name;

Returns the name of the driver responsible for the device.

AUTHOR

Florian Ragwitz <rafl@debian.org>

COPYRIGHT & LICENSE

Copyright 2006 Florian Ragwitz, all rights reserved.

This library is free software; you can redistribute it and/or modify it under the terms of the GNU Library General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Library General Public License for more details.

You should have received a copy of the GNU Library General Public License along with this library; if not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307 USA.