Next revision | Previous revision |
config:cmdline [2010/03/06 01:28] – created digitalman | config:cmdline [2023/12/14 16:40] (current) – [Specifiers] Added %- (user's chat handle) digital man |
---|
There are a number of places in [[:util:SCFG]] where a sysop may configure command-lines to be executed for certain features (e.g. doors, file transfer drivers, file archive/compression/test, etc.). | There are a number of places in [[:util:SCFG]] where a sysop may configure command-lines to be executed for certain features (e.g. doors, file transfer drivers, file archive/compression/test, etc.). |
| |
| ===== Modules ===== |
| If the command-line is to be used to execute an internally evaluated module (either [[:util:Baja]] or [[custom:JavaScript]]), the command line should begin with an asterisk (''*'') or question mark (''?'') character. An asterisk indicates that a ''.js'' file should be executed from either the ''[[dir:mods]]'' or ''[[dir:exec]]'' directory if it exists, otherwise, to execute a ''.bin'' (Baja compiled) file (from either the ''[[dir:mods]]'' or ''[[dir:exec]]'' directory) if it exists. A question mark indicates to execute a ''.js'' file only (do not fall back to ''.bin''). The module file extension (e.g. ''.js'' or ''.bin'') is optional. |
| |
| In summary: |
| |
| ^ Command-line ^ Description ^ |
| | *example | Executes ''exec/example.js'' or ''exec/example.bin'' | |
| | ?example | Executes ''exec/example.js'' only | |
| |
| Note: The ''[[dir:mods]]'' directory or configured ''Start-up Directory'' (when relevant) are also searched for modules to execute. |
===== Specifiers ===== | ===== Specifiers ===== |
| |
|''%O'' |Sysop's name | ''digital man'' || | |''%O'' |Sysop's name | ''digital man'' || |
|''%o'' |Sysop's name (auto-quoted) | ''%%"digital man"%%'' || | |''%o'' |Sysop's name (auto-quoted) | ''%%"digital man"%%'' || |
|''%p'' |Client protocol | ''Telnet'' || | |''%p'' |Client protocol (e.g. Telnet, RLogin, SSH), or "raw" | ''raw'' || |
|''%q'' |System's QWK ID (as specified in SCFG) | ''VERT'' || | |''%q'' |System's QWK ID (as specified in SCFG) | ''VERT'' || |
|''%r'' |Client's terminal height (in rows) | ''24'' || | |''%r'' |Client's terminal height (in rows) | ''24'' || |
|''%*'' |Current Node number (0 padded to 3 digits) | ''001'' || | |''%*'' |Current Node number (0 padded to 3 digits) | ''001'' || |
|''%$'' |User's credits | ''4534834'' || | |''%$'' |User's credits | ''4534834'' || |
| |''%+'' |User's real name (auto-quoted) | ''"Rob Swindell"'' || |
| |''%-'' |User's chat handle/call-sign (auto-quoted) | ''WX6YYZ'' || |
|''%%'' |Percent symbol | ''%'' || | |''%%'' |Percent symbol | ''%'' || |
|''%?'' |Platform/operating system | ''win32''|''linux''| | |''%?'' |Platform/operating system (build target) | ''win32''|''linux''| |
| |''%^'' |Processor architecture (build target) | ''i686''|''x64''| |
|''%1'' |Current user number | ''1'' || | |''%1'' |Current user number | ''1'' || |
|''%2'' |Current user number (0 padded to 2 digits) | ''01'' || | |''%2'' |Current user number (0 padded to 2 digits) | ''01'' || |
|''%3'' |Current user number (0 padded to 3 digits), etc. | ''001'' || | |''%3'' |Current user number (0 padded to 3 digits) | ''001'' || |
| |''%4'' |Current user number (0 padded to 4 digits) | ''0001'' || |
| |''%(5-9)'' |Current user number (0 padded to 5-9 digits) | ''00001'' || |
| |
==== Auto-quoting ==== | ==== Auto-quoting ==== |
| |
For most alphabetic specifiers, using uppercase or lowercase letters will produce the same results. The following specifiers support automatic quoting, including double-quote characters only when spaces would be included in the expanded value. To disable the automatic quoting, use the uppercase version. | For most alphabetic specifiers, using uppercase or lowercase letters will produce the same results. The following specifiers support automatic quoting, enclosing the value in double-quote characters only when spaces are included in the expanded value. To prevent automatic quoting, use the uppercase version of the specifier (e.g. ''%A'' instead of ''%a''). |
| |
* ''%a'' | * ''%a'' |
===== See Also ===== | ===== See Also ===== |
* [[:util:SCFG]] | * [[:util:SCFG]] |
* [[:config:|Configuration]] | |
| |
{{tag>}} | |
| |
| {{tag>configuration general_config scfg module door}} |