.. _filepath-macro:

File Path Macro Options
========================================================

- File path macro options allow you to easily specify predefined folder paths for each operating system.
- Macros vary by operating system. You can check the available macros and their corresponding paths for each operating system in the tables below.

Windows File Path Macro List
------------------------------

.. csv-table::
   :header: "Macro Name","Actual Path","Description"
   :widths: 20 40 40
   
   "%SystemDrive%","C:\\","Windows installation drive path"
   "%WinDir%","C:\\Windows","Windows installation path"
   "%SystemRoot%","C:\\Windows","Windows system root path"
   "%SystemDir%","C:\\Windows\\System32","Windows system path"
   "%ProgramFiles%","C:\\Program Files","Windows program installation path"
   "%UserDir%","C:\\Users\\{USERNAME}","Windows user path"
   "%Desktop%","C:\\Users\\{USERNAME}\\Desktop","Desktop path"
   "%ProgramGroup%","C:\\Users\\{USERNAME}\\AppData\\Roaming\\Microsoft\\Windows\\Start Menu\\Programs","Program group path"
   "%Temp%","C:\\Users\\{USERNAME}\\AppData\\Local\\Temp","Windows temporary path"
   "%TempInternet%","C:\\Users\\{USERNAME}\\AppData\\Local\\Microsoft\\Windows\\INetCache","Temporary internet files storage path"

macOS File Path Macro List
------------------------------

.. csv-table::
   :header: "Macro Name","Actual Path","Description"
   :widths: 20 40 40
   
   "%UserDir%","/Users/{USERNAME}","User path"
   "%GenianDir%","/Users/Shared/Genians","Agent installation path"

Linux File Path Macro List
------------------------------

.. csv-table::
   :header: "Macro Name","Actual Path","Description"
   :widths: 20 40 40

   "%UserDir%","/home/{USERNAME}","User path"
   "%DesktopDir%","/home/{USERNAME}/Desktop","Desktop path"
   "%DocumentsDir%","/home/{USERNAME}/Documents","Documents path"
   "%DownloadsDir%","/home/{USERNAME}/Downloads","Downloads path"
   "%RuntimeDir%","/run/user/{UID}","User runtime path"
   "%RootDir%","/","Root path"
   "%GenianDir%","/opt/genians/nac","Agent installation path"