jimzah/openafs
1
0
Fork 0
mirror of https://git.openafs.org/openafs.git synced 2025-01-19 15:30:14 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity
070f02923c
openafs/doc/html/AdminGuide/auagd025.htm
Derrick Brashear d7da1acc31 initial-html-documentation-20010606 
pull in all documentation from IBM
2001-06-06 19:09:07 +00:00

1080 lines
60 KiB
HTML
Raw Blame History

<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 4//EN">
<HTML><HEAD>
<TITLE>Administration Guide</TITLE>
<!-- Begin Header Records ========================================== -->
<!-- /tmp/idwt3570/auagd000.scr converted by idb2h R4.2 (359) ID -->
<!-- Workbench Version (AIX) on 2 Oct 2000 at 11:42:14 -->
<META HTTP-EQUIV="updated" CONTENT="Mon, 02 Oct 2000 11:42:13">
<META HTTP-EQUIV="review" CONTENT="Tue, 02 Oct 2001 11:42:13">
<META HTTP-EQUIV="expires" CONTENT="Wed, 02 Oct 2002 11:42:13">
</HEAD><BODY>
<!-- (C) IBM Corporation 2000. All Rights Reserved -->
<BODY bgcolor="ffffff">
<!-- End Header Records ============================================ -->
<A NAME="Top_Of_Page"></A>
<H1>Administration Guide</H1>
<HR><P ALIGN="center"> <A HREF="../index.htm"><IMG SRC="../books.gif" BORDER="0" ALT="[Return to Library]"></A> <A HREF="auagd002.htm#ToC"><IMG SRC="../toc.gif" BORDER="0" ALT="[Contents]"></A> <A HREF="auagd024.htm"><IMG SRC="../prev.gif" BORDER="0" ALT="[Previous Topic]"></A> <A HREF="#Bot_Of_Page"><IMG SRC="../bot.gif" BORDER="0" ALT="[Bottom of Topic]"></A> <A HREF="auagd026.htm"><IMG SRC="../next.gif" BORDER="0" ALT="[Next Topic]"></A> <A HREF="auagd026.htm#HDRINDEX"><IMG SRC="../index.gif" BORDER="0" ALT="[Index]"></A> <P>
<HR><H1><A NAME="HDRWQ620" HREF="auagd002.htm#ToC_715">Appendix D. AIX Audit Events</A></H1>
<P>This Appendix provides a complete listing of the AFS events
that can be audited on AIX file server machines. See Chapter <A HREF="auagd013.htm#HDRWQ323">Monitoring and Auditing AFS Performance</A> for instructions on auditing AFS events on AIX file server
machines.
<A NAME="IDX8189"></A>
<HR><H2><A NAME="HDRWQ621" HREF="auagd002.htm#ToC_716">Introduction</A></H2>
<P>Below is a list of the AFS events contained in the file
<B>/afs/usr/local/audit/events.sample</B>. Each entry
contains information on the event class, the name of the event, the parameters
associated with the event, and a description of the event.
<P>Most events have an associated error code that shows the outcome of the
event (since each event is recorded after it occurs), an AFSName (the
authentication identify of the requesting process), and a host ID (from which
the request originated). Many events follow the RPC server entry calls
defined in the <I>AFS Programmer's Reference Manual</I>.
<P>Events are classed by functionality (this is AIX specific). Some
events possibly fall into one of more of the following classes which are
defined by the file <B>/usr/afs/local/config.sample</B>:
<UL>
<P><LI>A (afsauthent): Authentication and Identification Events
<P><LI>S (afssecurity): Security Events
<P><LI>P (afsprivilege): Privilege Required Events
<P><LI>O (afsobjects): Object Creation and Deletion Events
<P><LI>M (afsattributes): Attribute modification
<P><LI>C (afsprocess): Process Control Events
</UL>
<HR><H2><A NAME="HDRWQ622" HREF="auagd002.htm#ToC_717">Audit-Specific Events</A></H2>
<BR>
<TABLE WIDTH="100%" BORDER>
<TR>
<TH ALIGN="LEFT" VALIGN="BOTTOM" WIDTH="28%"><B>Event</B>
</TH><TH ALIGN="LEFT" VALIGN="BOTTOM" WIDTH="10%"><B>Class</B>
</TH><TH ALIGN="LEFT" VALIGN="BOTTOM" WIDTH="25%"><B>Parameters</B>
</TH><TH ALIGN="LEFT" VALIGN="BOTTOM" WIDTH="38%"><B>Description</B>
</TH></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_Audit_WR
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">None
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">&lt;string>
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">The file "/usr/afs/Audit" has been written to (AIX specific
event).
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_Aud_On
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">S
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">Auditing is on for this server process (recorded on startup of a
server).
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_Aud_Off
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">S
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">Auditing is off for this server process (recorded on startup of a
server).
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_Aud_Unauth
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">S
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode Event
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">Event triggered by an unauthorized user.
</TD></TR></TABLE>
<TABLE><TR><TD ALIGN="LEFT" VALIGN="TOP"><B>Note:</B></TD><TD ALIGN="LEFT" VALIGN="TOP">The following audit-specific events indicate an error has occurred while
recording the event. Most events have an AFSName associated with them
and a host ID. If this information cannot be gathered out of the Rx
structure, one of these events is raised.
</TD></TR></TABLE>
<BR>
<TABLE WIDTH="100%" BORDER>
<TR>
<TH ALIGN="LEFT" VALIGN="BOTTOM" WIDTH="28%"><B>Event</B>
</TH><TH ALIGN="LEFT" VALIGN="BOTTOM" WIDTH="10%"><B>Class</B>
</TH><TH ALIGN="LEFT" VALIGN="BOTTOM" WIDTH="25%"><B>Parameters</B>
</TH><TH ALIGN="LEFT" VALIGN="BOTTOM" WIDTH="38%"><B>Description</B>
</TH></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_Aud_NoCall
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">S
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode Event
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">No rx call structure with this event. Cannot get security, AFS ID,
or origin of call.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_Aud_NoConn
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">S
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode Event
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">No connection info associated with rx call. Cannot get security,
AFS ID, or origin of call.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_Aud_UnknSec
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">S
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode Event
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">Security of call is unknown (must be authorized or unauthorized
caller).
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_Aud_NoAFSId
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">S
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode Event
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">No AFS ID/name associated with a secure event.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_Aud_NoHost
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">S
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode Event
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">No information about origin (machine) of caller.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_Aud_EINVAL
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">None
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">Event
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">Error in audit event parameter (can't record the event
parameter).
</TD></TR></TABLE>
<HR><H2><A NAME="HDRWQ627" HREF="auagd002.htm#ToC_718">Volume Server Events</A></H2>
<BR>
<TABLE WIDTH="100%" BORDER>
<TR>
<TH ALIGN="LEFT" VALIGN="BOTTOM" WIDTH="28%"><B>Event</B>
</TH><TH ALIGN="LEFT" VALIGN="BOTTOM" WIDTH="10%"><B>Class</B>
</TH><TH ALIGN="LEFT" VALIGN="BOTTOM" WIDTH="25%"><B>Parameters</B>
</TH><TH ALIGN="LEFT" VALIGN="BOTTOM" WIDTH="38%"><B>Description</B>
</TH></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_VS_Start
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">P C
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">The volume server has started.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_VS_Finish
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">C
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">The volume server has finished. Finish events are rare since the
server process is normally aborted.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_VS_Exit
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">C
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">The volume server has exited. Exit events are rare since the
server process is normally aborted.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_VS_TransCr
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">None
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID Trans VolID
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">AFSVolTransCreate - Create transaction for a [volume, partition]
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_VS_EndTrn
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">None
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID Trans
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">AFSVolEndTrans - End a transaction.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_VS_CrVol
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">P O
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID Trans VolID VolName Type ParentID
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">AFSVolCreateVolume - Create a volume (volumeId volumeName)
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_VS_DelVol
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">P O
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID Trans
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">AFSVolDeleteVolume - Delete a volume.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_VS_NukVol
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">P O
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID VolID
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">AFSVolNukeVolume - Obliterate a volume completely (volume ID).
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_VS_Dump
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">None
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID Trans
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">AFSVolDump - Dump the contents of a volume.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_VS_SigRst
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">P M
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID VolName
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">AFSVolSignalRestore - Show intention to call AFSVolRestore.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_VS_Restore
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">P O
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID Trans
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">AFSVolRestore - Recreate a volume from a dump.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_VS_Forward
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">P O
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID FromTrans Host DestTrans
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">AFSVolForward - Dump a volume, then restore to a given server and
volume.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_VS_Clone
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">P O
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID Trans Purge NewName NewType NewVolID
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">AFSVolClone - Clone (and optionally purge) a volume.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_VS_ReClone
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">P O
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID Trans CloneVolID
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">AFSVolReClone - Reclone a volume.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_VS_SetForw
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">P M
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID Trans NewHost
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">AFSVolSetForwarding - Set forwarding information for a moved
volume.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_VS_GetFlgs
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">None
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID Trans
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">AFSVolGetFlags - Get volume flags for a transaction.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_VS_SetFlgs
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">P M
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID Trans Flags
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">AFSVolSetFlags - Set volume flags for a transaction.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_VS_GetName
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">None
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID Trans
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">AFSVolGetName - Get the volume name associated with a transaction.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_VS_GetStat
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">None
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID Trans
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">AFSVolGetStatus - Get status of a transaction/volume.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_VS_SetIdTy
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">P M
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID Trans VolName Type ParentId CloneID BackupID
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">AFSVolSetIdsTypes - Set header information for a volume.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_VS_SetDate
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">P M
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID Trans Date
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">AFSVolSetDate - Set creation date in a volume.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_VS_ListPar
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">None
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">AFSVolListPartitions - Return a list of AFS partitions on a
server.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_VS_ParInf
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">None
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID PartName
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">AFSVolPartitionInfo - Get partition information.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_VS_ListVol
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">None
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">AFSVolListVolumes - Return a list of volumes on a server.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_VS_XLstVol
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">None
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">AFSVolXListVolumes - Return a (detailed) list of volumes on a
server.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_VS_Lst1Vol
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">None
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID VolID
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">AFSVolListOneVolume - Return header information for a single
volume.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_VS_XLst1Vl
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">None
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID VolID
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">AFSVolXListOneVolume - Return (detailed) header information for a single
volume.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_VS_GetNVol
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">None
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID VolID
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">AFSVolGetNthVolume - Get volume header given its index.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_VS_Monitor
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">None
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">AFSVolMonitor - Collect server transaction state.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_VS_SetInfo
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">P O M
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID Trans
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">AFSVolSetInfo - Set volume status.
</TD></TR></TABLE>
<HR><H2><A NAME="HDRWQ630" HREF="auagd002.htm#ToC_719">Backup Server Events</A></H2>
<BR>
<TABLE WIDTH="100%" BORDER>
<TR>
<TH ALIGN="LEFT" VALIGN="BOTTOM" WIDTH="28%"><B>Event</B>
</TH><TH ALIGN="LEFT" VALIGN="BOTTOM" WIDTH="10%"><B>Class</B>
</TH><TH ALIGN="LEFT" VALIGN="BOTTOM" WIDTH="25%"><B>Parameters</B>
</TH><TH ALIGN="LEFT" VALIGN="BOTTOM" WIDTH="38%"><B>Description</B>
</TH></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_BUDB_Start
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">P
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">The backup server has started.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_BUDB_Finish
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">None
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">The backup server has finished. Finish events are rare since the
server process is normally aborted.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_BUDB_Exit
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">None
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">The backup server has exited. Exit events are rare since the
server process is normally aborted.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_BUDB_CrDmp
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">P O
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID dumpId
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">BUDB_CreateDump - Create a new dump.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_BUDB_AppDmp
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">P
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID dumpId
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">BUDB_makeDumpAppended - Make the dump an appended dump.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_BUDB_DelDmp
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">P O
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID dumpId
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">BUDB_DeleteDump - Delete a dump.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_BUDB_FinDmp
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">P
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID dumpId
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">BUDB_FinishDump- Notify buserver that dump is finished.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_BUDB_UseTpe
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">P M
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID dumpId
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">BUDB_UseTape - Create/add a tape entry to a dump.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_BUDB_DelTpe
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">P M
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID dumpId
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">BUDB_DeleteTape - Remove a tape from the database.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_BUDB_FinTpe
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">P
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID dumpId
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">BUDB_FinishTape - Writing to a tape is completed.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_BUDB_AddVol
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">P M
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID volId
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">BUDB_AddVolume - Add a volume to a particular dump and tape.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_BUDB_GetTxV
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">None
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID Type
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">BUDB_GetTextVersion - Get the version number for
hosts/volume-sets/dump-hierarchy.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_BUDB_GetTxt
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">P
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID Type
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">BUDB_GetText - Get the information about
hosts/volume-sets/dump-hierarchy.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_BUDB_SavTxt
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">M
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID Type
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">BUDB_SaveText - Overwrite the information about
hosts/volume-sets/dump-hierarchy.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_BUDB_GetLck
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">None
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">BUDB_GetLock - Take a lock for reading/writing text information.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_BUDB_FrALck
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">None
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">BUDB_FreeLock - Free a lock.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_BUDB_FreLck
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">None
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">BUDB_FreeAllLocks - Free all locks.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_BUDB_GetIId
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">None
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">BUDB_GetInstanceId - Get lock instance id.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_BUDB_DmpDB
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">None
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">BUDB_DumpDB - Start dumping the database.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_BUDB_RstDBH
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">None
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">BUDB_RestoreDbHeader - Restore the database header.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_BUDB_DBVfy
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">None
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">BUDB_DbVerify - Verify the database.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_BUDB_FndDmp
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">P
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID volName
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">BUDB_FindDump - Find the dump a volume belongs to.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_BUDB_GetDmp
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">P
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">BUDB_GetDumps - Get a list of dumps in the database.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_BUDB_FnLTpe
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">P
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID dumpId
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">BUDB_FindLastTape - Find last tape, and last volume on tape of a
dump.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_BUDB_GetTpe
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">P
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">BUDB_GetTapes - Find a list of tapes based on name or dump ID.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_BUDB_GetVol
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">P
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">BUDB_GetVolumes - Find a list of volumes based on dump or tape
name.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_BUDB_DelVDP
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">P M
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID dumpSetName
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">BUDB_DeleteVDP - Delete dumps with given name and dump path.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_BUDB_FndCln
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">P M
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID volName
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">BUDB_FindClone - Find clone time of volume.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_BUDB_FndLaD
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">P
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID volName
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">BUDB_FindLatestDump - Find the latest dump a volume belongs to.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_BUDB_TGetVr
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">None
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">BUDB_T_GetVersion - Test Get version.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_BUDB_TDmpHa
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">P
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID file
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">BUDB_T_DumpHashTable - Test dump of hash table.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_BUDB_TDmpDB
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">P
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID file
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">BUDB_T_DumpDatabase - Test dump of database.
</TD></TR></TABLE>
<HR><H2><A NAME="HDRWQ633" HREF="auagd002.htm#ToC_720">Protection Server Events</A></H2>
<BR>
<TABLE WIDTH="100%" BORDER>
<TR>
<TH ALIGN="LEFT" VALIGN="BOTTOM" WIDTH="28%"><B>Event</B>
</TH><TH ALIGN="LEFT" VALIGN="BOTTOM" WIDTH="10%"><B>Class</B>
</TH><TH ALIGN="LEFT" VALIGN="BOTTOM" WIDTH="25%"><B>Parameters</B>
</TH><TH ALIGN="LEFT" VALIGN="BOTTOM" WIDTH="38%"><B>Description</B>
</TH></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_PTS_Start
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">P
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">The protection server has started.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_PTS_Finish
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">C
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">The protection server has finished. Finish events are rare since
the server process is normally aborted.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_PTS_Exit
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">C
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">The protection server has exited. Exit events are rare since the
server process is normally aborted.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_PTS_NmToId
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">None
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">PR_NameToID - Perform one or more name-to-ID translations.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_PTS_IdToNm
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">None
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID GroupId
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">PR_IDToName - Perform one or more ID-to-name translations.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_PTS_NewEnt
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">None
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID GroupId Name OwnerId
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">PR_NewEntry - Create a PDB (Protection DataBase) entry for the given
name.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_PTS_INewEnt
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">None
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID GroupId Name OwnerId
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">PR_INewEntry - Create a PDB entry for the given name and ID.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_PTS_LstEnt
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">None
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID GroupId
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">PR_ListEntry - Get the contents of a PDB entry based on its ID.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_PTS_DmpEnt
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">None
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID Position
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">PR_DumpEntry - Get the contents of a PDB entry based on its
offset.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_PTS_ChgEnt
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">None
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID GroupId NewName NewOwnerId NewId
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">PR_ChangeEntry - Change an existing PDB entry's ID, name, owner, or
a combination.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_PTS_SetFEnt
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">None
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID GroupId
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">PR_SetFieldsEntry - Change miscellaneous fields in an existing PDB
entry.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_PTS_Del
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">None
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID GroupId
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">PR_Delete - Delete an existing PDB entry.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">FS_PTS_WheIsIt
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">None
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID GroupId Position
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">PR_WhereIsIt - Get the PDB byte offset of the entry for a given
ID.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_PTS_AdToGrp
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">None
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID GroupId UserId
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">PR_AddToGroup - Add a user to a group.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_PTS_RmFmGrp
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">None
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID GroupId UserId
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">PR_RemoveFromGroup - Remove a user from a chosen group.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_PTS_LstMax
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">None
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">PR_ListMax - Get the largest allocated user and group ID.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_PTS_SetMax
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">None
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID GroupId flag
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">PR_SetMax - Set the largest allocated user and group ID.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_PTS_LstEle
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">None
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID GroupId
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">PR_ListElements - List all IDs associated with a user or group.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_PTS_GetCPS
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">None
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID GroupId
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">PR_GetCPS - Get the CPS (Current Protection Subdomain) for the given
ID.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_PTS_GetCPS2
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">None
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID GroupId Host
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">PR_GetCPS2 - Get the CPS for the given id and host.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_PTS_GetHCPS
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">None
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID Host
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">PR_GetHostCPS - Get the CPS for the given host.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_PTS_LstOwn
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">None
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID GroupId
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">PR_ListOwned - Get all IDs owned by the given ID.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_PTS_IsMemOf
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">None
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID UserId GroupId
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">PR_IsAMemberOf - Is a given user ID a member of a specified group?
</TD></TR></TABLE>
<HR><H2><A NAME="HDRWQ636" HREF="auagd002.htm#ToC_721">Authentication Events</A></H2>
<BR>
<TABLE WIDTH="100%" BORDER>
<TR>
<TH ALIGN="LEFT" VALIGN="BOTTOM" WIDTH="28%"><B>Event</B>
</TH><TH ALIGN="LEFT" VALIGN="BOTTOM" WIDTH="10%"><B>Class</B>
</TH><TH ALIGN="LEFT" VALIGN="BOTTOM" WIDTH="25%"><B>Parameters</B>
</TH><TH ALIGN="LEFT" VALIGN="BOTTOM" WIDTH="38%"><B>Description</B>
</TH></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_KAA_ChPswd
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">S
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID name instance
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">KAA_ChangePassword - Change password.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_KAA_Auth
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">A S
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID name instance
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">KAA_Authenticate - Authenticate to the cell.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_KAA_AuthO
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">S
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID name instance
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">KAA_Authenticate_old - Old style authentication.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_KAT_GetTkt
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">A S
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID name instance
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">KAT_GetTicket - An attempt was made to get an AFS ticket for some
principal listed in the Authentication Database.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_KAT_GetTktO
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">S
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID name instance
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">KAT_GetTicket_old - An attempt was made to get an AFS ticket for some
principal listed in the Authentication Database.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_KAM_CrUser
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">S P
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID name instance
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">KAM_CreateUser - Create a user.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_KAM_DelUser
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">S P
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID name instance
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">KAM_DeleteUser - Delete a user.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_KAM_SetPswd
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">S
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID name instance
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">KAM_SetPassword - Set the password for a user.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_KAM_GetPswd
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">S
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID name
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">KAM_GetPassword - Get the password of a user.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_KAM_GetEnt
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">S
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID name instance
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">KAM_GetEntry - The RPC made by the <B>kas examine</B> command to get
one entry from the Authentication Database (by index entry).
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_KAM_LstEnt
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">S
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID index
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">KAM_ListEntry - The RPC made to list one or more entries in the
Authentication Database.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_KAM_Dbg
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">S
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">KAM_Debug - The RPC that produces a debugging trace for the
Authentication Server.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_KAM_SetFld
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">S P
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID name instance flags date lifetime maxAssoc
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">KAM_SetFields - The RPC used by the <B>kas setfields</B> command to
manipulate the Authentication Database.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_KAM_GetStat
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">S
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">KAM_GetStatus - An RPC used to get statistics on the Authentication
Server.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_KAM_GRnKey
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">S
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">KAM_GetRandomKey - An RPC used to generate a random encryption
key.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_UnlockUser
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">S
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID name instance
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">KAM_Unlock - The RPC used to initiate the <B>kas unlock</B>
command.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_LockStatus
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">None
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID name instance
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">KAM_LockStatus - The RPC used to determine whether a user's
Authentication Database entry is locked.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_UseOfPriv
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">P
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID name instance cell
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">An authorized command was issued and allowed because the user had
privilege.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_UnAth
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">S
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID name instance cell
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">An authorized command was issued and allowed because the system was
running in noauth mode.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_UDPAuth
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">A S
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode name instance
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">An authentication attempt was made with a Kerberos client.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_UDPGetTckt
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">A S
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode name instance cell name instance
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">An attempt was made to get a Kerberos ticket.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_RunNoAuth
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">S
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">Check was made and some random server is running noauth.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_NoAuthDsbl
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">S P
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">Server is set to run in authenticated mode.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_NoAuthEnbl
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">S P
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">Server is set to run in unauthenticated mode.
</TD></TR></TABLE>
<HR><H2><A NAME="HDRWQ639" HREF="auagd002.htm#ToC_722">File Server and Cache Manager Interface Events</A></H2>
<BR>
<TABLE WIDTH="100%" BORDER>
<TR>
<TH ALIGN="LEFT" VALIGN="BOTTOM" WIDTH="28%"><B>Event</B>
</TH><TH ALIGN="LEFT" VALIGN="BOTTOM" WIDTH="10%"><B>Class</B>
</TH><TH ALIGN="LEFT" VALIGN="BOTTOM" WIDTH="25%"><B>Parameters</B>
</TH><TH ALIGN="LEFT" VALIGN="BOTTOM" WIDTH="38%"><B>Description</B>
</TH></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_SRX_FchACL
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">None
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID (FID)
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">RXAFS_FetchACL - Fetch the ACL associated with the given AFS file
identifier.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_SRX_FchStat
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">None
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID (FID)
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">RXAFS_FetchStatus - Fetch the status information for a file system
object.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_SRX_StACL
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">M
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID (FID)
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">RXAFS_StoreACL - Associate an ACL with the names directory.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_SRX_StStat
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">M
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID (FID)
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">RXAFS_StoreStatus - Store status information for the specified
file.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_SRX_RmFile
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">O
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID (FID) name
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">RXAFS_RemoveFile - Delete the given file.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_SRX_CrFile
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">O
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID (FID) name
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">RXAFS_CreateFile - Create the given file.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_SRX_RNmFile
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">O M
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID (oldFID) oldName (newFID) newName
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">RXAFS_Rename - Rename the specified file in the given directory.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_SRX_SymLink
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">O
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID (FID) name
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">RXAFS_Symlink - Create a symbolic link.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_SRX_Link
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">O
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID (FID) name (FID)
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">RXAFS_Link - Create a hard link.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_SRX_MakeDir
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">O
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID (FID) name
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">RXAFS_MakeDir - Create a directory.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_SRX_RmDir
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">O
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID (FID) name
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">RXAFS_RemoveDir - Remove a directory.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_SRX_SetLock
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">None
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID (FID) type
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">RXAFS_SetLock - Set an advisory lock on the given file identifier.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_SRX_ExtLock
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">None
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID (FID)
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">RXAFS_ExtendLock - Extend an advisory lock on a file.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_SRX_RelLock
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">None
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID (FID)
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">RXAFS_ReleaseLock - Release the advisory lock on a file.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_SRX_FchData
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">None
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID (FID)
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">StartRXAFS_FetchData - Begin a request to fetch file data.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_SRX_StData
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">O
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID (FID)
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">StartRXAFS_StoreData - Begin a request to store file data.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_SRX_BFchSta
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">None
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID (FID)
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">RXAFS_BulkStatus - Fetch status information regarding a set of file
system objects.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_SRX_SetVolS
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">M
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID volId volName
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">RXAFS_SetVolumeStatus - Set the basic status information for the named
volume.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_Priv
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">P
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode viceId callRoutine
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">Checking Permission Rights of user - user has permissions.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_PrivSet
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">P
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode viceId callRoutine
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">Set the privileges of a user.
</TD></TR></TABLE>
<HR><H2><A NAME="HDRWQ642" HREF="auagd002.htm#ToC_723">BOS Server Events</A></H2>
<BR>
<TABLE WIDTH="100%" BORDER>
<TR>
<TH ALIGN="LEFT" VALIGN="BOTTOM" WIDTH="28%"><B>Event</B>
</TH><TH ALIGN="LEFT" VALIGN="BOTTOM" WIDTH="10%"><B>Class</B>
</TH><TH ALIGN="LEFT" VALIGN="BOTTOM" WIDTH="25%"><B>Parameters</B>
</TH><TH ALIGN="LEFT" VALIGN="BOTTOM" WIDTH="38%"><B>Description</B>
</TH></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_BOS_CreBnod
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">P C
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">BOZO_CreateBnode - Create a process instance.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_BOS_DelBnod
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">P C
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID instance
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">BOZO_DeleteBnode - Delete a process instance.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_BOS_SetReSt
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">P M C
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">BOZO_Restart - Restart a given process instance.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_BOS_GetLog
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">P
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">StartBOZO_GetLog - Pass the IN params when fetching a BOS Server log
file.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_BOS_SetStat
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">P M C
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID instance
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">BOZO_SetStatus - Set process instance status and goal.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_BOS_SetTSta
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">P M C
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID instance
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">BOZO_SetTStatus - Temporarily set process instance status and
goal.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_BOS_StartAl
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">P C
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">BOZO_StartupAll - Start all existing process instances.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_BOS_ShtdAll
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">P C
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">BOZO_ShutdownAll - Shut down all process instances.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_BOS_ReStAll
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">P C
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">BOZO_RestartAll - Shut down, then restart all process instances.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_BOS_ReBos
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">P C
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">BOZO_ReBozo - Shut down, then restart all process instances and the BOS
Server itself.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_BOS_ReBosIn
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">P C
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">BOZO_ReBozo - Same as AFS_BOS_ReBos but done internally (server
restarts).
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_BOS_ReStart
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">P C
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID instance
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">BOZO_Restart - Restart a given process instance.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_BOS_WaitAll
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">P C
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">BOZO_WaitAll - Wait until all process instances have reached their
goals.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_BOS_AddSUsr
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">S P
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">BOZO_AddSUser - Add a user to the UserList.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_BOS_DelSUsr
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">S P
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">BOZO_DeleteSUser - Delete a user from the UserList.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_BOS_LstSUsr
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">None
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">BOZO_ListSUsers - Get the name of the user in the given position in the
UserList file.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_BOS_LstKey
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">P
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">BOZO_ListKeys - List information about the key at a given index in the
key file.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_BOS_LstKeyU
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">P
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">BOZO_ListKeys - Same as AFS_BOS_LstKey, but unauthorized.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_BOS_AddKey
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">S P
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">BOZO_AddKey - Add a key to the key file.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_BOS_DelKey
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">S P
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">BOZO_DeleteKey - Delete the entry for an AFS key.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_BOS_SetNoAu
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">S P
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID flag
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">BOZO_SetNoAuthFlag - Enable or disable authenticated call
requirements.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_BOS_SetCell
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">S P
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID name
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">BOZO_SetCellName - Set the name of the cell to which the BOS Server
belongs.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_BOS_AddHst
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">S P
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID name
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">BOZO_AddCellHost - Add an entry to the list of database server
hosts.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_BOS_DelHst
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">S P
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID name
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">BOZO_DeleteCellHost - Delete an entry from the list of database server
hosts.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_BOS_Inst
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">P O M
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID name
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">
<P>StartBOZO_Install - Pass the IN parameters when installing a server
binary.
<P>EndBOZO_Install - Get the OUT parameters when installing a server
binary.
<BR></TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_BOS_UnInst
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">P O M
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID name
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">BOZO_UnInstall - Roll back from a server binary installation.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_BOS_PrnLog
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">P O
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">BOZO_Prune - Throw away old versions of server binaries and core
file.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_BOS_Exec
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">P C
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID cmd
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">BOZO_Exec - Execute a shell command at the server.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_BOS_DoExec
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">P C
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode exec
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">The <B>bosserver</B> process was restarted.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_BOS_StpProc
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">P C
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode cmd
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">An RPC to stop any process controlled by the BOS Server.
</TD></TR></TABLE>
<HR><H2><A NAME="HDRWQ645" HREF="auagd002.htm#ToC_724">Volume Location Server Events</A></H2>
<BR>
<TABLE WIDTH="100%" BORDER>
<TR>
<TH ALIGN="LEFT" VALIGN="BOTTOM" WIDTH="28%"><B>Event</B>
</TH><TH ALIGN="LEFT" VALIGN="BOTTOM" WIDTH="10%"><B>Class</B>
</TH><TH ALIGN="LEFT" VALIGN="BOTTOM" WIDTH="25%"><B>Parameters</B>
</TH><TH ALIGN="LEFT" VALIGN="BOTTOM" WIDTH="38%"><B>Description</B>
</TH></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_VL_CreEnt
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">P M
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID name
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">VL_CreateEntry - Create a VLDB entry.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_VL_DelEnt
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">P M
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID volID
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">VL_DeleteEntry - Delete a VLDB entry.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_VL_GetNVlID
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">None
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">VL_GetNewVolumeId - Generate a new volume ID.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_VL_RepEnt
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">P M
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID volID
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">VL_ReplaceEntry - Replace entire contents of VLDB entry.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_VL_UpdEnt
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">P M
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID volID
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">VL_UpdateEntry - Update contents of VLDB entry.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_VL_SetLck
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">P
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID volID
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">VL_SetLock - Lock VLDB entry.
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="28%">AFS_VL_RelLck
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="10%">P
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">ECode AFSName HostID volID
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="38%">VL_ReleaseLock - Unlock VLDB entry.
</TD></TR></TABLE>
<P>
<HR><P ALIGN="center"> <A HREF="../index.htm"><IMG SRC="../books.gif" BORDER="0" ALT="[Return to Library]"></A> <A HREF="auagd002.htm#ToC"><IMG SRC="../toc.gif" BORDER="0" ALT="[Contents]"></A> <A HREF="auagd024.htm"><IMG SRC="../prev.gif" BORDER="0" ALT="[Previous Topic]"></A> <A HREF="#Top_Of_Page"><IMG SRC="../top.gif" BORDER="0" ALT="[Top of Topic]"></A> <A HREF="auagd026.htm"><IMG SRC="../next.gif" BORDER="0" ALT="[Next Topic]"></A> <A HREF="auagd026.htm#HDRINDEX"><IMG SRC="../index.gif" BORDER="0" ALT="[Index]"></A> <P>
<!-- Begin Footer Records ========================================== -->
<P><HR><B>
<br>&#169; <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A> All Rights Reserved
</B>
<!-- End Footer Records ============================================ -->
<A NAME="Bot_Of_Page"></A>
</BODY></HTML>
Reference in New Issue View Git Blame Copy Permalink