From c4857e820ea265226fc4ae1ce868bd77d662db7e Mon Sep 17 00:00:00 2001 From: Andrew Johnson Date: Mon, 19 Jan 2009 19:04:40 +0000 Subject: [PATCH] Added dbGetNAliases(). --- documentation/RELEASE_NOTES.html | 15 +++++++++------ 1 file changed, 9 insertions(+), 6 deletions(-) diff --git a/documentation/RELEASE_NOTES.html b/documentation/RELEASE_NOTES.html index ca8b63e6c..7db3869f2 100644 --- a/documentation/RELEASE_NOTES.html +++ b/documentation/RELEASE_NOTES.html @@ -27,18 +27,21 @@ alias("canonicalName","secondAlias")

Aliases can only be created for records that have already been loaded by the IOC, although they don't have to appear in the same .db file. A CA client can discover that a record name is an alias by fetching its .NAME field, which will -always return the canonical name for the record. Three new routines in the +always return the canonical name for the record. These new routines in the dbStaticLib library handle aliases:

long dbCreateAlias(DBENTRY *pdbentry, const char *paliasName);
 int dbIsAlias(DBENTRY *pdbentry);
+int dbGetNAliases(DBENTRY *pdbentry)
 long dbDeleteAliases(DBENTRY *pdbentry);
-

Aliases are located using the existing record instance API (use -dbIsAlias() to test whether a record is actually an alias or not), and -can be deleted using dbDeleteRecord(). The dbDeleteAliases() -routine exists to delete all aliases of the selected record, and will return an -error if used on an alias.

+

Aliases are located using the existing record instance API. Use +dbIsAlias() to test whether a record is actually an alias or not. +Aliasees can be deleted like record instances using dbDeleteRecord() +which will not delete the underlying record if the DBENTRY refers to the alias +(deleting a record instance does delete all its aliases though). The +dbDeleteAliases() routine deletes all aliases of the selected record, +and will return an error if used on an alias.

Any out-of-tree tools that scan through all the records in the database using dbFirstRecord() and dbNextRecord() may need modifying to avoid