Managing Databases

Once the user performs a successful Session Logon, the session handle can be used to operate on databases.

Every time a new database is created, or an existing database is added to a session, the database properties such as database name and path are placed in an entry of the database dictionary file.

Every time a user activates a database by connecting using ctdbConnect(), the handle of that database is placed in a list of active (connected) databases within the session handle. When a database is deactivated or disconnected by ctdbDisconnect(), the database handle is removed from the list of active databases. A user may query the active database list by locating the first active database, the next active database, or finding a specific active database.