System Administration Commands datadm(1M)
NAME
datadm - maintain DAT static registry file
SYNOPSIS
/usr/bin/datadm [-v] [-u] [-a serviceprovider.conf]
[-r serviceprovider.conf]
DESCRIPTION
The datadm utility maintains the DAT static registry file,
dat.conf(4).
This administrative configuration program allows uDAPL ser-
vice providers to add and remove themselves to the dat.conf
file.
You can add or remove interface adapters that a service pro-
vider supports from a system after its installation. You can
use datadm to update the dat.conf file to reflect the
current state of the system. A new set of interface adapters
for all the service providers currently installed is regen-
erated.
OPTIONS
The following options are supported:
-a serviceprovider.conf Enumerate each device entry in
the serviceprovider.conf(4)
file into a list of interface
adapters, that is, interfaces to
external network that are avail-
able to uDAPL consumers.
-r serviceprovider.conf Remove the list of interface
adapters that corresponds to the
device entry in the
serviceprovider.conf(4) file.
-u Update the dat.conf to reflect
the current state of the system
with an up to date set of inter-
face adapters for the service
providers that are currently
listed in the DAT static regis-
try.
SunOS 5.11 Last change: 18 Jun 2004 1
System Administration Commands datadm(1M)
-v Display the DAT static registry
file, dat.conf.
EXAMPLES
Example 1 Enumerating a Device Entry
The following example enumerates a device entry in the
serviceprovider.conf(4) file into interface adapters in the
dat.conf(4) file.
Assume that SUNW has a service provider library that sup-
ports the device tavor. It has a serviceprovider.conf(4)
file installed in the directory
/usr/share/dat/SUNWudaplt.conf with a single entry as fol-
lows:
drivername=tavor u1.2 nonthreadsafe default\
udapltavor.so.1 SUNW.1.0 ""
tavor is an Infiniband Host Channel Adapter with two ports.
Both IB ports exist in a single IB partition, 0x8001. If an
IP interface is plumbed to each port, there are two IPoIB
device instances, ibd0 and ibd1:
# ls -l /dev/ibd*
/dev/ibd0 -> /devices/pci@1/pci15b3,5a44@0/ibport@1,8001,ipib:ibd0
/dev/ibd1 -> /devices/pci@1/pci15b3,5a44@0/ibport@2,8001,ipib:ibd1
Running the command, datadm -a
/usr/share/dat/SUNWudaplt.conf appends two new entries (if
they do not already exists]) in the /etc/dat/dat.conffile:
ibd0 u1.2 nonthreadsafe default udapltavor.so.1 SUNW.1.0 ""
"drivername=tavor"
ibd1 u1.2 nonthreadsafe default udapltavor.so.1 SUNW.1.0 ""
"drivername=tavor"
SunOS 5.11 Last change: 18 Jun 2004 2
System Administration Commands datadm(1M)
Example 2 Updating the dat.conf to Reflect the Current State
of the System
A new IB partition, 0x8002 is added to the above example
covering port 1 of the Host Channel Adapter. If a new IP
interface is plumbed to port 1/partition 0x8002, there is a
third IPoIB device instance: ibd2.
# ls -l /dev/ibd*
/dev/ibd0 -> /devices/pci@1/pci15b3,5a44@0/ibport@1,8001,ipib:ibd0
/dev/ibd1 -> /devices/pci@1/pci15b3,5a44@0/ibport@2,8001,ipib:ibd1
/dev/ibd2 -> /devices/pci@1/pci15b3,5a44@0/ibport@1,8002,ipib:ibd2
Running datadm -u command, updates the /etc/dat/dat.conf
file with a new entry added reflecting the current state of
the system.
datadm -v shows that there are now three entries in the
/etc/dat/dat.conf file:
ibd0 u1.2 nonthreadsafe default udapltavor.so.1 SUNW.1.0 ""
"drivername=tavor"
ibd1 u1.2 nonthreadsafe default udapltavor.so.1 SUNW.1.0 ""
"drivername=tavor"
ibd2 u1.2 nonthreadsafe default udapltavor.so.1 SUNW.1.0 ""
"drivername=tavor"
FILES
/etc/dat/dat.conf DAT static registry file
ATRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
SunOS 5.11 Last change: 18 Jun 2004 3
System Administration Commands datadm(1M)
ATRIBUTE TYPE ATRIBUTE VALUE
Availability SUNWudaplu
Interface Stability Evolving
SEE ALSO
pkgadd(1M), pkgrm(1M), libdat(3LIB), dat.conf(4),
serviceprovider.conf(4). attributes(5)
SunOS 5.11 Last change: 18 Jun 2004 4
|
