Advanced options for S3 Drive are stored in the Windows registry in HKEY_LOCAL_MACHINE\SOFTWARE\nsoftware\S3Drive\20. This registry key holds settings that are available for S3 Drive globally. Sub-keys at this path hold settings for individual drives, and S3 providers.
The following keys hold configuration information:
|Registry Key||Applicable Settings|
|HKEY_LOCAL_MACHINE\SOFTWARE\nsoftware\S3Drive\20||Global settings for the application.|
|HKEY_LOCAL_MACHINE\SOFTWARE\nsoftware\S3Drive\20\Drives||Drives hold drive specific settings.|
|HKEY_LOCAL_MACHINE\SOFTWARE\nsoftware\S3Drive\20\Providers||Providers stores provider and region settings.|
|HKEY_LOCAL_MACHINE\SOFTWARE\nsoftware\S3Drive\20\ContentTypes||Content Types holds a mapping of common file extensions to MIME Content-Type values used when uploading files.|
The following values can be configured within the root HKEY_LOCAL_MACHINE\SOFTWARE\nsoftware\S3Drive\20 registry key:
|DeleteLogDays||DWORD||Specifies the number of days that log files will remain before being deleted. Only applies if RotateLogDays is greater than 0. If set to 0, old logs will not be deleted.|
Specifies whether to force the closure and subsequent update of the encrypted file on disk after the last handle to the file is closed. In general the application will update the header of the encrypted file on disk when the file is closed.
In some cases the system may not close the file immediately after the last handle is closed which results in the file on disk not being updated in a timely manner. This setting forces the closure of the file after the last handle is released. Possible values are:
|LogFile||String||Contains the path to the log file.|
|LogMode||DWORD||Determines the level of logging:
|LogPort||DWORD||The SysLog port that will be used to communicate between the service and the UI when S3 Drive is running as a service.|
|LogToFile||DWORD||Determines whether or not the log will be written to a file. The file itself is specified by LogFile.
|MaskSensitive||DWORD||Determines whether or not passwords will be masked in the log.
|MaxLogLines||DWORD||Determines the maximum number of lines that will be stored in the Log window in the Service tab.|
|MountTimeout||DWORD||Determines how long (in seconds) S3 Drive will wait for Windows to mount a drive without reporting an error. The default is 20 seconds when this value is not present in the registry.|
|PasswordEncryptionMethod||String||Determines how passwords are encrypted for storage. The default value is Auto. Possible values are:
|PromptForRegPermissions||DWORD||Determines if S3 Drive will ask for registry permissions if it does not have them when it tries to write to the registry.
|RotateLogDays||DWORD||Specifies how many days S3 Drive will use a log file before rotating to a new log file. If set to 0, the log file will never rotate.|
|RunAsService||DWORD||Determines whether or not S3 Drive will run as a service.|
|ShowDotFiles||DWORD||Determines whether files that start with a dot or period (.) are returned in a directory listing.
|HideDotFiles||DWORD||Determines whether files that start with a dot or period (.) are marked as hidden when returned in a directory listing.
|IgnoredDirs||String||Specifies a comma-separated list of folders should be ignored by the virtual drive. Each folder included on the list cannot be created on the virtual drive and will not be returned in directory listings. Please specify the folder relative to the root of the drive.
Note: Use with caution. When the system asks us to create these folders we will respond with SYSERR_CANNOT_MAKE. Applications or system components that rely on these filesystem operations may start to behave unexpectedly.
Specifies a comma-separated list of files to ignore requests for. Windows may make frequent, informational requests for files that it needs such as desktop.ini. If the request being made by the operating system is for one of the files in this list, the request will not be made to the S3 provider.
For each file on this list, we will service the system's request without performing the operation against remote storage. We respond by telling the system the file does not exist for simplicity.
|KeepAliveInterval||DWORD||Determines how often a keep alive packet is sent to the server, in seconds. If set to 0, no keep alive packets will be sent.|
|LocalHost||String||Specifies the local IP address of the network interface to use when connecting. This settings is typically only useful in machines with multiple network interfaces.|
|ProxyChecked||DWORD||Specifies whether or not the proxy settings are enabled.|
|ProxyHost||String||Specifies the host that S3 Drive will use to connect to the proxy.|
|ProxyPassword||String||Specifies the password that S3 Drive will use to connect to the proxy.|
|ProxyPort||DWORD||Specifies the port that S3 Drive will use to connect to the proxy.|
|ProxyType||DWORD||Specifies the type of proxy that S3 Drive will connect to.
|ProxyUsername||String||Specifies the username that S3 Drive will use to connect to the proxy.|
|ReconnectAttempts||DWORD||Specifies the number of times S3 Drive will attempt to reconnect if the connection to the server is lost.|
|ReconnectInterval||DWORD||Specifies the time (in seconds) between attempting another reconnection to the server. Default is 5 seconds.|
|Timeout||DWORD||Determines how many seconds S3 Drive will wait for a response from the server before ending the connection.|