Digital DCE for OpenVMS VAX and OpenVMS Alpha
Reference Guide


Previous Contents Index


gssdce_test_oid_set_member(3gss)

Checks an OID set to see if a specified OID is in the set.

Syntax

OM_uint32 gssdce_test_oid_set_member(
minor _status,
member _OID,
set ,
is _present |* 1=present, 0=absent *| )

Argument Data Type Access
minor_status OM_uint32 write
member_OID gss_OID read
set gss_OID_set read
is_present int write

C Binding

#include <DCE/GSSAPI.H>


OM_uint32 gssdce_test_oid_set_member (
OM_uint32 *minor_status,
gss_OID member_OID,
gss_OID_set set,
int *is_present)


Arguments

minor_status

Returns a status code from the security mechanism.

member_OID

Specifies the OID to search for in the OID set.

set

Specifies the OID set to check.

is_present

Returns one of the following values to indicate whether the OID is a member of the OID set:
Returns... If...
1 The OID is present as a member of the OID set.
0 The OID is absent, not a member of the OID set.

Description

The gssdce_test_oid_set_member() routine checks an OID set to see if the specified OID is a member of the set. To add a member to an OID set, use the gssdce_add_oid_set_member() routine.

The gssdce_test_oid_set_member() routine uses the value of the actual_mechs output parameter from the gss_acquire_cred() routine to get the list of OIDs. It checks this list to see if any of the OIDs are members of the OID set.


Return Values

Possible return values are as follows:
Return Description
GSS_S_COMPLETE The routine was completed successfully.
GSS_S_FAILURE The routine failed. Check the minor status for details.

See Also

gssdce_add_oid_set_member(3gss)
gss_acquire_cred(3gss)
gss_indicate_mechs(3gss)


Part 3
CDS Subtree Reference


Chapter 6
CDS Subtree Commands

This chapter contains reference information on the CDS subtree commands discussed in the Digital DCE for OpenVMS VAX and OpenVMS Alpha Product Guide.


delete subtree(8cds)

Deletes a subtree of directories and their contents or an individual directory and its contents.

Synopsis

cdscp delete subtree tree-name [norecurse] [exclude entry-type ]


Parameters

tree-name

The name of the uppermost directory in the subtree you intend to delete. You can use the optional norecurse keyword to restrict the deletion only to the directory (and contents) you specify in tree-name.

entry-type

One or more of the following types of entries to exclude from deletion: all objects, soft links, or specific directories. You can exclude multiple entry-types in a single command. Use any combination of the following entry-type specifiers, separating multiple arguments with commas. You must leave a blank character space after each comma and after each directory-name specification.

Description

The delete subtree command deletes a subtree of directories and their contents. You can use the optional norecurse keyword to restrict the deletion to only the directory you specify in tree-name. If that directory has child directories (and you use the optional norecurse keyword) the command deletes only the directory's contents.

You can use the optional exclude directory argument to specify one or more directories to exclude from deletion. Specify multiple directories in the following format:


exclude directory directory-name, directory 
directory-name, directory directory-name

Permissions Required

You must have delete permission to all affected directories and their contents. (Delete and administer permission to all affected directories is also sufficient.) You also need write permission to the clearinghouse that stores the master replica of the directory you specify in tree-name.

Note

This command is an added-value Digital feature that is fully compatible with other DCE products.

Example

The following command deletes the /.:/admin/site03 directory and its contents as well as all of its child directories and their contents.


cdscp>  delete subtree /.:/admin/site03


See Also

delete_directory
dump_subtree
merge_file
merge_subtree

dump subtree(8cds)

Dumps a subtree of directories and their contents into an interim file.

Synopsis

cdscp dump subtree tree-name [norecurse] [to, into] file filename [exclude entry-type ]


Parameters

tree-name

The name of the uppermost directory in the subtree you intend to dump to the interim file. You can use the optional norecurse keyword to restrict the dump only to the directory (and contents) you specify in tree-name.

filename

The name of the interim file to which the subtree is dumped.

entry-type

One or more of the following types of entries to exclude from the dump: all ACLs, object entries, soft links, or specific directories. You can exclude multiple entry types in a single command. Use any combination of the following entry-type specifiers, separating multiple arguments with commas. You must leave a blank character space after each comma and after each directory-name specification.

Description

The dump subtree command dumps a subtree of directories and their contents into an interim file. You can use the optional norecurse keyword to dump only the directory (and contents) you specify in tree-name. You can use the optional [exclude] keyword to omit all ACLs, object entries, soft links, or specific directories from the interim file. Use the file extension .dat as a convention for interim filenames.

This command is useful for backing up individual directories or subtrees and can also be used as the first step of a directory merge operation. If you intend to merge a subtree into the namespace of a foreign cell (or a reconfigured cell), use the optional exclude keyword to exclude the ACLs from the interim file.

ACLs that reference the source cell name will have no meaning in the target cell and will convey no access.

Permissions Required

You must have read permission to all affected directories and their contents.

Note

This command is an added-value Digital feature that is fully compatible with other DCE products.

Example

The following command creates an interim file named /.:/admin/site03.dat that contains the /.:/admin/site03 directory, its contents, and all its subdirectories and their contents.


cdscp>  dump subtree /.:/admin/site03 into file site03.dat


See Also

delete_subtree
merge_file
merge_subtree

merge file(8cds)

Merges the contents of an interim file (created with the dump subtree command) into an existing subtree.

Synopsis

cdscp merge file ifile [to, into] subtree tree-name failures [to] file [=] filename


Parameters

ifile

The name of an interim file that contains a directory and its contents, or a subtree of directories and their contents.

tree-name

The name of the uppermost directory in the target subtree.

filename

The name of a failures file that contains names that could not be merged.

Description

The merge file command merges the contents of an interim file created with the dump subtree command into an existing subtree whose uppermost directory you specify in tree-name. If the target directory tree-name does not exist, you must use the create directory or recreate directory command to create the target directory before you proceed.

The existing values of the CDS_Convergence, CDS_InChName, and CDS_UpgradeTo attributes associated with the directory you specify in tree-name are overwritten with the corresponding attribute values associated with the directory that was specified as tree-name in the dump subtree command used to create the interim file.

If you did not exclude source subtree ACLs from the interim file, the ACLs of new entries created in the target subtree as a result of the merge will contain the original source subtree ACL entries as well as any ACL entries that may propagate from the new parent directory in the target subtree of the uppermost directory in the interim file. The principal who executes the merge file command is granted full permission to all new entries in the target subtree.

You use the failures to file = filename argument to specify the name of a file that will contain the names of any directories, object entries, or soft links (including their ACLs) that could not be merged. You can use this file if you perform subsequent merge file operations to merge failed names.

Permissions Required

You must have read and insert permission to the target directory (and contents) you specify in tree-name. You also need write permission to the clearinghouse that stores the master replica of the uppermost directory in the target subtree.

Note

This command is an added-value Digital feature that is fully compatible with other DCE products.

Example

The following command merges the interim file branch01.dat with the /.:/admin/site03 directory:


cdscp> merge file branch01.dat into subtree /.:/admin/site03 failures to 
file = branch01failed.dat


See Also

dump_subtree
merge_subtree

merge subtree(8cds)

Dumps a directory or subtree and its contents into an interim file and then merges the contents of that file into an existing directory.

Synopsis

cdscp merge subtree old-tree-name [norecurse] [to, into] subtree new-tree-name [exclude entry-type ]


Parameters

old-tree-name

The name of the uppermost directory in the subtree whose directories and contents you intend to merge. If you use the optional norecurse keyword, you can restrict the dump and merge operation to the particular directory (and contents) you specify in old-tree-name.

new-tree-name

The name of the uppermost directory in the target subtree.

entry-type

One or more of the following types of entries to exclude from the dump and merge operation: ACLs, object entries, soft links, or specific directories. You can exclude multiple entries in a single command. Use any combination of the following entry-type specifiers, separating multiple arguments with commas. You must leave a blank character space after each comma and after each directory-name specification.

Description

The merge subtree command combines the operations performed by the dump subtree and merge file commands into a single operation. This command dumps a subtree into an interim file and then merges the contents of the file into another existing subtree. If you use the optional norecurse keyword, the command dumps and merges only the directory you specify in old-tree-name. You can use the optional exclude keyword to omit all ACLs, object entries, soft links, and specific directories form the dump and merge operation. The target directory you specify in new-tree-name must already exist. If it does not, the command returns an error and you must use the create directory or recreate directory command to create the target directory before you proceed.

This command is especially useful when all clearinghouses are available for every directory in both subtrees, no duplicate names exist in source and target subtrees, and when the permissions required to create entries in the target subtree have already been granted. If a duplicate name is detected, or if any affected clearinghouse cannot be reached while the merge subtree command is in progress, the command completes what it can. No failures file is created.

Permissions Required

You must have read permission to all affected directories and contents in the source subtree (old-tree-name). You also need read and insert permission to the target directory (and contents) you specify in new-tree-name, and write permission to the clearinghouse that stores the master replica of the target directory.

Note

This command is an added-value Digital feature that is fully compatible with other DCE products.

Example

The following command merges the contents of a subtree beginning with the /.:/admin/site01 directory with the /.:/admin/site02 directory.


cdscp>  merge subtree /.:/admin/site01 into subtree /.:/admin/site02


See Also

dump_subtree
merge_file

recreate directory(8cds)

Recreates an existing directory (in a source subtree) as a new directory (in a target subtree).

Synopsis

cdscp recreate directory directory-name [as] directory newdirectory-name [exclude acls]


Parameters

directory-name

The full name of the directory you intend to recreate.

newdirectory-name

The name of the recreated directory.

Description

The recreate directory command recreates an existing directory (in a source subtree) as a new directory (in a target subtree). Only the directory itself is duplicated, not its contents. This command does not delete or modify the source directory.

All writable attribute values of the source directory (CDS_Convergence, CDS_InChName, and CDS_UpgradeTo) are retained in the duplicate. The ACL entries associated with the source directory are also preserved unless you use the optional exclude acls keywords.

If you include a wildcard character in your directory-name specification, the name you specify as newdirectory-name must already exist. Only directories matching the wildcard are recreated in newdirectory-name.

Although all original ACL entries are retained, the duplicate directory also inherits ACL entries that may be propagated from its new parent directory in the target subtree. The principal executing this command is granted full access to the new directory.

The following attribute values are updated in the duplicate and may not match the values of the original directory: CDS_AllUpTo, CDS_CTS, CDS_DirectoryVersion, CDS_InCHName, CDS_ParentPointers, CDS_Replicas, and CDS_UTS.

Permissions Required

You must have read and insert permission to the target directory (newdirectory-name) in which you intend to recreate the source directory. You also need write permission to the clearinghouse that stores the master replica of the target directory.

Note

This command is an added-value Digital feature that is fully compatible with other DCE products.

Example

The following command recreates the existing directory /.:/sales/quar1 as a new directory named /.:/mkt/quar1.


cdscp>  recreate directory /.:/sales/quar1 as directory /.:/mkt/quar1


See Also

merge_file
merge_subtree
recreate_link
recreate_object

recreate link(8cds)

Recreates an existing soft link as a new soft link with a new full name.

Synopsis

cdscp recreate link link-name [as] link newlink-name [exclude acls]


Parameters

link-name

The full name of the soft link.

newlink-name

The new name of the soft link you are recreating. If you specify the name of an existing directory in the target subtree, the soft link is recreated in that directory with its original simple link name.

Description

The recreate link command creates a copy of the specified soft link with a new full name. All of the soft link's writable attribute values are retained in the duplicate. (CDS_CTS and CDS_UTS attribute values are not preserved.) You can use the optional exlude acls keywords to omit the original ACL entries from the duplicate.

Although all original ACL entries are retained, the new soft link also inherits ACL entries that may be propagated from the new parent directory in the target subtree. The principal executing this command is granted full access to the new soft link.

You can use a trailing wildcard character after the link-name argument to recreate multiple soft links. In this case, you must specify a directory in the newlink-name argument, and all recreated soft links will have the same simple names as their sources.

Permissions Required

You must have insert permission to the directory in which you intend to recreate the soft link.

Note

This command is an added-value Digital feature that is fully compatible with other DCE products.

Example

The following command recreates all soft links that exist in the /.:/sales directory as new soft links in the /.:/mkt directory.


cdscp>  recreate link /.:/sales/* as link /.:/mkt


See Also

merge_file
merge_subtree
recreate_directory
recreate_object

recreate object(8cds)

Recreates an existing object entry as a new object entry with a new full name.

Synopsis

cdscp recreate object object-name [as] object newobject-name [exclude acls]


Parameters

object-name

The full name of the object.

newobject-name

The new name of the copy of the object entry. If you specify the name of an existing directory in the target subtree, the object specified in object-name is recreated in that directory with its original simple name.

Description

The recreate object command creates a copy of an object entry with a new full name. All of the object's writable attribute values, including its ACL, are retained in the duplicate. (CDS_CTS and CDS_UTS attribute values are not preserved.) You can use the optional exclude acls keywords to omit the original ACL entries from the duplicate.

Although all original ACL entries are retained, the new object entry also inherits ACL entries that may be propagated from the new parent directory in the target subtree. The principal executing this command is granted full access to the new object entry.

You can use a trailing wildcard character after the object-name argument to recreate multiple object entries. In this case, you must specify an existing directory in the newobject-name argument and all duplicate object entries will have the same simple names as their sources. The command does not modify or delete the source object entry (or entries).

Permissions Required

You must have insert permission to the directory in which you intend to recreate the object entry.

Note

This command is an added-value Digital feature that is fully compatible with other DCE products.

Example

The following command recreates the existing object entry /.:/eng/psprinter03 as a new object entry named /.:/rnd/printer01.


cdscp>  recreate object /.:/eng/psprinter03 as object /.:/rnd/printer01


See Also

merge_file
merge_subtree
recreate_directory
recreate_link


Previous Next Contents Index