---
name: "fctl"
section: "1"
platform: "linux"
package: "lam-runtime"
version: "6.3.2-3"
release: "Debian 2.2 (Potato)"
platforms: ["linux"]
url: "https://new.carta.tech/fctl"
---

# fctl(1)

Control a LAM remote file daemon.

## NAME

fctl - Control a LAM remote file daemon.

## SYNTAX

fctl \[-hS\] \[-s \<descno\>\] \<nodes\> \[\<newdir\>\]

## OPTIONS

- **-h**

  Print the command help menu.

- **-S**

  Sweep out all but the standard filed descriptors.

- **-s \<descno\>**

  Sweep out the given filed descriptor.

- **\<nodes\>**

  Direct command to filed on these nodes.

- **\<newdir\>**

  Change to new working directory.

## DESCRIPTION

Most MPI users will probably not need to use the *fctl* command; see [lamclean(1)](/lamclean/1.md).

The *fctl* command controls important file daemon (filed) attributes and support features. With no options, *fctl* reports the current working directory that is prepended to all partial pathnames on rfopen(2). A file name on the command line becomes the new working directory.

Another important role of *fctl* is cleaning the debris that can form in filed in certain application crashes or bugs. Any file descriptor can be swept clean by indicating its handle (number) with the *-c* option. If desired, all descriptors, save stdio (0, 1, 2), can be cleaned and filed effectively reset with the *-S* option.

## EXAMPLE

- fctl h data/set1

  Change current working directory as indicated.

- fctl h -s 4

  Close and remove filed descriptor 4.

## SEE ALSO

[fstate(1)](/fstate/1.md), [lamclean(1)](/lamclean/1.md)