File to include at beginning of compilation unit

WTSupported in traditional Synergy on Windows
WNSupported in Synergy .NET on Windows
USupported on UNIX
VSupported on OpenVMS

The SYNUSERDEF environment variable specifies a file to implicitly include at the beginning of a compilation unit.


The file specification to include. The path can be full or relative. The default extension is .dbl.


SYNUSERDEF enables you to define identifiers that will apply across all files in a compilation unit. First create a file that contains the desired IMPORT statements, .DEFINE and .INCLUDE directives, etc., and store the file in an accessible location. Set SYNUSERDEF to the path and name of this file, and then compile your files.


Although SYNUSERDEF enables you to import multiple namespaces, we don’t recommend using it this way. Instead, we recommend that you add explicit IMPORT statements, or (for non‑.NET applications) use SYNDEFNS.

If the ‑quserdef compiler option is specified, SYNUSERDEF is ignored.

Setting location

The environment or the [synergy] section of synergy.ini.

Used by

Compiler, Workbench, Synergy Prototype utility

See also

SYNDEFNS environment variable


set SYNUSERDEF = c:\MyFiles\contacts.def