What is the SYM file format?
A .sym file holds a symbol table - a mapping from binary memory addresses or offsets to human-readable identifiers such as function names, variable names, data types, and source-code line numbers. The extension is a catch-all used by many unrelated toolchains; the actual binary or text layout depends entirely on the environment that produced it.
Common variants include Windows CodeView 4 .sym files (structured binary, magic bytes 0x4E 0x52 / NR), which predate the .PDB Program Database format introduced in Visual Studio 4.0 (1995); Palm OS / CodeWarrior binary debug info; gEDA/KiCad schematic symbol definitions (plain UTF-8 text with attribute-value pairs and pin definitions); CODESYS PLC symbol exports (XML); and older DOS/Win16 toolchain symbol maps. A .sym file from one toolchain is not interpretable by another.
In the debugging context, .sym files allow debuggers and crash-analysis tools to translate raw addresses in a stack trace or core dump into meaningful source-code references - a process called symbolication. Without them, post-mortem debugging yields only hexadecimal addresses.
Modern Windows development uses .pdb files instead; Linux and macOS embed DWARF debug sections in ELF and Mach-O binaries or use .dSYM bundles on Apple platforms. The .sym extension survives mainly in embedded systems, legacy toolchains, gEDA PCB design, and EDA applications where schematic symbol libraries carry the name naturally.
Security & safety
RISK: LOWA debug symbol file contains only name/address mappings and type information - no executable code. Opening one cannot harm the system. The only concern is information disclosure: .sym files for commercial software may reveal internal function/variable names that were not intended for public distribution.
Format details
in a nutshell- gEDA Schematic Symbol - Plain-text file defining an electronic component symbol for gschem schematic capture.
- SolidWorks Symbol Library - Binary library of drawing/annotation symbols used in SolidWorks CAD.
- P-CAD / Altium EDA Symbol - Component symbol definition file used in legacy P-CAD and Altium PCB design tools.
Programs that open SYM files
Windows3 apps
Eclipse IDE
Open-source Eclipse with CDT uses .sym files from embedded toolchains automatically during debug sessions (Run > Debug Configurations). 
Microsoft Windbg
Free Load the target executable, then point WinDbg to the .sym file via .sympath - used for kernel and application debugging.
OllyDbg
Free Load symbols via Plugins or Debug > Load symbols to resolve names in disassembly. Legacy x86 debugger, no longer developed but widely used. 
macOS1 app
GDB (GNU Debugger)
Open-source Same as Linux: gdb -s symbols.sym ./executable. Note: Apple's native debugger is LLDB; GDB may need codesigning workarounds on modern macOS. 
Linux2 apps
Eclipse IDE
Open-source Eclipse CDT integrates GDB and loads .sym files automatically for embedded cross-compilation debug sessions.
GDB (GNU Debugger)
Open-source Run: gdb -s symbols.sym ./executable or use (gdb) symbol-file symbols.sym to load the symbol table. Technical details
deep spec| Format type | Symbol table (address-to-identifier mapping); exact layout is toolchain-specific |
| Encoding | Binary or plain text - depends on the originating toolchain |
| Byte order | Little-endian (most binary variants); N/A for text and XML variants |
| Typical file size | 1 KB - 50 MB (large binaries produce large symbol tables) |
| Binary variant (Windows) | CodeView 4 - structured binary records, magic bytes 0x4E 0x52 ('NR') |
| Text variant (EDA) | gEDA/KiCad schematic symbols - UTF-8 attribute-value pairs with pin definitions |
| XML variant | CODESYS PLC symbol export - structured XML |
| Platform | Windows, Linux, macOS, embedded/RTOS environments |
| Superseded by (Windows) | .pdb (Program Database, Visual Studio 4.0, 1995) |
| Superseded by (Linux/macOS) | DWARF sections in ELF/Mach-O binaries; .dSYM bundles on Apple platforms |
| Interoperability | None - .sym files from different toolchains are mutually incompatible |
| Released | 1980s (varies by toolchain) |
SYM conversions
Community Q&A
asked by usersNo questions yet - be the first to ask about SYM files.
