Metadata-Version: 1.2
Name: check-mount
Version: 1.0.3
Summary: Nagios / Icinga plugin to check that mounts are present.
Home-page: https://check-mount.readthedocs.io/
Author: Matthew Pounsett
Author-email: matt@conundrum.com
License: Apache Software License 2.0
Download-URL: https://pypi.org/project/check-mount/
Project-URL: check-mount source, https://github.com/mpounsett/check-mount
Project-URL: check-mount issues, https://github.com/mpounsett/check-mount/issues
Description: About
        =====
        
        **check_mount** is a Nagios/Icinga plugin for checking for the presence of
        mounted filesystems.  
        
        Sometimes, it is only important to monitor the presence of a mount, and not
        the amount of free (or used) storage on that filesystem.  For example, when
        monitoring NFS clients it may be redundant to use **check_disk** to monitor
        the NFS mounts because the amount of free storage on those mounts is monitored
        elsewhere.  Additionally, **check_disk** can give a false negative if the
        filesystem is not mounted at all, but the directory used as a mount point is
        present.
        
        
        Usage
        =====
        
        .. code:: text
        
           usage: check_mount [-h] [-w RANGE] [-c RANGE] [-p PATH] [-t TYPE] [-M PATH]
                              [-v]
        
           optional arguments:
             -h, --help            show this help message and exit
             -w RANGE, --warning RANGE
                                   Generate warning state if number of mounts is outside
                                   this range
             -c RANGE, --critical RANGE
                                   Generate critical state if number of mounts is
                                   outside this range
             -p PATH, --path PATH  A mount point to check to ensure it is present. May
                                   be specified more than once. This option is
                                   incompatible with --type.
             -t TYPE, --type TYPE  Only check mounts of a particular type. If specified
                                   more than once, the count of present mounts will
                                   include all mounts of all types specified. This
                                   option is incompatible with --path.
             -M PATH, --mount-path PATH
                                   Override the path to mount(8) [Default: /sbin/mount]
             -v, --verbose         Increase output verbosity (use up to 3 times).
        
        Counting Mounts
        ---------------
        
        If you're only concerned with making sure the correct number of mounts are
        present, you can set a warning/critical range.
        
        To warn if anything other than exactly 5 filesystems are mounted::
        
           check_mount -w 5:5
        
        To retun critical if fewer than 5 filesystems are mounted, and a warning if
        more than 5 are mounted::
        
           check_mount -w :5 -c 5:
        
        Checking Mounts by Type
        -----------------------
        
        If you're only concerned with a particular type of mount, for example you want
        to ensure that all of your network mounts are present, but ignore any others,
        you can supply a list of filesystem types to **check_mount**.
        
        To look only at AFS and NFS mounts, and to expect exactly 2 total mounts (one
        of each)::
        
           check_mount -t NFS -t AFS -w 2:2
        
        By default, **check_mount** ignores several filessytem pseudo-types.  Ignoring
        these can be overridden by specifying them, along with any other types you
        would like to check, on the command line.  Filesystem types ignored by default
        are::
        
            autofs      bpf         cgroup      cgroup2     debugfs
            devpts      devtmpfs    hugetlbfs   mqueue      proc
            pstore      securityfs  sysfs       tmpfs
        
        Checking Specific Mount Points
        ------------------------------
        
        If you wish to check specific mount points you can specify one or more on the
        command line with the `--path` argument::
        
           check_mount -p /home -w1:1
        
        Unlike other modes of operation, when checking specific mount points
        **check_mount** applies the warning and critical ranges to each individual
        mount, rather than the sum of all mounts.  This allows **check_mount** to
        include the names of specific mounts in its error message.  So, if you're
        checking three different mount points this way, and you want to return a
        critical alert if any of them are missing, you would use a command like this::
        
           check_mount -p /home -p /var -p /opt -c1:1
        
        
Keywords: Icinga,Nagios,monitoring
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: Environment :: Console
Classifier: Natural Language :: English
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: POSIX :: BSD :: FreeBSD
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Topic :: System :: Monitoring
Classifier: Topic :: System :: Networking :: Monitoring
