Skip Navigation Links
Exit Print View
| Oracle Solaris Cluster Reference Manual Oracle Solaris Cluster 4.1

Search Scope:

- This Document
- Entire Library

### scds_timerun

- execute a given command in a given amount of time

### Synopsis

    cc [flags…] -I /usr/cluster/include file -L /usr/cluster/lib -l dsdev
    #include <rgm/libdsdev.h>

    scha_err_t scds_timerun(scds_handle_t handle, const char *command,
         time_t timeout, int signal, int *cmd_exit_code);

## Description

The `scds_timerun()` function executes a specified command using `hatimerun`(1M). If the command does not complete within the allotted time period, which is specified by the timeout argument, `scds_timerun()` sends a signal, specified by the signal argument, to kill it.

The command argument does not support I/O redirection. However, you can write a script to perform redirection and then identify this script in the command argument as the command for `scds_timerun()` to execute.

## Parameters

The following parameters are supported:

handle

  The handle returned from `scds_initialize`(3HA)

command

  String that contains the command to run

timeout

  Time, in seconds, allotted to run the command

signal

  Signal to kill the command if it is still running when the timeout expires. If `signal = -1`, then `SIGKILL` is used. See `signal`(3HEAD).

cmd_exit_code

  Return code from execution of the command

## Return Values

The `scds_timerun()` function returns the following:

`0`

  The function succeeded.

nonzero

  The function failed.

## Errors

`SCHA_ERR_NOERR`

  The command executed and `cmd_exit_code` contains the child program's exit status.

`SCHA_ERR_INTERNAL`

  The timeout did not occur, but some other error was detected by `scds_timerun()` that was not an error detected by the child program. Or `hatimerun`(1M) caught the signal `SIGTERM`.

`SCHA_ERR_INVAL`

  There was an invalid input argument.

`SCHA_ERR_TIMEOUT`

  The timeout occurred before the command specified by the command argument finished executing.

See `scha_calls`(3HA) for a description of other error codes.

## Files

`/usr/cluster/include/rgm/libdsdev.h`

  Include file

`/usr/cluster/lib/libdsdev.so`

  Library

## Attributes

See `attributes`(5) for descriptions of the following attributes:

ATTRIBUTE TYPE | ATTRIBUTE VALUE
--- | ---
Availability | ha-cluster/developer/api
Interface Stability | Evolving

## See Also

`hatimerun`(1M), `scds_initialize`(3HA), `scha_calls`(3HA), `signal`(3HEAD), `attributes`(5)

Copyright © 2000, 2012, Oracle and/or its affiliates. All rights reserved. Legal Notices |