acfsutil info fs

Purpose

Displays detailed Oracle ACFS file system information.

Syntax and Description

acfsutil info fs -h
acfsutil info fs [ {-o item | -s [interval [count]
                 [-d] ] | -f [-v] } ] [mount_point]

acfsutil info fs -h displays help text and exits.

Table 16-89 contains the options available with the acfsutil info fs command.


Table 16-89 Options for the acfsutil info fs command

Option Description

-o

Displays the specific file system item from the following list:

  • freespace - Amount of free space available in the file system

  • totalspace - Size of the file system

  • mountpoints - Mount points associated with file systems.

  • volumes - Number of volumes associated with the file system

  • primaryvolume - Path name of the device associated with file system

  • available - Length of time the file system has been available

  • isadvm - 1 if an Oracle ADVM volume is present, 0 if not

  • ismountpoint - 1 if path is the mount point, 0 if path is not a mount point

  • isavailable - 1 if the file system is available, 0 if file system is not available

  • iscorrupt - 1 if the file system is corrupt, 0 if file system is not corrupt

  • isreplprimary - 1 if primary file system, 0 if not

  • isreplstandby - 1 if standby file system, 0 if not

  • diskgroup - Name of the disk group associated with path

  • redundancy - Type of redundancy used by the Oracle ADVM volume

  • replication - 1 if file system has been initialized for replication as the primary or standby file system, 0 if not initialized for replication

  • resizeincrement - Allocation unit size in bytes of the Oracle ADVM volume used by path

  • stripewidth - Stripe width for the Oracle ADVM volume used by path

  • stripecolumns - Stripe set columns for the Oracle ADVM volume used by path

  • fetasize - File entry table size which is the amount of storage consumed by the on disk metadata for inodes

-s [interval [count] [-d]]

Displays file system statistics.

The optional interval parameter specifies the amount of time in seconds between each report. The first report contains statistics for the time since the file system mount. Each subsequent report contains statistics collected during the interval since the previous report.

The optional count parameter can be specified with the interval parameter. If the count parameter is specified, the value of count determines the number of reports generated at interval seconds apart.

If the interval parameter is specified without the count parameter, the command generates reports continuously until you break out of the command with Ctrl+c.

The optional -d option displays more detailed statistical information.

-f [-v]

Displays file system fragmentation. The -v option displays additional fragmentation information.

mount_point

Specifies the directory where the file system is mounted. Not a valid option for replication data.


acfsutil info fs displays information and statistics about Oracle ACFS file systems. If replication has been initiated on a file system, additional flags and status information are displayed. The values for the replication status field are primary, standby, or disabled.

The -o item option displays file system information for the item specified.

The -s option displays the amount and rate of change currently on a file system for the node that the command is run on.

With no option specified, the command displays file system information that includes the volume device name, the size of the file system, the amount of space available on the volume device, the file system mount time on this node, the state of the file system, the user specified block size, the number of Oracle ACFS snapshots, the space consumed by snapshots in the file system, and the optional name or volume label associated with the file system. The possible file system states are displayed in the flags line. These states include:

  • Offline indicates that the underlying devices are not accessible, possibly due to an Oracle ASM instance failure, disk group forced dismount, or an irrecoverable I/O error. The file system on this node can only be dismounted. All other attempts at access result in errors.

  • Available indicates that the file system is on line and operational.

  • Corrupt indicates that the file system should be checked and repaired at the earliest possible convenience to correct a detected inconsistency. For example, run the fsck command on Linux or the acfschkdsk command on Windows to check and repair the file system. Ensure that you run the command in repair mode to correct the problem. For more information, refer to "fsck" and "acfschkdsk".

When viewing space usage values with acfsutil info fs on Windows systems, the values may differ from sizes in Windows folders. The mechanism used by Folder Properties on Windows systems only accounts for files and should be considered an approximate value.

Any user can run acfsutil info fs.

Examples

The following are examples of the use of acfsutil info fs.

Example 16-80 displays information about an Oracle ACFS file system in a Linux environment.

Example 16-80 Using the acfsutil info fs command on Linux

$ /sbin/acfsutil info fs
/primary
    ACFS Version: 11.2.0.2.0
    flags:        MountPoint,Available,Replication
    mount time:   Mon Oct 25 12:11:03 2010
    volumes:      1
    total size:   5368709120
    total free:   4144230400
    primary volume: /dev/asm/pvol-74
        label:
        flags:                 Primary,Available,ADVM
        on-disk version:       40.0
        allocation unit:       4096
        major, minor:          252, 37889
        size:                  5368709120
        free:                  4144230400
        ADVM diskgroup         REPLDG
        ADVM resize increment: 268435456
        ADVM redundancy:       unprotected
        ADVM stripe columns:   4
        ADVM stripe width:     131072
    number of snapshots:  0
    snapshot space usage: 0
    replication status: primary

/standby
    ACFS Version: 11.2.0.2.0
    flags:        MountPoint,Available,Replication
    mount time:   Mon Oct 25 12:11:03 2010
    volumes:      1
    total size:   5368709120
    total free:   5263945728
    primary volume: /dev/asm/svol-74
        label:
        flags:                 Primary,Available,ADVM
        on-disk version:       40.0
        allocation unit:       4096
        major, minor:          252, 37890
        size:                  5368709120
        free:                  5263945728
        ADVM diskgroup         REPLDG
        ADVM resize increment: 268435456
        ADVM redundancy:       unprotected
        ADVM stripe columns:   4
        ADVM stripe width:     131072
    number of snapshots:  0
    snapshot space usage: 0
    replication status: standby

$ /sbin/acfsutil info fs -o mountpoints,replication
/primary
1
/standby
1

$ /sbin/acfsutil info fs -o mountpoints,isreplprimary
/primary
1
/standby
0

$ /sbin/acfsutil info fs -o mountpoints,isreplstandby
/primary
0
/standby
1

Example 16-81 illustrates the use of acfsutil info fs in a Windows environment.

Example 16-81 Using the acfsutil info fs command on Windows

C:\oracle>acfsutil info fs /o freespace c:\oracle\acfsmounts\acfs1
968667136

C:\oracle>acfsutil info fs /o totalspace c:\oracle\acfsmounts\acfs1
1073741824

C:\oracle>acfsutil info fs /o volume c:\oracle\acfsmounts\acfs1
1

C:\oracle>acfsutil info fs /o primaryvolume c:\oracle\acfsmounts\acfs1
asm-volume1-311

C:\oracle>acfsutil info fs /o diskgroup c:\oracle\acfsmounts\acfs1
DATA

C:\oracle>acfsutil info fs /o redundancy c:\oracle\acfsmounts\acfs1
mirror

Example 16-82 illustrates the use of acfsutil info fs with -s option to display the current amount and rate of change on a file system.

Example 16-82 Using the acfsutil info fs command with the -s option

$ /sbin/acfsutil info fs -s /acfsmounts/acfs1
    amount of change since mount:       359.22 MB
    average rate of change since mount: 3 KB

$ /sbin/acfsutil info fs -s 60 4 /acfsmounts/acfs1
    amount of change since mount:       359.22 MB
    average rate of change since mount: 3 KB/s

    amount of change: 15.02 MB   rate of change: 256 KB/s
    amount of change: 9.46 MB   rate of change: 161 KB/s
    amount of change: 7.32 MB   rate of change: 125 KB/s
    amount of change: 6.89 MB   rate of change: 117 KB/s
...