Solaris Systems Administrator’s Guide, Second Edition:Using Basic OS Commands

Finding the Section Number for a Manual Page (whatis, man)

Some commands are listed in more than one section. You can find the section number(s) for a manual page using the whatis command.

NOTE: The whatis command only works if you have used the catman command to set up your manual pages. To use the catman command to set up manual pages, become super user and type catman n and press Return, where n is the number of the section you want to set up.

Follow these steps to find the section number for a manual page:

1. Type whatis command-name and press Return. The first line of the manual page for the command is displayed. Use the section number to display the manual page in the next step.

2. Type man -ssection-number command-name and press Return. The manual page is displayed:

     oak% whatis chown
     chown   chown (1)    - change owner of file
     chown   chown (1b)   - change owner
     chown   chown (1m)   - change owner
     chown   chown (2)    - change owner and group of a file
     oak% man -s2 chown
     chown(2)               SYSTEM CALLS               chown(2)

    NAME
     chown, lchown, fchown - change owner and group of a file

    SYNOPSIS
     #include <unistd.h>
     #include <sys/types.h>

    int chown(const char *path, uid_t owner, gid_t group);

    int lchown(const char *path, uid_t owner, gid_t group);

    int fchown(int fildes, uid_towner, gid_t group);

    DESCRIPTION
    chown() sets the owner ID and group ID of the file specified by path
    or referenced by the open file descriptor fields to owner and group
    respectively. If owner or group is specified as -1, chown() does not
    change the corresponding ID of the file.

    (More text not shown here)

Finding Disk Information

Use the commands in the following sections to find disk use, and to tell if a file system is local (UFS) or remote (NFS).

Displaying Used Disk Space in Kilobytes and Percentage of Capacity (df- k)

The output from the df command, when used without arguments, is changed with the SunOS 5.x system software. Use the -k option to display disk information in the table format used with SunOS 4.x system software. Type df -k and press Return. The file system, total kilobytes, used kilobytes, available kilobytes, percentage of capacity used, and mount point for local disk partitions are displayed:

cinderella% df -k
dev/dsk/cØtØdØsØ     3Ø383    19926    7427       73%     /
/dev/dsk/cØtØdØs6    189683   665Ø3    1Ø422Ø     39%     /usr
/proc                Ø        Ø        Ø           Ø%     /proc
fd                   Ø        Ø        Ø           Ø%     /dev/fd
swap                 44268    12       44256       Ø%     /tmp
/dev/dsk/cØtØdØs7    331953   116133   18263Ø     39%     /opt
/dev/dsk/cØt3dØs7    189858   24293    146585     14%     /export/home
cinderella:(pid146)  Ø        Ø        Ø           Ø%     /net
cinderella:(pid146)  Ø        Ø        Ø           Ø%     /home
cinderella:(pid146)  2448597  2Ø55423  148315     93%     /usr/dist
cinderella:(pid146)  763573   574664   112552     84%     /usr/svr4
cinderella:(pid146)  818627   54Ø672   196Ø93     73%     /usr/netinstall
cinderella:(pid146)  Ø        Ø        Ø           Ø%     /nse
ud5-52a:/export/dist 2448597  2Ø55423  148315     93%     /tmp_mnt/usr/dist
cinderella%

Determining If File Systems Are Local or NFS Mounted (df)

To find out whether file systems are local or NFS mounted, type df filesystem and press Return. Disk formatting information (including disk location or mount point) for the file system you specify is displayed.

In this example, the file system is NFS mounted:

oak% df /home/ignatz
bigriver:/export/home/ignatz
    53898Ø  399435  85647   82%    /tmp_mnt/home/ignatz
oak%

In this example, the file system is on a local disk:

# df /
/dev/dsk/cØtØdØsØ  3Ø383   11885  15468    43%    /
#

Finding All Mounted File Systems of a Specific Type (df-F)

If you want to display all the mounted file systems of one file system type, use the -F option followed by the file system type. The most common file system types are ufs for local file systems and nfs for network file systems. To find all mounted file systems of a specific type, type df -F filesystem-type and press Return.

In this example, the mounted NFS file systems are displayed:

cinderella% df -F nfs
/net  (cinderella:(pid153)):       Ø blocks        -1 files
/usr/dist cinderella:(pid153)):    1276248 blocks  -1 files
/home  (cinderella:(pid153)):      Ø blocks        -1 files
/usr/man     (oak:/export/man):    272934 blocks   -1 files
cinderella%

In this example, the mounted UFS (local) file systems are displayed:

cinderella% df -F ufs
/  (/dev/dsk/cØtØdØsØ): 36992   blocks   13558 files
/usr  (/dev/dsk/cØtØdØs6):  274346 blocks   944Ø3 files
/export/home/cinderella (/dev/dsk/cØt3dØs7):37967Ø blocks     96Ø46 files
cinderella%

In this example, information about the mounted temporary file system is displayed:

cinderella% df -F tmpfs
/tmp               (swap            ):   88528 blocks    3156 files
cinderella%

NOTE: You cannot use the df command to display SWAPFS file systems because they are never mounted.

Table of Contents