kafs-check-config8

Usage

Overview

This program is used to check the configuration for the in-kernel AFS filesystem (kAFS). This configuration is used when systemd mounts the filesystem to load up the cell database and create cell automounts in the /afs directory.

The configuration is also used by the kernel name resolver upcall to provide static configuration for some cells and to specify overrides and limits on DNS lookups.

If a list of "cellname" arguments is given, the listed cells will be dumped, including the sources of the Volume Location records and address records.

Options

-4

Only show IPv4 addresses in the dump.

-6

Only show IPv6 addresses in the dump.

-P

Dump the parse tree of the configuration file(s).

-D

Dump the cell database extracted from the configuration.

-v

Increase the verbosity of the output. This may be specified multiple times.

-c <conffile>

Specify a configuration file to read instead of the system default. This may be specified multiple times and the configuration files are read and applied in order.

-N <restriction>

Apply a restriction to the lookup performed for the listed cells (if any are). Valid restrictions include:

vl-srv

Don't use SRV records to find Volume Location servers.

vl-afsdb

Don't use AFSDB records to find Volume Location servers.

vl-all

Don't use SRV or AFSDB records to find Volume Location servers.

vl-host

Don't look cell name up as hostname to find a Volume Location server.

vl-dns

Don't do any lookups to find Volume Location servers. Use only the static configuration.

Argument

<cellname>

The AFS cell name to display. Multiple cells may be specified. If no cell name is specified the default cell specified in "/proc/net/afs/rootcell" is displayed.

Exit status

0 - If check okay and any dumping succeeded

1 - If an error occurs during processing

2 - If a command line error occurs

Examples

To display the configuration for the default cell:

        # kafs-check-config
        === Found cell some-cell.org ===
          - use-dns=no
          - show-cell=no
          - status: no-lookup, from config
          - VLSERVER shelter-4.some-cell.org [good; nss]
            - address 10.0.0.48
          - VLSERVER shelter-5.some-cell.org [good; nss]
            - address 10.0.0.54

To display two specific cells:

        # kafs-check-config ir.stanford.edu grand.central.org
        === Found cell ir.stanford.edu ===
          - show-cell=no
          - status: good, from SRV
          - VLSERVER afsdb3.stanford.edu [good; nss]
            - udp
            - port 7003, pref 0, weight 0
            - address 171.64.7.246
          - VLSERVER afsdb2.stanford.edu [good; nss]
            - udp
            - port 7003, pref 0, weight 0
            - address 171.64.7.234
          - VLSERVER afsdb1.stanford.edu [good; nss]
            - udp
            - port 7003, pref 0, weight 0
            - address 171.64.7.222
        === Found cell grand.central.org ===
          - show-cell=no
          - status: good, from SRV
          - VLSERVER grand.mit.edu [good; nss]
            - udp
            - port 7003, pref 0, weight 0
            - address 18.9.48.14
          - VLSERVER grand-old-opry.central.org [good; nss]
            - udp
            - port 7003, pref 0, weight 0
            - address 128.2.13.219