Displays current information about the specified directory.
SYNOPSIS
SHOW DIRECTORY directory-name [attribute-specifier]
[prepositional-phrase])
Arguments
directory-name
A specific directory name or a complete directory specification
followed by a wildcard template for matching simple names of
directories.
attribute-specifier
The name of an attribute group or a particular attribute. Enter one
or more of the following attribute specifiers:
all [attributes]
all characteristics
DNS$ACS
DNS$AllUpTo
DNS$Convergence
DNS$CTS
DNS$DirectoryVersion
DNS$InCHName
DNS$ParentPointer
DNS$Replicas
DNS$UpGradeTo
DNS$UTS
prepositional phrase
A phrase that affects the destination or content of command output.
Specify one or more of the following prepositional phrases:
with attribute [relop] value
to file[=]filename
to extend file[=]filename
to terminal
Description
This command displays the names and values of the attributes or
attribute groups named in attribute-specifier. If you do not supply
any attribute specifier, the command displays all attributes and
their values. You can use any combination of attribute specifiers
in any sequence in a single command. Use a comma to separate
specifiers.
ACCESS RIGHTS
You need read access to the directory to use the show command.
1 – access
Displays the access control set of a directory.
SYNOPSIS
SHOW DIRECTORY directory-name ACCESS [prepositional-phrase]
Arguments
directory-name
A specific directory name or a complete directory specification
followed by a wildcard template for matching simple names of
directories.
prepositional-phrase
ACCESS RIGHTS
You must have read access to the directory.
1.1 – example
The following command displays the access control set of the directory .sales and stores the output in a file called sdshow. dns> show directory .sales access, to file sdshow
1.2 – prepositional_phrases
A phrase that affects the destination or content of command output.
You can use one or more prepositional phrases. Be sure to precede
each of the following prepositional phrases with a comma and a
space:
to file[=]filename Redirects the output to
filename. If the file does not
exist, this command creates
it. If the file does exist, its
contents are overwritten.
to extend file[=]filename Appends the output to an
existing filename. If the file
does not exist, it is created.
to terminal Directs the output to the
terminal. This is the default
option.
2 – attributes
Every DECdns entity has attributes, which are pieces or sets of
data associated with that entity. Characteristics are attributes
that reflect or affect the operational behavior of an entity. If
you do not supply any specified attribute, the command displays
all attributes and their values. You can use any combination of
specified attributes in any sequence in a single command. Use a
comma to separate attributes. The following are descriptions of
valid attributes:
CHARACTERISTICS
DNS$ACS
Specifies the access control set for the directory.
DNS$AllUpTo
Indicates the date and time of the last successful skulk on the
directory. All replicas of the directory are guaranteed to have
received all updates whose timestamps are less than the value of
this characteristic.
DNS$Convergence
Specifies the degree of consistency among replicas. This attribute's
value can be one of the following:
Low The next skulk distributes all updates that occurred
since the previous skulk. Skulks occur at least once
every 24 hours.
Medium DECdns attempts to propagate an update to all
replicas. If the attempt fails, the next scheduled
skulk makes the replicas consistent. Skulks occur at
least once every 12 hours.
High DECdns attempts to propagate an update to all
replicas. If the attempt fails (for example, if
one of the replicas is unavailable), a skulk is
scheduled for within 1 hour. Background skulks will
occur at least once every 12 hours. Use this setting
temporarily and briefly, because it uses extensive
system resources.
By default, every directory inherits the convergence setting of its
parent at creation time. The default setting of the root directory
is medium.
DNS$CTS
Specifies the creation timestamp (CTS) of the directory DECdns.
DNS$DirectoryVersion
Specifies the current version of the directory (derived from the
DNS$Directory
Version attribute of the clearinghouse in which the directory was
created). Multiple directory versions are supported in a namespace.
DNS$InCHName
Specifies whether a directory or any of its descendants can store
clearinghouse names. If this value is True, the directory can store
clearinghouse names. If it is False, the directory cannot store
clearinghouse names.
DNS$ParentPointer
Contains a set of pointers to replicas of this directory's parent in
the namespace.
DNS$Replicas
Specifies the address, creation timestamp (CTS), and name of
every clearinghouse where a replica of this directory is located.
This attribute also specifies whether the replica in a particular
clearinghouse is a master or read-only replica.
DNS$UpgradeTo
Controls the upgrading of a directory from one version of DECdns to
another. By modifying this attribute, you can initiate the upgrading
of a directory to a newer version of DECdns.
DNS$UTS
Specifies the timestamp of the most recent update to an attribute of
the directory.
3 – example
The following command displays the creation timestamp (CTS), the time at which the .admin directory was created. dns> show directory .admin dns$cts
4 – prepositional_phrases
A phrase that affects the destination or content of command output.
You can use one or more prepositional phrases. Be sure to precede
each of the following prepositional phrases with a comma and a
space:
with attribute [relop] value When used with a wildcard child-
name, limits the output only
to directories whose specified
attributes have certain values.
to file[=]filename Redirects the output to
filename. If the file does not
exist, this command creates
it. If the file does exist, its
contents are overwritten.
to extend file[=]filename Appends the output to an
existing filename. If the file
does not exist, it is created.
to terminal Directs the output to the
terminal. This is the default
option.