---
name: "ost_DSO"
section: "3"
platform: "linux"
package: "libcommoncpp2-doc"
version: "1.8.1-10"
release: "Debian 11 (Bullseye)"
platforms: ["linux"]
url: "https://new.carta.tech/ost_DSO"
---

# ost\_DSO(3)

The DSO dynamic loader class is used to load object files.

## NAME

ost::DSO - The **DSO** dynamic loader class is used to load object files.

## SYNOPSIS

`#include <file.h>`

### Public Member Functions

**DSO** (const char \*filename)\
 Construct and load a **DSO** object file.  **DSO** (const char \*filename, bool resolve)\
 const char \* **getError** (void)\
 Retrieve error indicator associated with **DSO** failure.  virtual **~DSO** ()\
 Detach a **DSO** object from running memory.  void \* **operator\[\]** (const char \*sym)\
 Lookup a symbol in the loaded file.  bool **isValid** (void)\
 See if **DSO** object is valid.

### Static Public Member Functions

static void **dynunload** (void)\
 static **DSO** \* **getObject** (const char \*name)\
 Find a specific **DSO** object by filename.  static void **setDebug** (void)\
 Install debug handler...

## Detailed Description

The **DSO** dynamic loader class is used to load object files.

On elf based systems this is typically done with dlopen. A dummy stub class is generated for non-dl capable systems.

**Author**

David Sugar dyfet@ostel.com

Dynamic class file loader.

## Constructor & Destructor Documentation

### ost::DSO::DSO (const char \* filename)` [inline]`

Construct and load a **DSO** object file.

**Parameters**

*filename* pathname of object file to load.

### ost::DSO::DSO (const char \* filename, bool resolve)` [inline]`

### virtual ost::DSO::~DSO ()` [virtual]`

Detach a **DSO** object from running memory.

## Member Function Documentation

### static void ost::DSO::dynunload (void)` [static]`

### const char\* ost::DSO::getError (void)` [inline]`

Retrieve error indicator associated with **DSO** failure. This is often used in catch handlers.

### static DSO\* ost::DSO::getObject (const char \* name)` [static]`

Find a specific **DSO** object by filename.

**Parameters**

*name* of **DSO** object file (partial).

### bool ost::DSO::isValid (void)

See if **DSO** object is valid.

**Returns**

true if valid.

### void\* ost::DSO::operator\[\] (const char \* sym)

Lookup a symbol in the loaded file.

### static void ost::DSO::setDebug (void)` [static]`

Install debug handler...

## Author

Generated automatically by Doxygen for GNU CommonC++ from the source code.