---
name: "SIS::DB"
section: "3pm"
platform: "linux"
package: "systeminstaller"
version: "1.04-3"
release: "Debian 4.0 (Etch)"
platforms: ["linux"]
url: "https://new.carta.tech/SIS::DB"
---

# SIS::DB(3pm)

SIS::DB - SIS Interface for client, image, and adapter objects

```
  use SIS::DB;
```

```
  my @clients = list_client();
  my $name = $clients[0]->name();
  del_client($name);
  my $newname = "test";
  $clients[0]->name($newname) or croak("Can't set name on client");
  set_client($clients[0]);
```

The SIS::DB interface gives one access to the System Installation Suite Database.  There exists 4 functions for every object type: exists\_X, list\_X, set\_X, del\_X.  (These will be discussed in detail later). The behavior of this module may be changed by setting certain environmental variables before calling use.\
 **exists\_X** exists\_X($name) - does this object exist?

returns true if the object with that name exists, false otherwise. This is used for quick lookups to see if something is defined.  (note: exists\_adapter is different, and needs ($devname, `$client`) passed to it) \
 **list\_X** list\_X(\[n1 =\> v1, ...\])  - return list of objects of type X that satisfy criteria n1 =\> v1.

If called with no args, it returns the list of all the objects of type X.  With args, it will return the list of objects that satisfy the criteria listed (like 'imagename =\> myimage').

If called in scalar context, and if the criteria matches only one object, it will return the single object instead of the list.  If called in scalar context, if the criteria matches multiple objects, the function will return 'undef'.\
 **set\_X** set\_X($object1\[, `$object2`...\]) - store objects of type X.\
 **del\_X** del\_X($primkey) - detele object of type X by key using `$primkey` as the value.

```
  Copyright 2002 International Business Machines
  Sean Dague <sean@dague.net>
```