---
name: "ACE_TSS_Guard"
section: "3"
platform: "linux"
package: "libace-doc"
version: "5.0.7-4"
release: "Debian 2.2 (Potato)"
platforms: ["linux"]
url: "https://new.carta.tech/ACE_TSS_Guard"
---

# ACE\_TSS\_Guard(3)

This data structure is meant to be used within a method or function... It performs automatic aquisition and release of a synchronization object. Moreover, it ensures that the lock is released even if a thread exits via thr\_exit!

## NAME

ACE\_TSS\_Guard -  This data structure is meant to be used within a method or function...  It performs automatic aquisition and release of a synchronization object.  Moreover, it ensures that the lock is released even if a thread exits via thr\_exit!

## SYNOPSIS

```
#include <ace/Synch_T.h>
template<class ACE_LOCK>
class ACE_TSS_Guard
{
  public:
    ACE_TSS_Guard (ACE_LOCK &lock, int block = 1);
    ~ACE_TSS_Guard (void);
    int acquire (void);
    int tryacquire (void);
    int release (void);
    int remove (void);
    void dump (void) const;
  protected:
    ACE_TSS_Guard (void);
    void init_key (void);
    static void cleanup (void *ptr);
    ACE_thread_key_t key_;
  private:
    inline ACE_UNIMPLEMENTED_FUNC (
        void operator= (const ACE_TSS_Guard<ACE_LOCK> &)
        );
};
```

## Initialization and termination methods.

```
ACE_TSS_Guard (ACE_LOCK &lock, int block = 1);
```

Implicitly and automatically acquire the thread-specific lock.

```
~ACE_TSS_Guard (void);
```

Implicitly release the thread-specific lock.

## Lock accessors.

```
int acquire (void);
```

Explicitly acquire the thread-specific lock.

```
int tryacquire (void);
```

Conditionally acquire the thread-specific lock (i.e., won't block).

```
int release (void);
```

Explicitly release the thread-specific lock.

## Utility methods.

```
int remove (void);
```

Explicitly release the thread-specific lock.

```
void dump (void) const;
```

Dump the state of an object.

ACE\_ALLOC\_HOOK\_DECLARE; Declare the dynamic allocation hooks.

## Prevent assignment and initialization.

```
inline ACE_UNIMPLEMENTED_FUNC (
    void operator= (const ACE_TSS_Guard<ACE_LOCK> &)
    );
```

## AUTHOR

Doug Schmidt

## LIBRARY

ace