---
name: "lfc_modreplicax"
section: "3"
platform: "linux"
package: "liblfc-dev"
version: "1.10.0-2+b3"
release: "Debian 10 (Buster)"
platforms: ["linux"]
url: "https://new.carta.tech/lfc_modreplicax"
---

# lfc\_modreplicax(3)

modify information about a given replica

## NAME

lfc\_modreplica - modify information about a given replica

## SYNOPSIS

**#include \<sys/types.h\>**\
 **#include "lfc\_api.h"**

**int lfc\_modreplica (const char \****sfn***,** **const char \****setname***,** **const char \****poolname***,** **const char \****server***)**

**int lfc\_modreplicax (const char \****sfn***,** **const char \****setname***,** **const char \****poolname***,** **const char \****server***,** **const char \****fs***,** **const char** *r\_type***)**

## DESCRIPTION

**lfc\_modreplica** modifies information about a given replica.

- *sfn*

  is either the Site URL or the Physical File Name for the replica.

- *setname*

  is either a replica set name or a space token.

- *server*

  is either the Storage Element fully qualified hostname or the disk server.

- *poolname*

  specifies the disk pool name (this argument is only meaningful for the Disk Pool Manager).

- **lfc\_modreplicax**

  is similar to **lfc\_modreplica** but has the additional arguments:

- *fs*

  specifies the mount point of the dedicated filesystem (this argument is only meaningful for the Disk Pool Manager).

- *r\_type*

  may be one of the following:

  - **P**

    Primary

  - **S**

    Secondary.

## RETURN VALUE

These routines return 0 if the operation was successful or -1 if the operation failed. In the latter case, **serrno** is set appropriately.

## ERRORS

- **ENOENT**

  The named replica does not exist.

- **EACCES**

  Search permission is denied on a component of the parent directory or the effective user ID does not match the owner of the file or read permission on the file entry itself is denied.

- **EFAULT**

  *sfn* is a NULL pointer.

- **EINVAL**

  The length of *setname* exceeds 36, the length of *poolname* exceeds **CA\_MAXPOOLNAMELEN** or the length of *server* exceeds **CA\_MAXHOSTNAMELEN**.

- **ENAMETOOLONG**

  The length of *sfn* exceeds **CA\_MAXSFNLEN**.

- **SENOSHOST**

  Host unknown.

- **SENOSSERV**

  Service unknown.

- **SECOMERR**

  Communication error.

- **ENSNACT**

  Name server is not running or is being shutdown.

## SEE ALSO

**[Castor\_limits(4)](/Castor_limits/4.md)**, **[lfc\_addreplica(3)](/lfc_addreplica/3.md)**, **[lfc\_listreplica(3)](/lfc_listreplica/3.md)**