mmafmlocal command

Provides a list of cached files and file statistics such as inode number, allocated blocks, and so on.

Synopsis

mmafmlocal ls [FileName ...]

mmafmlocal stat FileName ...

Availability

Available with IBM Spectrum Scale™ Standard Edition or higher. Available on AIX® and Linux.

Description

The mmafmlocal command provides information about files that exist in the cache.

Parameters

ls: Lists files with data that is in the cache already. This parameter is valid for fully-cached files only.
FileName: Specifies the name of a file to be listed.
stat: Displays statistics for files. If the file is not cached already, the number of allocated blocks is zero. This parameter is valid for partially-cached and fully-cached files.

Exit status

0: Successful completion.
nonzero: A failure has occurred.

Security

You must have root authority to run the mmafmlocal command.

The node on which the command is issued must be able to execute remote shell commands on any other node in the cluster without the use of a password and without producing any extraneous messages. For more information, see Requirements for administering a GPFS file system.

Examples

To list information of all the cached files in a fileset:
```
mmafmlocal ls
```
The system displays information similar to:
```
total 10240
-rwxrwxrwx 1 root root 10485760 May 24 09:20 file1
```
To list information of a specific cached file in a fileset:
```
mmafmlocal ls file2
```
The system displays information similar to:
```
-rwxrwxrwx 1 root root 10485760 May 24 09:20 file2
```

To list the file statistics:

mmafmlocal stat file2

The system displays information similar to:

File: file2
   Inode number:  1582477
   Device ID:     0x2C (44)
   Size:          10485760
   Blocks:        20480
   Block size:    262144
   Links:         1
   Uid:           0 (root)
   Gid:           0 (root)
   Mode:          0100777
   Access time:   1464281093 (Thu May 26 16:44:53 2016 UTC)
   Modify time:   1464096038 (Tue May 24 13:20:38 2016 UTC)
   Change time:   1464096038 (Tue May 24 13:20:38 2016 UTC)

Location

/usr/lpp/mmfs/bin