Wide Character Support

Because of the way Unix and Linux systems store directory and filename information, that is, in UTF-8, there has never been an issue with running RLM in wide-character environments on those systems. On Windows however, where the operating system stores path information in widecharacters, RLM must be wide-character-aware.

If an application passes paths to rlm_init() containing wide characters (wchar_t or WCHAR strings), it must first convert those paths to UTF-8 before passing them to RLM. RLM stores them internally as UTF-8 and converts back to wide characters before using them in filesystem operations. In this way, RLM clients and servers can be installed on wide character paths and work correctly.

Note

RLM does not support wide characters in the ISV options file or in debuglog and reportlog file names.

On Windows platforms, if the paths your application would pass to rlm_init() in the first and second parameters are Unicode wide characters (wchar_t or WCHAR), you must first convert them to UTF-8. The Win32 function WideCharToMultiByte() can be used for this conversion.