check_smb_file

Project Notes

Usage Switches...
-H, --host <hostname> The hostname to check (required)
-f, --filename <filename> The share and path to the file/directory (required)
-F --filename-match <regex> Only check filenames matching this regex
-D --mode-directory Treat the filename to check as a directory
-w, --warning <value> Warning if file property exceeds value
-c, --critical <value> Critical if file property exceeds value
-m, --warning-match <regex> Warning if contents match regex
-M, --critical-match <regex> Critical if contents match regex
-t, --warning-files <value> Warning if the total files detected exceeds value
-T, --critical-files <value> Critical if the total files detected exceeds value
-p, --property <property> The property to test (Default: modified)
-K, --kerberos Use Kerberos for authentication
-U, --username <username> The username to connect with
-P, --password <password> The password to authenticate with
-W, --workgroup <workgroup> The workgroup the username is located in
-K, --kerberos Use Kerberos for authentication
-n, --no-data Do not collect performance data
-d, --debug <0-10> Set the debug level for libsmbclient
-V, --version Display the version of this script and exit
-h, --help Display this usage screen and exit

Warning and Critical Values
---------------------------
The returned value for a non-existent file/path is CRITICAL.

A warning or critical value can be a measure of time or size, with a suffix
detailing the measure type. The below table is a list of possible measures.

Time | Size
-------- ---------------
seconds | KB (kilobytes)
minutes | MB (megabytes)
hours | GB (gigabytes)
days |

You can test a few different properties of the file. The below table lists
the valid properties.

Property | Description
--------- ----------------------
modified | Last modified time
accessed | Last accessed time
size | Size of the file

File Paths
----------
File paths are checked with forward slashes. So a path to check should be entered
with forward slashes and not back slashes, such as...

SomeShare/some_directory/some_file.txt

However, if you enter back slashes the script will attempt to convert them to
forward slashes and check the resulting path. Also, you can check hidden and
admin shares, such as the system drive, by using a double dollar sign in nagios
commands...

C$$/some_directory/some_file.txt

Also note that file path checks are case-insensitive.

TODO/Limitations
----------
* This script does not yet test the size of a directory.
* Performance data is a work-in-progress.