Configuration Fields¶
Set fields on an instance (or pass them in the constructor namespace)
before Connect. Shared fields are set on the class itself and affect
all instances.
Connection¶
| Field | Default | Meaning |
|---|---|---|
Host |
'' |
server hostname or IP |
Port |
22 |
server TCP port |
Username |
'' |
account to authenticate as |
Password |
'' |
password — non-empty selects password auth |
KeyFile |
'' |
path to an unencrypted OpenSSH-format RSA private key — selects public-key auth when Password is empty |
When both Password and KeyFile are empty, ~/.ssh/id_rsa is used if
it exists ($HOME, or %USERPROFILE% on Windows).
Host key trust¶
| Field | Default | Meaning |
|---|---|---|
KnownHostsFile |
'' |
known_hosts path; '' means the OpenSSH default location |
HostKeyPolicy |
'accept-new' |
'accept-new' | 'strict' | 'none' — see Host Key Verification |
Transport¶
| Field | Default | Meaning |
|---|---|---|
BufferSize |
200000 |
Conga receive buffer size (bytes) |
WaitTime |
5000 |
per-read timeout in ms; a silent peer fails after this |
Timeout |
30 |
reserved — currently not enforced (the effective timeout is WaitTime per read) |
Conga (shared)¶
| Field | Default | Meaning |
|---|---|---|
CongaPath |
'' |
directory containing conga.dws, when auto-discovery fails |
CongaRef |
'' |
an existing Conga/DRC namespace or instance to use instead of copying |
CongaVersion |
— | set after initialisation |
LDRC |
— | the live Conga library reference (internal) |
Debugging (shared)¶
Debug is a bit mask:
| Bit | Effect |
|---|---|
1 |
disable internal error trapping — errors signal instead of becoming rc ¯1 |
2 |
stop (breakpoint) on connect |
4 |
packet-level trace to the session |
8 |
crypto-level trace to the session |
Warning
Traces include decrypted packet contents. Use only against test servers.