Command Reference Guide

Chapter 1: Matrix Server Commands 44

The options are:

-i <filename>

Create the PSFS command-line semaphore file <filename> and the

supplemental file <filename.pid> if either file does not already exist. It then

initializes the files to create the PSFS command-line semaphore. <filename>

must be a path on a PSFS filesystem.

-g <filename>

Lock the PSFS command-line semaphore associated with <filename>,

which is the name of a semaphore file created by psfssema -i. If the

semaphore is already locked by another node in the matrix, the calling

process blocks until the semaphore becomes available.

An error is returned if <filename> does not exist or has not been initialized

by psfssema -i, or if <filename.pid> does not exist.

-r <filename>

Unlock the PSFS command-line semaphore associated with <filename>,

which is the name of a semaphore file created by psfssema -i. If other

nodes are blocked on the semaphore when psfssema-r is called, one of the

blocked psfssema -g processes will return successfully.

-d <filename>

Delete the PSFS command-line semaphore associated with <filename>,

which is the name of a semaphore file created by psfssema -i. It also

deletes <filename> and <filename.pid>.

psfssuspend – suspend a PSFS filesystem

Synopsis

/opt/polyserve/tools/psfssuspend <directory_mountpoint>

Description

The psfssuspend utility suspends a PSFS filesystem in a stable, coherent, and

unchanging state. While the filesystem is in this state, you can copy it for

backup and/or archival purposes. When copying directly from a suspended

device, be sure to use the raw device (/dev/rpsd/...) to ensure that all blocks

copied are up-to-date.The filesystem is essentially unusable while it is

suspended; however, applications that can tolerate extended waits for I/O do

not need to be terminated.