---
name: "sam_stop"
section: "3"
platform: "linux"
package: "libsam-dev"
version: "3.1.9-2+deb13u1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/sam_stop"
---

# sam\_stop(3)

Stop health checking

## NAME

sam\_stop - Stop health checking

## SYNOPSIS

**#include \<corosync/sam.h\>**

**cs\_error\_t sam\_stop (void);**

## DESCRIPTION

The **sam\_stop** function is used to stop health checking of an active process.  After calling this function, the application no longer should send helathchecks.  In the case of event driven healthchecking, the healthchecking thread will be stopped.

A process can always start health checking again by calling **[sam\_start(3)](/sam_start/3.md)** function.

## RETURN VALUE

This call return CS\_OK value if successful, otherwise and error is returned.

## ERRORS

- CS\_ERR\_BAD\_HANDLE

  health checking was not started by calling **[sam\_start(3)](/sam_start/3.md)** function.

## SEE ALSO

[**sam\_start**(3)](/sam_start/3.md)

**CS\_ERR\_TRY\_AGAIN** Resource temporarily unavailable

**CS\_ERR\_INVALID\_PARAM** Invalid argument

**CS\_ERR\_ACCESS** Permission denied

**CS\_ERR\_LIBRARY** The connection failed

**CS\_ERR\_INTERRUPT** System call interrupted by a signal

**CS\_ERR\_NOT\_SUPPORTED** The requested protocol/functionality not supported

**CS\_ERR\_MESSAGE\_ERROR** Incorrect auth message received

**CS\_ERR\_NO\_MEMORY** Not enough memory to complete the requested task