<p>Richard Mudgett has uploaded this change for <strong>review</strong>.</p><p><a href="https://gerrit.asterisk.org/10525">View Change</a></p><pre style="font-family: monospace,monospace; white-space: pre-wrap;">modules.conf.sample: Update preload usage documentation.<br><br>Change-Id: Id449d4435c38148b56ac4cfd61ae4d90ac66bb90<br>---<br>M configs/samples/modules.conf.sample<br>1 file changed, 13 insertions(+), 12 deletions(-)<br><br></pre><pre style="font-family: monospace,monospace; white-space: pre-wrap;">git pull ssh://gerrit.asterisk.org:29418/asterisk refs/changes/25/10525/1</pre><pre style="font-family: monospace,monospace; white-space: pre-wrap;"><span>diff --git a/configs/samples/modules.conf.sample b/configs/samples/modules.conf.sample</span><br><span>index 179e9ef..db85fae 100644</span><br><span>--- a/configs/samples/modules.conf.sample</span><br><span>+++ b/configs/samples/modules.conf.sample</span><br><span>@@ -8,26 +8,27 @@</span><br><span> autoload=yes</span><br><span> ;</span><br><span> ; Any modules that need to be loaded before the Asterisk core has been</span><br><span style="color: hsl(0, 100%, 40%);">-; initialized (just after the logger has been initialized) can be loaded</span><br><span style="color: hsl(0, 100%, 40%);">-; using 'preload'. This will frequently be needed if you wish to map all</span><br><span style="color: hsl(0, 100%, 40%);">-; module configuration files into Realtime storage, since the Realtime</span><br><span style="color: hsl(0, 100%, 40%);">-; driver will need to be loaded before the modules using those configuration</span><br><span style="color: hsl(0, 100%, 40%);">-; files are initialized.</span><br><span style="color: hsl(120, 100%, 40%);">+; initialized (just after the logger initialization) can be loaded</span><br><span style="color: hsl(120, 100%, 40%);">+; using 'preload'.</span><br><span> ;</span><br><span style="color: hsl(0, 100%, 40%);">-; An example of loading ODBC support would be:</span><br><span style="color: hsl(0, 100%, 40%);">-;preload => res_odbc.so</span><br><span style="color: hsl(0, 100%, 40%);">-;preload => res_config_odbc.so</span><br><span style="color: hsl(120, 100%, 40%);">+; NOTE: 'preload' is a legacy module loading method that is not really</span><br><span style="color: hsl(120, 100%, 40%);">+; needed anymore and generally should not be used.  It was historically</span><br><span style="color: hsl(120, 100%, 40%);">+; required to preload realtime driver modules so you could map all module</span><br><span style="color: hsl(120, 100%, 40%);">+; configuration files to Realtime storage.  The Realtime drivers needed</span><br><span style="color: hsl(120, 100%, 40%);">+; to be loaded before any module (including modules internal to Asterisk)</span><br><span style="color: hsl(120, 100%, 40%);">+; using configuration files got initialized.  Realtime driver modules no</span><br><span style="color: hsl(120, 100%, 40%);">+; longer need to be preloaded.</span><br><span> ;</span><br><span style="color: hsl(0, 100%, 40%);">-; Uncomment the following if you wish to use the Speech Recognition API</span><br><span style="color: hsl(0, 100%, 40%);">-;preload => res_speech.so</span><br><span style="color: hsl(120, 100%, 40%);">+;preload => your_special_module.so</span><br><span> ;</span><br><span> ; If you want Asterisk to fail if a module does not load, then use</span><br><span> ; the "require" keyword. Asterisk will exit with a status code of 2</span><br><span> ; if a required module does not load.</span><br><span> ;</span><br><span style="color: hsl(0, 100%, 40%);">-; require = chan_sip.so</span><br><span style="color: hsl(120, 100%, 40%);">+; require = chan_pjsip.so</span><br><span style="color: hsl(120, 100%, 40%);">+;</span><br><span> ; If you want you can combine with preload</span><br><span style="color: hsl(0, 100%, 40%);">-; preload-require = res_odbc.so</span><br><span style="color: hsl(120, 100%, 40%);">+; preload-require = your_special_module.so</span><br><span> ;</span><br><span> ;load => res_musiconhold.so</span><br><span> ;</span><br><span></span><br></pre><p>To view, visit <a href="https://gerrit.asterisk.org/10525">change 10525</a>. To unsubscribe, or for help writing mail filters, visit <a href="https://gerrit.asterisk.org/settings">settings</a>.</p><div itemscope itemtype="http://schema.org/EmailMessage"><div itemscope itemprop="action" itemtype="http://schema.org/ViewAction"><link itemprop="url" href="https://gerrit.asterisk.org/10525"/><meta itemprop="name" content="View Change"/></div></div>

<div style="display:none"> Gerrit-Project: asterisk </div>
<div style="display:none"> Gerrit-Branch: 16 </div>
<div style="display:none"> Gerrit-MessageType: newchange </div>
<div style="display:none"> Gerrit-Change-Id: Id449d4435c38148b56ac4cfd61ae4d90ac66bb90 </div>
<div style="display:none"> Gerrit-Change-Number: 10525 </div>
<div style="display:none"> Gerrit-PatchSet: 1 </div>
<div style="display:none"> Gerrit-Owner: Richard Mudgett <rmudgett@digium.com> </div>