Drive Mask


Hyena uses a special template, or "mask" when retrieving the disk space (available, used, etc.) information. The drive space mask is set under the Tools->Settings->General configuration dialog.


The disk space mask can be customized to support different system configurations when gathering remote disk space information.  By default, Hyena uses the administrative shares for getting remote drive space information. The default mask is %s$.  The "%s" parameter in a mask is a placeholder for the drive letter.  When Hyena encounters %s in the mask, Hyena queries the remote system for a list of disk drives, and then queries each of the drives using the remainder of the mask for the drive's disk space.  


For example, if a share exists for every drive, named, for example, C-drive, D-drive, etc., the mask can be set to:




This setting is not case-sensitive.  Furthermore, the directory being shared does NOT have to be at the root of the drive; it can be anywhere on the drive, as long as the convention used for the share name is consistent across all of the drives.


You can have Hyena check the shares using an alternate naming convention if, for example, the users running Hyena do not have the access rights to retrieve the drive list, or if greater performance is needed to retrieve the disk drive information.  To do this, configure a mask that does not use the %s placeholder, and instead explicitly code each drive (share) in the mask.  For example:


Drive-C;Drive-D;Drive-E - Use this style of mask (separate the individual drive shares with a semicolon) to explicitly tell Hyena which shares to look for.  Using this style of drive space mask will force Hyena to skip trying to check the remote system's drive configuration, and will speed up the process of retrieving the drive space information.  Note that Hyena will automatically skip non-existent shares without displaying any error.


%s$;SYS;VOL1;VOL2 - Use this style of mask to have Hyena check for the remote administrative shares, as well as the presence of Netware drives, when querying for disk space.  The %s$ mask will fail (without any error) on Netware systems, yet the volume shares will display the disk space information correctly.  


Please note that any combination of these examples can be used.