libsysfs/sysfs_dir.c

   1 /*
   2  * sysfs_dir.c
   3  *
   4  * Directory utility functions for libsysfs
   5  *
   6  * Copyright (C) IBM Corp. 2003
   7  *
   8  *  This library is free software; you can redistribute it and/or
   9  *  modify it under the terms of the GNU Lesser General Public
  10  *  License as published by the Free Software Foundation; either
  11  *  version 2.1 of the License, or (at your option) any later version.
  12  *
  13  *  This library is distributed in the hope that it will be useful,
  14  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
  15  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  16  *  Lesser General Public License for more details.
  17  *
  18  *  You should have received a copy of the GNU Lesser General Public
  19  *  License along with this library; if not, write to the Free Software
  20  *  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
  21  *
  22  */
  23 #include "sysfs/libsysfs.h"
  24 #include "sysfs.h"
  25
  26 /**
  27  * sysfs_del_attribute: routine for dlist integration
  28  */
  29 static void sysfs_del_attribute(void *attr)
  30 {
  31         sysfs_close_attribute((struct sysfs_attribute *)attr);
  32 }
  33
  34 /**
  35  * sysfs_del_link: routine for dlist integration
  36  */
  37 static void sysfs_del_link(void *ln)
  38 {
  39         sysfs_close_link((struct sysfs_link *)ln);
  40 }
  41
  42 /**
  43  * sysfs_del_dir: routine for dlist integration
  44  */
  45 static void sysfs_del_directory(void *dir)
  46 {
  47         sysfs_close_directory((struct sysfs_directory *)dir);
  48 }
  49
  50 /**
  51  * dir_attribute_name_equal: compares dir attributes by name
  52  * @a: attribute name for comparison
  53  * @b: sysfs_attribute to be compared.
  54  * returns 1 if a==b->name or 0 if not equal
  55  */
  56 static int dir_attribute_name_equal(void *a, void *b)
  57 {
  58         if (a == NULL || b == NULL)
  59                 return 0;
  60
  61         if (strcmp(((char *)a), ((struct sysfs_attribute *)b)->name) == 0)
  62                 return 1;
  63
  64         return 0;
  65 }
  66
  67 /**
  68  * dir_link_name_equal: compares dir links by name
  69  * @a: link name for comparison
  70  * @b: sysfs_link to be compared.
  71  * returns 1 if a==b->name or 0 if not equal
  72  */
  73 static int dir_link_name_equal(void *a, void *b)
  74 {
  75         if (a == NULL || b == NULL)
  76                 return 0;
  77
  78         if (strcmp(((char *)a), ((struct sysfs_link *)b)->name) == 0)
  79                 return 1;
  80
  81         return 0;
  82 }
  83
  84 /**
  85  * dir_subdir_name_equal: compares subdirs by name
  86  * @a: name of subdirectory to compare
  87  * @b: sysfs_directory subdirectory to be compared
  88  * returns 1 if a==b->name or 0 if not equal
  89  */
  90 static int dir_subdir_name_equal(void *a, void *b)
  91 {
  92         if (a == NULL || b == NULL)
  93                 return 0;
  94
  95         if (strcmp(((char *)a), ((struct sysfs_directory *)b)->name) == 0)
  96                 return 1;
  97
  98         return 0;
  99 }
 100
 101 /**
 102  * sysfs_close_attribute: closes and cleans up attribute
 103  * @sysattr: attribute to close.
 104  */
 105 void sysfs_close_attribute(struct sysfs_attribute *sysattr)
 106 {
 107         if (sysattr != NULL) {
 108                 if (sysattr->value != NULL)
 109                         free(sysattr->value);
 110                 free(sysattr);
 111         }
 112 }
 113
 114 /**
 115  * alloc_attribute: allocates and initializes attribute structure
 116  * returns struct sysfs_attribute with success and NULL with error.
 117  */
 118 static struct sysfs_attribute *alloc_attribute(void)
 119 {
 120         return (struct sysfs_attribute *)
 121                         calloc(1, sizeof(struct sysfs_attribute));
 122 }
 123
 124 /**
 125  * sysfs_open_attribute: creates sysfs_attribute structure
 126  * @path: path to attribute.
 127  * returns sysfs_attribute struct with success and NULL with error.
 128  */
 129 struct sysfs_attribute *sysfs_open_attribute(const char *path)
 130 {
 131         struct sysfs_attribute *sysattr = NULL;
 132         struct stat fileinfo;
 133
 134         if (path == NULL) {
 135                 errno = EINVAL;
 136                 return NULL;
 137         }
 138         sysattr = alloc_attribute();
 139         if (sysattr == NULL) {
 140                 dprintf("Error allocating attribute at %s\n", path);
 141                 return NULL;
 142         }
 143         if (sysfs_get_name_from_path(path, sysattr->name,
 144                                 SYSFS_NAME_LEN) != 0) {
 145                 dprintf("Error retrieving attrib name from path: %s\n", path);
 146                 sysfs_close_attribute(sysattr);
 147                 return NULL;
 148         }
 149         safestrcpy(sysattr->path, path);
 150         if ((stat(sysattr->path, &fileinfo)) != 0) {
 151                 dprintf("Stat failed: No such attribute?\n");
 152                 sysattr->method = 0;
 153                 free(sysattr);
 154                 sysattr = NULL;
 155         } else {
 156                 if (fileinfo.st_mode & S_IRUSR)
 157                         sysattr->method |= SYSFS_METHOD_SHOW;
 158                 if (fileinfo.st_mode & S_IWUSR)
 159                         sysattr->method |= SYSFS_METHOD_STORE;
 160         }
 161
 162         return sysattr;
 163 }
 164
 165 /**
 166  * sysfs_write_attribute: write value to the attribute
 167  * @sysattr: attribute to write
 168  * @new_value: value to write
 169  * @len: length of "new_value"
 170  * returns 0 with success and -1 with error.
 171  */
 172 int sysfs_write_attribute(struct sysfs_attribute *sysattr,
 173                 const char *new_value, size_t len)
 174 {
 175         int fd;
 176         int length;
 177
 178         if (sysattr == NULL || new_value == NULL || len == 0) {
 179                 errno = EINVAL;
 180                 return -1;
 181         }
 182
 183         if (!(sysattr->method & SYSFS_METHOD_STORE)) {
 184                 dprintf ("Store method not supported for attribute %s\n",
 185                         sysattr->path);
 186                 errno = EACCES;
 187                 return -1;
 188         }
 189         if (sysattr->method & SYSFS_METHOD_SHOW) {
 190                 /*
 191                  * read attribute again to see if we can get an updated value
 192                  */
 193                 if ((sysfs_read_attribute(sysattr)) != 0) {
 194                         dprintf("Error reading attribute\n");
 195                         return -1;
 196                 }
 197                 if ((strncmp(sysattr->value, new_value, sysattr->len)) == 0) {
 198                         dprintf("Attr %s already has the requested value %s\n",
 199                                         sysattr->name, new_value);
 200                         return 0;
 201                 }
 202         }
 203         /*
 204          * open O_WRONLY since some attributes have no "read" but only
 205          * "write" permission
 206          */
 207         if ((fd = open(sysattr->path, O_WRONLY)) < 0) {
 208                 dprintf("Error reading attribute %s\n", sysattr->path);
 209                 return -1;
 210         }
 211
 212         length = write(fd, new_value, len);
 213         if (length < 0) {
 214                 dprintf("Error writing to the attribute %s - invalid value?\n",
 215                         sysattr->name);
 216                 close(fd);
 217                 return -1;
 218         } else if ((unsigned int)length != len) {
 219                 dprintf("Could not write %d bytes to attribute %s\n",
 220                                         len, sysattr->name);
 221                 /*
 222                  * since we could not write user supplied number of bytes,
 223                  * restore the old value if one available
 224                  */
 225                 if (sysattr->method & SYSFS_METHOD_SHOW) {
 226                         length = write(fd, sysattr->value, sysattr->len);
 227                         close(fd);
 228                         return -1;
 229                 }
 230         }
 231
 232         /*
 233          * Validate length that has been copied. Alloc appropriate area
 234          * in sysfs_attribute. Verify first if the attribute supports reading
 235          * (show method). If it does not, do not bother
 236          */
 237         if (sysattr->method & SYSFS_METHOD_SHOW) {
 238                 if (length != sysattr->len) {
 239                         sysattr->value = (char *)realloc
 240                                 (sysattr->value, length);
 241                         sysattr->len = length;
 242                         safestrcpymax(sysattr->value, new_value, length);
 243                 } else {
 244                         /*"length" of the new value is same as old one */
 245                         safestrcpymax(sysattr->value, new_value, length);
 246                 }
 247         }
 248
 249         close(fd);
 250         return 0;
 251 }
 252
 253 /**
 254  * sysfs_read_attribute: reads value from attribute
 255  * @sysattr: attribute to read
 256  * returns 0 with success and -1 with error.
 257  */
 258 int sysfs_read_attribute(struct sysfs_attribute *sysattr)
 259 {
 260         char *fbuf = NULL;
 261         char *vbuf = NULL;
 262         ssize_t length = 0;
 263         long pgsize = 0;
 264         int fd;
 265
 266         if (sysattr == NULL) {
 267                 errno = EINVAL;
 268                 return -1;
 269         }
 270         if (!(sysattr->method & SYSFS_METHOD_SHOW)) {
 271                 dprintf("Show method not supported for attribute %s\n",
 272                         sysattr->path);
 273                 errno = EACCES;
 274                 return -1;
 275         }
 276         pgsize = getpagesize();
 277         fbuf = (char *)calloc(1, pgsize+1);
 278         if (fbuf == NULL) {
 279                 dprintf("calloc failed\n");
 280                 return -1;
 281         }
 282         if ((fd = open(sysattr->path, O_RDONLY)) < 0) {
 283                 dprintf("Error reading attribute %s\n", sysattr->path);
 284                 free(fbuf);
 285                 return -1;
 286         }
 287         length = read(fd, fbuf, pgsize);
 288         if (length < 0) {
 289                 dprintf("Error reading from attribute %s\n", sysattr->path);
 290                 close(fd);
 291                 free(fbuf);
 292                 return -1;
 293         }
 294         if (sysattr->len > 0) {
 295                 if ((sysattr->len == length) &&
 296                                 (!(strncmp(sysattr->value, fbuf, length)))) {
 297                         close(fd);
 298                         free(fbuf);
 299                         return 0;
 300                 }
 301                 free(sysattr->value);
 302         }
 303         sysattr->len = length;
 304         close(fd);
 305         vbuf = (char *)realloc(fbuf, length+1);
 306         if (vbuf == NULL) {
 307                 dprintf("realloc failed\n");
 308                 free(fbuf);
 309                 return -1;
 310         }
 311         sysattr->value = vbuf;
 312
 313         return 0;
 314 }
 315
 316 /**
 317  * sysfs_read_attribute_value: given path to attribute, return its value.
 318  *      values can be up to a pagesize, if buffer is smaller the value will
 319  *      be truncated.
 320  * @attrpath: sysfs path to attribute
 321  * @value: buffer to put value
 322  * @vsize: size of value buffer
 323  * returns 0 with success and -1 with error.
 324  */
 325 int sysfs_read_attribute_value(const char *attrpath,
 326                                         char *value, size_t vsize)
 327 {
 328         struct sysfs_attribute *attr = NULL;
 329         size_t length = 0;
 330
 331         if (attrpath == NULL || value == NULL || vsize == 0) {
 332                 errno = EINVAL;
 333                 return -1;
 334         }
 335
 336         attr = sysfs_open_attribute(attrpath);
 337         if (attr == NULL) {
 338                 dprintf("Invalid attribute path %s\n", attrpath);
 339                 errno = EINVAL;
 340                 return -1;
 341         }
 342         if((sysfs_read_attribute(attr)) != 0 || attr->value == NULL) {
 343                 dprintf("Error reading from attribute %s\n", attrpath);
 344                 sysfs_close_attribute(attr);
 345                 return -1;
 346         }
 347         length = strlen(attr->value);
 348         if (length > vsize)
 349                 dprintf("Value length %d is larger than supplied buffer %d\n",
 350                         length, vsize);
 351         safestrcpymax(value, attr->value, vsize);
 352         sysfs_close_attribute(attr);
 353
 354         return 0;
 355 }
 356
 357 /**
 358  * sysfs_get_value_from_attrbutes: given a linked list of attributes and an
 359  *      attribute name, return its value
 360  * @attr: attribute to search
 361  * @name: name to look for
 362  * returns char * value - could be NULL
 363  */
 364 char *sysfs_get_value_from_attributes(struct dlist *attr, const char *name)
 365 {
 366         struct sysfs_attribute *cur = NULL;
 367
 368         if (attr == NULL || name == NULL) {
 369                 errno = EINVAL;
 370                 return NULL;
 371         }
 372         dlist_for_each_data(attr, cur, struct sysfs_attribute) {
 373                 if (strcmp(cur->name, name) == 0)
 374                         return cur->value;
 375         }
 376         return NULL;
 377 }
 378
 379 /**
 380  * sysfs_close_link: closes and cleans up link.
 381  * @ln: link to close.
 382  */
 383 void sysfs_close_link(struct sysfs_link *ln)
 384 {
 385         if (ln != NULL)
 386                 free(ln);
 387 }
 388
 389 /**
 390  * sysfs_close_directory: closes directory, cleans up attributes and links
 391  * @sysdir: sysfs_directory to close
 392  */
 393 void sysfs_close_directory(struct sysfs_directory *sysdir)
 394 {
 395         if (sysdir != NULL) {
 396                 if (sysdir->subdirs != NULL)
 397                         dlist_destroy(sysdir->subdirs);
 398                 if (sysdir->links != NULL)
 399                         dlist_destroy(sysdir->links);
 400                 if (sysdir->attributes != NULL)
 401                         dlist_destroy(sysdir->attributes);
 402                 free(sysdir);
 403                 sysdir = NULL;
 404         }
 405 }
 406
 407 /**
 408  * alloc_directory: allocates and initializes directory structure
 409  * returns struct sysfs_directory with success or NULL with error.
 410  */
 411 static struct sysfs_directory *alloc_directory(void)
 412 {
 413         return (struct sysfs_directory *)
 414                         calloc(1, sizeof(struct sysfs_directory));
 415 }
 416
 417 /**
 418  * alloc_link: allocates and initializes link structure
 419  * returns struct sysfs_link with success or NULL with error.
 420  */
 421 static struct sysfs_link *alloc_link(void)
 422 {
 423         return (struct sysfs_link *)calloc(1, sizeof(struct sysfs_link));
 424 }
 425
 426 /**
 427  * sysfs_read_all_subdirs: calls sysfs_read_directory for all subdirs
 428  * @sysdir: directory whose subdirs need reading.
 429  * returns 0 with success and -1 with error.
 430  */
 431 int sysfs_read_all_subdirs(struct sysfs_directory *sysdir)
 432 {
 433         struct sysfs_directory *cursub = NULL;
 434         int retval = 0;
 435
 436         if (sysdir == NULL) {
 437                 errno = EINVAL;
 438                 return -1;
 439         }
 440         if (sysdir->subdirs == NULL)
 441                 if ((sysfs_read_dir_subdirs(sysdir)) != 0)
 442                         return 0;
 443         if (sysdir->subdirs != NULL) {
 444                 dlist_for_each_data(sysdir->subdirs, cursub,
 445                                                 struct sysfs_directory) {
 446                         if ((sysfs_read_dir_subdirs(cursub)) != 0) {
 447                                 dprintf ("Error reading subdirectory %s\n",
 448                                                 cursub->name);
 449                                 retval = -1;
 450                         }
 451                 }
 452         }
 453         if (!retval)
 454                 errno = 0;
 455         return retval;
 456 }
 457
 458 /**
 459  * sysfs_open_directory: opens a sysfs directory, creates dir struct, and
 460  *              returns.
 461  * @path: path of directory to open.
 462  * returns: struct sysfs_directory * with success and NULL on error.
 463  */
 464 struct sysfs_directory *sysfs_open_directory(const char *path)
 465 {
 466         struct sysfs_directory *sdir = NULL;
 467
 468         if (path == NULL) {
 469                 errno = EINVAL;
 470                 return NULL;
 471         }
 472
 473         if (sysfs_path_is_dir(path) != 0) {
 474                 dprintf("Invalid path to directory %s\n", path);
 475                 errno = EINVAL;
 476                 return NULL;
 477         }
 478
 479         sdir = alloc_directory();
 480         if (sdir == NULL) {
 481                 dprintf("Error allocating directory %s\n", path);
 482                 return NULL;
 483         }
 484         if (sysfs_get_name_from_path(path, sdir->name, SYSFS_NAME_LEN) != 0) {
 485                 dprintf("Error getting directory name from path: %s\n", path);
 486                 sysfs_close_directory(sdir);
 487                 return NULL;
 488         }
 489         safestrcpy(sdir->path, path);
 490
 491         return sdir;
 492 }
 493
 494 /**
 495  * sysfs_open_link: opens a sysfs link, creates struct, and returns
 496  * @path: path of link to open.
 497  * returns: struct sysfs_link * with success and NULL on error.
 498  */
 499 struct sysfs_link *sysfs_open_link(const char *linkpath)
 500 {
 501         struct sysfs_link *ln = NULL;
 502
 503         if (linkpath == NULL || strlen(linkpath) > SYSFS_PATH_MAX) {
 504                 errno = EINVAL;
 505                 return NULL;
 506         }
 507
 508         ln = alloc_link();
 509         if (ln == NULL) {
 510                 dprintf("Error allocating link %s\n", linkpath);
 511                 return NULL;
 512         }
 513         safestrcpy(ln->path, linkpath);
 514         if ((sysfs_get_name_from_path(linkpath, ln->name, SYSFS_NAME_LEN)) != 0
 515             || (sysfs_get_link(linkpath, ln->target, SYSFS_PATH_MAX)) != 0) {
 516                 errno = EINVAL;
 517                 dprintf("Invalid link path %s\n", linkpath);
 518                 return NULL;
 519         }
 520
 521         return ln;
 522 }
 523
 524 /**
 525  * add_attribute: open and add attribute at path to given directory
 526  * @sysdir: directory to add attribute to
 527  * @path: path to attribute
 528  * returns 0 with success and -1 with error.
 529  */
 530 static int add_attribute(struct sysfs_directory *sysdir, const char *path)
 531 {
 532         struct sysfs_attribute *attr = NULL;
 533
 534         attr = sysfs_open_attribute(path);
 535         if (attr == NULL) {
 536                 dprintf("Error opening attribute %s\n", path);
 537                 return -1;
 538         }
 539         if (attr->method & SYSFS_METHOD_SHOW) {
 540                 if ((sysfs_read_attribute(attr)) != 0) {
 541                         dprintf("Error reading attribute %s\n", path);
 542                         sysfs_close_attribute(attr);
 543                         return 0;
 544                 }
 545         }
 546
 547         if (sysdir->attributes == NULL) {
 548                 sysdir->attributes = dlist_new_with_delete
 549                         (sizeof(struct sysfs_attribute), sysfs_del_attribute);
 550         }
 551         dlist_unshift_sorted(sysdir->attributes, attr, sort_list);
 552
 553         return 0;
 554 }
 555
 556 /**
 557  * add_subdirectory: open and add subdirectory at path to given directory
 558  * @sysdir: directory to add subdir to
 559  * @path: path to subdirectory
 560  * returns 0 with success and -1 with error.
 561  */
 562 static int add_subdirectory(struct sysfs_directory *sysdir, const char *path)
 563 {
 564         struct sysfs_directory *subdir = NULL;
 565
 566         subdir = sysfs_open_directory(path);
 567         if (subdir == NULL) {
 568                 dprintf("Error opening directory %s\n", path);
 569                 return -1;
 570         }
 571         if (sysdir->subdirs == NULL)
 572                 sysdir->subdirs = dlist_new_with_delete
 573                         (sizeof(struct sysfs_directory), sysfs_del_directory);
 574         dlist_unshift_sorted(sysdir->subdirs, subdir, sort_list);
 575         return 0;
 576 }
 577
 578 /**
 579  * add_link: open and add link at path to given directory
 580  * @sysdir: directory to add link to
 581  * @path: path to link
 582  * returns 0 with success and -1 with error.
 583  */
 584 static int add_link(struct sysfs_directory *sysdir, const char *path)
 585 {
 586         struct sysfs_link *ln = NULL;
 587
 588         ln = sysfs_open_link(path);
 589         if (ln == NULL) {
 590                 dprintf("Error opening link %s\n", path);
 591                 return -1;
 592         }
 593         if (sysdir->links == NULL)
 594                 sysdir->links = dlist_new_with_delete
 595                                 (sizeof(struct sysfs_link), sysfs_del_link);
 596         dlist_unshift_sorted(sysdir->links, ln, sort_list);
 597         return 0;
 598 }
 599
 600 /**
 601  * sysfs_read_dir_attributes: grabs attributes for the given directory
 602  * @sysdir: sysfs directory to open
 603  * returns 0 with success and -1 with error.
 604  */
 605 int sysfs_read_dir_attributes(struct sysfs_directory *sysdir)
 606 {
 607         DIR *dir = NULL;
 608         struct dirent *dirent = NULL;
 609         char file_path[SYSFS_PATH_MAX];
 610         int retval = 0;
 611
 612         if (sysdir == NULL) {
 613                 errno = EINVAL;
 614                 return -1;
 615         }
 616         dir = opendir(sysdir->path);
 617         if (dir == NULL) {
 618                 dprintf("Error opening directory %s\n", sysdir->path);
 619                 return -1;
 620         }
 621         while(((dirent = readdir(dir)) != NULL) && retval == 0) {
 622                 if (0 == strcmp(dirent->d_name, "."))
 623                          continue;
 624                 if (0 == strcmp(dirent->d_name, ".."))
 625                         continue;
 626                 memset(file_path, 0, SYSFS_PATH_MAX);
 627                 safestrcpy(file_path, sysdir->path);
 628                 safestrcat(file_path, "/");
 629                 safestrcat(file_path, dirent->d_name);
 630                 if ((sysfs_path_is_file(file_path)) == 0)
 631                         retval = add_attribute(sysdir, file_path);
 632         }
 633         closedir(dir);
 634         if (!retval)
 635                 errno = 0;
 636         return(retval);
 637 }
 638
 639 /**
 640  * sysfs_read_dir_links: grabs links in a specific directory
 641  * @sysdir: sysfs directory to read links
 642  * returns 0 with success and -1 with error.
 643  */
 644 int sysfs_read_dir_links(struct sysfs_directory *sysdir)
 645 {
 646         DIR *dir = NULL;
 647         struct dirent *dirent = NULL;
 648         char file_path[SYSFS_PATH_MAX];
 649         int retval = 0;
 650
 651         if (sysdir == NULL) {
 652                 errno = EINVAL;
 653                 return -1;
 654         }
 655         dir = opendir(sysdir->path);
 656         if (dir == NULL) {
 657                 dprintf("Error opening directory %s\n", sysdir->path);
 658                 return -1;
 659         }
 660         while(((dirent = readdir(dir)) != NULL) && retval == 0) {
 661                 if (0 == strcmp(dirent->d_name, "."))
 662                          continue;
 663                 if (0 == strcmp(dirent->d_name, ".."))
 664                         continue;
 665                 memset(file_path, 0, SYSFS_PATH_MAX);
 666                 safestrcpy(file_path, sysdir->path);
 667                 safestrcat(file_path, "/");
 668                 safestrcat(file_path, dirent->d_name);
 669                 if ((sysfs_path_is_link(file_path)) == 0) {
 670                         retval = add_link(sysdir, file_path);
 671                         if (retval != 0)
 672                                 break;
 673                 }
 674         }
 675         closedir(dir);
 676         if (!retval)
 677                 errno = 0;
 678         return(retval);
 679 }
 680
 681 /**
 682  * sysfs_read_dir_subdirs: grabs subdirs in a specific directory
 683  * @sysdir: sysfs directory to read links
 684  * returns 0 with success and -1 with error.
 685  */
 686 int sysfs_read_dir_subdirs(struct sysfs_directory *sysdir)
 687 {
 688         DIR *dir = NULL;
 689         struct dirent *dirent = NULL;
 690         char file_path[SYSFS_PATH_MAX];
 691         int retval = 0;
 692
 693         if (sysdir == NULL) {
 694                 errno = EINVAL;
 695                 return -1;
 696         }
 697         dir = opendir(sysdir->path);
 698         if (dir == NULL) {
 699                 dprintf("Error opening directory %s\n", sysdir->path);
 700                 return -1;
 701         }
 702         while(((dirent = readdir(dir)) != NULL) && retval == 0) {
 703                 if (0 == strcmp(dirent->d_name, "."))
 704                          continue;
 705                 if (0 == strcmp(dirent->d_name, ".."))
 706                         continue;
 707                 memset(file_path, 0, SYSFS_PATH_MAX);
 708                 safestrcpy(file_path, sysdir->path);
 709                 safestrcat(file_path, "/");
 710                 safestrcat(file_path, dirent->d_name);
 711                 if ((sysfs_path_is_dir(file_path)) == 0)
 712                         retval = add_subdirectory(sysdir, file_path);
 713         }
 714         closedir(dir);
 715         if (!retval)
 716                 errno = 0;
 717         return(retval);
 718 }
 719
 720 /**
 721  * sysfs_read_directory: grabs attributes, links, and subdirectories
 722  * @sysdir: sysfs directory to open
 723  * returns 0 with success and -1 with error.
 724  */
 725 int sysfs_read_directory(struct sysfs_directory *sysdir)
 726 {
 727         DIR *dir = NULL;
 728         struct dirent *dirent = NULL;
 729         struct stat astats;
 730         char file_path[SYSFS_PATH_MAX];
 731         int retval = 0;
 732
 733         if (sysdir == NULL) {
 734                 errno = EINVAL;
 735                 return -1;
 736         }
 737         dir = opendir(sysdir->path);
 738         if (dir == NULL) {
 739                 dprintf("Error opening directory %s\n", sysdir->path);
 740                 return -1;
 741         }
 742         while(((dirent = readdir(dir)) != NULL) && retval == 0) {
 743                 if (0 == strcmp(dirent->d_name, "."))
 744                          continue;
 745                 if (0 == strcmp(dirent->d_name, ".."))
 746                         continue;
 747                 memset(file_path, 0, SYSFS_PATH_MAX);
 748                 safestrcpy(file_path, sysdir->path);
 749                 safestrcat(file_path, "/");
 750                 safestrcat(file_path, dirent->d_name);
 751                 if ((lstat(file_path, &astats)) != 0) {
 752                         dprintf("stat failed\n");
 753                         continue;
 754                 }
 755                 if (S_ISDIR(astats.st_mode))
 756                         retval = add_subdirectory(sysdir, file_path);
 757
 758                 else if (S_ISLNK(astats.st_mode))
 759                         retval = add_link(sysdir, file_path);
 760
 761                 else if (S_ISREG(astats.st_mode))
 762                         retval = add_attribute(sysdir, file_path);
 763         }
 764         closedir(dir);
 765         if (!retval)
 766                 errno = 0;
 767         return(retval);
 768 }
 769
 770 /**
 771  * sysfs_refresh_dir_attributes: Refresh attributes list
 772  * @sysdir: directory whose list of attributes to refresh
 773  * Returns 0 on success, 1 on failure
 774  */
 775 int sysfs_refresh_dir_attributes(struct sysfs_directory *sysdir)
 776 {
 777         if (sysdir == NULL) {
 778                 errno = EINVAL;
 779                 return 1;
 780         }
 781         if ((sysfs_path_is_dir(sysdir->path)) != 0) {
 782                 dprintf("Invalid path to directory %s\n", sysdir->path);
 783                 errno = EINVAL;
 784                 return 1;
 785         }
 786         if (sysdir->attributes != NULL) {
 787                 dlist_destroy(sysdir->attributes);
 788                 sysdir->attributes = NULL;
 789         }
 790         if ((sysfs_read_dir_attributes(sysdir)) != 0) {
 791                 dprintf("Error refreshing attributes for directory %s\n",
 792                                                         sysdir->path);
 793                 return 1;
 794         }
 795         errno = 0;
 796         return 0;
 797 }
 798
 799 /**
 800  * sysfs_refresh_dir_links: Refresh links list
 801  * @sysdir: directory whose list of links to refresh
 802  * Returns 0 on success, 1 on failure
 803  */
 804 int sysfs_refresh_dir_links(struct sysfs_directory *sysdir)
 805 {
 806         if (sysdir == NULL) {
 807                 errno = EINVAL;
 808                 return 1;
 809         }
 810         if ((sysfs_path_is_dir(sysdir->path)) != 0) {
 811                 dprintf("Invalid path to directory %s\n", sysdir->path);
 812                 errno = EINVAL;
 813                 return 1;
 814         }
 815         if (sysdir->links != NULL) {
 816                 dlist_destroy(sysdir->links);
 817                 sysdir->links = NULL;
 818         }
 819         if ((sysfs_read_dir_links(sysdir)) != 0) {
 820                 dprintf("Error refreshing links for directory %s\n",
 821                                                         sysdir->path);
 822                 return 1;
 823         }
 824         errno = 0;
 825         return 0;
 826 }
 827
 828 /**
 829  * sysfs_refresh_dir_subdirs: Refresh subdirs list
 830  * @sysdir: directory whose list of subdirs to refresh
 831  * Returns 0 on success, 1 on failure
 832  */
 833 int sysfs_refresh_dir_subdirs(struct sysfs_directory *sysdir)
 834 {
 835         if (sysdir == NULL) {
 836                 errno = EINVAL;
 837                 return 1;
 838         }
 839         if ((sysfs_path_is_dir(sysdir->path)) != 0) {
 840                 dprintf("Invalid path to directory %s\n", sysdir->path);
 841                 errno = EINVAL;
 842                 return 1;
 843         }
 844         if (sysdir->subdirs != NULL) {
 845                 dlist_destroy(sysdir->subdirs);
 846                 sysdir->subdirs = NULL;
 847         }
 848         if ((sysfs_read_dir_subdirs(sysdir)) != 0) {
 849                 dprintf("Error refreshing subdirs for directory %s\n",
 850                                                         sysdir->path);
 851                 return 1;
 852         }
 853         errno = 0;
 854         return 0;
 855 }
 856
 857 /**
 858  * sysfs_get_directory_attribute: retrieves attribute attrname from current
 859  *      directory only
 860  * @dir: directory to retrieve attribute from
 861  * @attrname: name of attribute to look for
 862  *
 863  * NOTE: Since we know the attribute to look for, this routine looks for the
 864  *      attribute if it was created _after_ the attrlist was read initially.
 865  *
 866  * returns sysfs_attribute if found and NULL if not found
 867  */
 868 struct sysfs_attribute *sysfs_get_directory_attribute
 869                         (struct sysfs_directory *dir, char *attrname)
 870 {
 871         struct sysfs_attribute *attr = NULL;
 872         char new_path[SYSFS_PATH_MAX];
 873
 874         if (dir == NULL || attrname == NULL) {
 875                 errno = EINVAL;
 876                 return NULL;
 877         }
 878
 879         if (dir->attributes == NULL)
 880                 if ((sysfs_read_dir_attributes(dir) != 0)
 881                     || (dir->attributes == NULL))
 882                         return NULL;
 883
 884         attr = (struct sysfs_attribute *)dlist_find_custom
 885                         (dir->attributes, attrname, dir_attribute_name_equal);
 886         if (attr != NULL) {
 887                 if ((sysfs_read_attribute(attr)) != 0) {
 888                         dprintf("Error reading attribute %s\n", attr->name);
 889                         return NULL;
 890                 }
 891         } else {
 892                 memset(new_path, 0, SYSFS_PATH_MAX);
 893                 safestrcpy(new_path, dir->path);
 894                 safestrcat(new_path, "/");
 895                 safestrcat(new_path, attrname);
 896                 if ((sysfs_path_is_file(new_path)) == 0) {
 897                         if ((add_attribute(dir, new_path)) == 0) {
 898                                 attr = (struct sysfs_attribute *)
 899                                         dlist_find_custom(dir->attributes,
 900                                         attrname, dir_attribute_name_equal);
 901                         }
 902                 }
 903         }
 904
 905         return attr;
 906 }
 907
 908 /**
 909  * sysfs_get_directory_link: retrieves link from one directory list
 910  * @dir: directory to retrieve link from
 911  * @linkname: name of link to look for
 912  * returns reference to sysfs_link if found and NULL if not found
 913  */
 914 struct sysfs_link *sysfs_get_directory_link
 915                         (struct sysfs_directory *dir, char *linkname)
 916 {
 917         if (dir == NULL || linkname == NULL) {
 918                 errno = EINVAL;
 919                 return NULL;
 920         }
 921         if (dir->links == NULL) {
 922                 if ((sysfs_read_dir_links(dir) != 0) || (dir->links == NULL))
 923                         return NULL;
 924         } else {
 925                 if ((sysfs_refresh_dir_links(dir)) != 0)
 926                         return NULL;
 927         }
 928
 929         return (struct sysfs_link *)dlist_find_custom(dir->links,
 930                 linkname, dir_link_name_equal);
 931 }
 932
 933 /**
 934  * sysfs_get_subdirectory: retrieves subdirectory by name.
 935  * @dir: directory to search for subdirectory.
 936  * @subname: subdirectory name to get.
 937  * returns reference to subdirectory or NULL if not found
 938  */
 939 struct sysfs_directory *sysfs_get_subdirectory(struct sysfs_directory *dir,
 940                                                 char *subname)
 941 {
 942         struct sysfs_directory *sub = NULL, *cursub = NULL;
 943
 944         if (dir == NULL || subname == NULL) {
 945                 errno = EINVAL;
 946                 return NULL;
 947         }
 948
 949         if (dir->subdirs == NULL)
 950                 if (sysfs_read_dir_subdirs(dir) != 0)
 951                         return NULL;
 952
 953         sub = (struct sysfs_directory *)dlist_find_custom(dir->subdirs,
 954                 subname, dir_subdir_name_equal);
 955         if (sub != NULL)
 956                 return sub;
 957
 958         if (dir->subdirs != NULL) {
 959                 dlist_for_each_data(dir->subdirs, cursub,
 960                                         struct sysfs_directory) {
 961                         if (cursub->subdirs == NULL) {
 962                                 if (sysfs_read_dir_subdirs(cursub) != 0)
 963                                         continue;
 964                                 if (cursub->subdirs == NULL)
 965                                         continue;
 966                         }
 967                         sub = sysfs_get_subdirectory(cursub, subname);
 968                         if (sub != NULL)
 969                                 return sub;
 970                 }
 971         }
 972         return NULL;
 973 }
 974
 975 /**
 976  * sysfs_get_subdirectory_link: looks through all subdirs for specific link.
 977  * @dir: directory and subdirectories to search for link.
 978  * @linkname: link name to get.
 979  * returns reference to link or NULL if not found
 980  */
 981 struct sysfs_link *sysfs_get_subdirectory_link(struct sysfs_directory *dir,
 982                                                 char *linkname)
 983 {
 984         struct sysfs_directory *cursub = NULL;
 985         struct sysfs_link *ln = NULL;
 986
 987         if (dir == NULL || linkname == NULL) {
 988                 errno = EINVAL;
 989                 return NULL;
 990         }
 991
 992         ln = sysfs_get_directory_link(dir, linkname);
 993         if (ln != NULL)
 994                 return ln;
 995
 996         if (dir->subdirs == NULL)
 997                 if (sysfs_read_dir_subdirs(dir) != 0)
 998                         return NULL;
 999
1000         if (dir->subdirs != NULL) {
1001                 dlist_for_each_data(dir->subdirs, cursub,
1002                                                 struct sysfs_directory) {
1003                         ln = sysfs_get_subdirectory_link(cursub, linkname);
1004                         if (ln != NULL)
1005                                 return ln;
1006                 }
1007         }
1008         return NULL;
1009 }
1010
1011 /**
1012  * sysfs_get_dir_attributes: returns dlist of directory attributes
1013  * @dir: directory to retrieve attributes from
1014  * returns dlist of attributes or NULL
1015  */
1016 struct dlist *sysfs_get_dir_attributes(struct sysfs_directory *dir)
1017 {
1018         if (dir == NULL) {
1019                 errno = EINVAL;
1020                 return NULL;
1021         }
1022
1023         if (dir->attributes == NULL) {
1024                 if (sysfs_read_dir_attributes(dir) != 0)
1025                         return NULL;
1026         }
1027
1028         return (dir->attributes);
1029 }
1030
1031 /**
1032  * sysfs_get_dir_links: returns dlist of directory links
1033  * @dir: directory to return links for
1034  * returns dlist of links or NULL
1035  */
1036 struct dlist *sysfs_get_dir_links(struct sysfs_directory *dir)
1037 {
1038         if (dir == NULL) {
1039                 errno = EINVAL;
1040                 return NULL;
1041         }
1042
1043         if (dir->links == NULL) {
1044                 if (sysfs_read_dir_links(dir) != 0)
1045                         return NULL;
1046         }
1047
1048         return (dir->links);
1049 }
1050
1051 /**
1052  * sysfs_get_dir_subdirs: returns dlist of directory subdirectories
1053  * @dir: directory to return subdirs for
1054  * returns dlist of subdirs or NULL
1055  */
1056 struct dlist *sysfs_get_dir_subdirs(struct sysfs_directory *dir)
1057 {
1058         if (dir == NULL) {
1059                 errno = EINVAL;
1060                 return NULL;
1061         }
1062
1063         if (dir->subdirs == NULL) {
1064                 if (sysfs_read_dir_subdirs(dir) != 0)
1065                         return NULL;
1066         }
1067
1068         return (dir->subdirs);
1069 }