<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <title> Module: DevDNSd::OSX — Documentation by YARD 0.8.7.6 </title> <link rel="stylesheet" href="../css/style.css" type="text/css" charset="utf-8" /> <link rel="stylesheet" href="../css/common.css" type="text/css" charset="utf-8" /> <script type="text/javascript" charset="utf-8"> hasFrames = window.top.frames.main ? true : false; relpath = '../'; framesUrl = "../frames.html#!DevDNSd/OSX.html"; </script> <script type="text/javascript" charset="utf-8" src="../js/jquery.js"></script> <script type="text/javascript" charset="utf-8" src="../js/app.js"></script> </head> <body> <div id="header"> <div id="menu"> <a href="../_index.html">Index (O)</a> » <span class='title'><span class='object_link'><a href="../DevDNSd.html" title="DevDNSd (module)">DevDNSd</a></span></span> » <span class="title">OSX</span> <div class="noframes"><span class="title">(</span><a href="." target="_top">no frames</a><span class="title">)</span></div> </div> <div id="search"> <a class="full_list_link" id="class_list_link" href="../class_list.html"> Class List </a> <a class="full_list_link" id="method_list_link" href="../method_list.html"> Method List </a> <a class="full_list_link" id="file_list_link" href="../file_list.html"> File List </a> </div> <div class="clear"></div> </div> <iframe id="search_frame"></iframe> <div id="content"><h1>Module: DevDNSd::OSX </h1> <dl class="box"> <dt class="r1">Included in:</dt> <dd class="r1"><span class='object_link'><a href="Application.html" title="DevDNSd::Application (class)">Application</a></span></dd> <dt class="r2 last">Defined in:</dt> <dd class="r2 last">lib/devdnsd/osx.rb</dd> </dl> <div class="clear"></div> <h2>Overview</h2><div class="docstring"> <div class="discussion"> <p>OSX management methods.</p> </div> </div> <div class="tags"> </div> <h2> Instance Method Summary <small>(<a href="#" class="summary_toggle">collapse</a>)</small> </h2> <ul class="summary"> <li class="public "> <span class="summary_signature"> <a href="#action_add-instance_method" title="#action_add (instance method)">- (Boolean) <strong>action_add</strong>(options) </a> </span> <span class="summary_desc"><div class='inline'><p>Adds aliases to an interface.</p> </div></span> </li> <li class="public "> <span class="summary_signature"> <a href="#action_install-instance_method" title="#action_install (instance method)">- (Boolean) <strong>action_install</strong> </a> </span> <span class="summary_desc"><div class='inline'><p>Installs the application into the autolaunch.</p> </div></span> </li> <li class="public "> <span class="summary_signature"> <a href="#action_remove-instance_method" title="#action_remove (instance method)">- (Boolean) <strong>action_remove</strong>(options) </a> </span> <span class="summary_desc"><div class='inline'><p>Removes aliases from an interface.</p> </div></span> </li> <li class="public "> <span class="summary_signature"> <a href="#action_uninstall-instance_method" title="#action_uninstall (instance method)">- (Boolean) <strong>action_uninstall</strong> </a> </span> <span class="summary_desc"><div class='inline'><p>Uninstalls the application from the autolaunch.</p> </div></span> </li> <li class="public "> <span class="summary_signature"> <a href="#dns_update-instance_method" title="#dns_update (instance method)">- (Boolean) <strong>dns_update</strong> </a> </span> <span class="summary_desc"><div class='inline'><p>Updates DNS cache.</p> </div></span> </li> <li class="public "> <span class="summary_signature"> <a href="#execute_command-instance_method" title="#execute_command (instance method)">- (Boolean) <strong>execute_command</strong>(command) </a> </span> <span class="summary_desc"><div class='inline'><p>Executes a shell command.</p> </div></span> </li> <li class="public "> <span class="summary_signature"> <a href="#launch_agent_path-instance_method" title="#launch_agent_path (instance method)">- (String) <strong>launch_agent_path</strong>(name = "it.cowtech.devdnsd") </a> </span> <span class="summary_desc"><div class='inline'><p>Gets the path for the launch agent file.</p> </div></span> </li> <li class="public "> <span class="summary_signature"> <a href="#osx%3F-instance_method" title="#osx? (instance method)">- (Boolean) <strong>osx?</strong> </a> (also: #is_osx?) </span> <span class="summary_desc"><div class='inline'><p>Checks if we are running on MacOS X.</p> </div></span> </li> <li class="public "> <span class="summary_signature"> <a href="#resolver_path-instance_method" title="#resolver_path (instance method)">- (String) <strong>resolver_path</strong>(tld = nil) </a> </span> <span class="summary_desc"><div class='inline'><p>Gets the path for the resolver file.</p> </div></span> </li> </ul> <div id="instance_method_details" class="method_details_list"> <h2>Instance Method Details</h2> <div class="method_details first"> <h3 class="signature first" id="action_add-instance_method"> - (<tt>Boolean</tt>) <strong>action_add</strong>(options) </h3><div class="docstring"> <div class="discussion"> <p>Adds aliases to an interface.</p> </div> </div> <div class="tags"> <p class="tag_title">Parameters:</p> <ul class="param"> <li> <span class='name'>options</span> <span class='type'>(<tt>Hash</tt>)</span> — <div class='inline'><p>The options provided by the user.</p> </div> </li> </ul> <p class="tag_title">Returns:</p> <ul class="return"> <li> <span class='type'>(<tt>Boolean</tt>)</span> — <div class='inline'><p><code>true</code> if action succeeded, <code>false</code> otherwise.</p> </div> </li> </ul> </div><table class="source_code"> <tr> <td> <pre class="lines"> 64 65 66</pre> </td> <td> <pre class="code"><span class="info file"># File 'lib/devdnsd/osx.rb', line 64</span> <span class='kw'>def</span> <span class='id identifier rubyid_action_add'>action_add</span><span class='lparen'>(</span><span class='id identifier rubyid_options'>options</span><span class='rparen'>)</span> <span class='id identifier rubyid_manage_aliases'>manage_aliases</span><span class='lparen'>(</span><span class='symbol'>:add</span><span class='comma'>,</span> <span class='id identifier rubyid_i18n'>i18n</span><span class='period'>.</span><span class='id identifier rubyid_add_empty'>add_empty</span><span class='comma'>,</span> <span class='id identifier rubyid_options'>options</span><span class='rparen'>)</span> <span class='kw'>end</span></pre> </td> </tr> </table> </div> <div class="method_details "> <h3 class="signature " id="action_install-instance_method"> - (<tt>Boolean</tt>) <strong>action_install</strong> </h3><div class="docstring"> <div class="discussion"> <p>Installs the application into the autolaunch.</p> </div> </div> <div class="tags"> <p class="tag_title">Returns:</p> <ul class="return"> <li> <span class='type'>(<tt>Boolean</tt>)</span> — <div class='inline'><p><code>true</code> if action succeeded, <code>false</code> otherwise.</p> </div> </li> </ul> </div><table class="source_code"> <tr> <td> <pre class="lines"> 79 80 81</pre> </td> <td> <pre class="code"><span class="info file"># File 'lib/devdnsd/osx.rb', line 79</span> <span class='kw'>def</span> <span class='id identifier rubyid_action_install'>action_install</span> <span class='id identifier rubyid_manage_installation'>manage_installation</span><span class='lparen'>(</span><span class='id identifier rubyid_launch_agent_path'>launch_agent_path</span><span class='comma'>,</span> <span class='id identifier rubyid_resolver_path'>resolver_path</span><span class='comma'>,</span> <span class='symbol'>:create_resolver</span><span class='comma'>,</span> <span class='symbol'>:create_agent</span><span class='comma'>,</span> <span class='symbol'>:load_agent</span><span class='rparen'>)</span> <span class='kw'>end</span></pre> </td> </tr> </table> </div> <div class="method_details "> <h3 class="signature " id="action_remove-instance_method"> - (<tt>Boolean</tt>) <strong>action_remove</strong>(options) </h3><div class="docstring"> <div class="discussion"> <p>Removes aliases from an interface.</p> </div> </div> <div class="tags"> <p class="tag_title">Parameters:</p> <ul class="param"> <li> <span class='name'>options</span> <span class='type'>(<tt>Hash</tt>)</span> — <div class='inline'><p>The options provided by the user.</p> </div> </li> </ul> <p class="tag_title">Returns:</p> <ul class="return"> <li> <span class='type'>(<tt>Boolean</tt>)</span> — <div class='inline'><p><code>true</code> if action succeeded, <code>false</code> otherwise.</p> </div> </li> </ul> </div><table class="source_code"> <tr> <td> <pre class="lines"> 72 73 74</pre> </td> <td> <pre class="code"><span class="info file"># File 'lib/devdnsd/osx.rb', line 72</span> <span class='kw'>def</span> <span class='id identifier rubyid_action_remove'>action_remove</span><span class='lparen'>(</span><span class='id identifier rubyid_options'>options</span><span class='rparen'>)</span> <span class='id identifier rubyid_manage_aliases'>manage_aliases</span><span class='lparen'>(</span><span class='symbol'>:remove</span><span class='comma'>,</span> <span class='id identifier rubyid_i18n'>i18n</span><span class='period'>.</span><span class='id identifier rubyid_remove_empty'>remove_empty</span><span class='comma'>,</span> <span class='id identifier rubyid_options'>options</span><span class='rparen'>)</span> <span class='kw'>end</span></pre> </td> </tr> </table> </div> <div class="method_details "> <h3 class="signature " id="action_uninstall-instance_method"> - (<tt>Boolean</tt>) <strong>action_uninstall</strong> </h3><div class="docstring"> <div class="discussion"> <p>Uninstalls the application from the autolaunch.</p> </div> </div> <div class="tags"> <p class="tag_title">Returns:</p> <ul class="return"> <li> <span class='type'>(<tt>Boolean</tt>)</span> — <div class='inline'><p><code>true</code> if action succeeded, <code>false</code> otherwise.</p> </div> </li> </ul> </div><table class="source_code"> <tr> <td> <pre class="lines"> 86 87 88</pre> </td> <td> <pre class="code"><span class="info file"># File 'lib/devdnsd/osx.rb', line 86</span> <span class='kw'>def</span> <span class='id identifier rubyid_action_uninstall'>action_uninstall</span> <span class='id identifier rubyid_manage_installation'>manage_installation</span><span class='lparen'>(</span><span class='id identifier rubyid_launch_agent_path'>launch_agent_path</span><span class='comma'>,</span> <span class='id identifier rubyid_resolver_path'>resolver_path</span><span class='comma'>,</span> <span class='symbol'>:delete_resolver</span><span class='comma'>,</span> <span class='symbol'>:unload_agent</span><span class='comma'>,</span> <span class='symbol'>:delete_agent</span><span class='rparen'>)</span> <span class='kw'>end</span></pre> </td> </tr> </table> </div> <div class="method_details "> <h3 class="signature " id="dns_update-instance_method"> - (<tt>Boolean</tt>) <strong>dns_update</strong> </h3><div class="docstring"> <div class="discussion"> <p>Updates DNS cache.</p> </div> </div> <div class="tags"> <p class="tag_title">Returns:</p> <ul class="return"> <li> <span class='type'>(<tt>Boolean</tt>)</span> — <div class='inline'><p><code>true</code> if command succeeded, <code>false</code> otherwise.</p> </div> </li> </ul> </div><table class="source_code"> <tr> <td> <pre class="lines"> 37 38 39 40 41 42 43 44 45 46 47 48</pre> </td> <td> <pre class="code"><span class="info file"># File 'lib/devdnsd/osx.rb', line 37</span> <span class='kw'>def</span> <span class='id identifier rubyid_dns_update'>dns_update</span> <span class='ivar'>@logger</span><span class='period'>.</span><span class='id identifier rubyid_info'>info</span><span class='lparen'>(</span><span class='id identifier rubyid_i18n'>i18n</span><span class='period'>.</span><span class='id identifier rubyid_dns_update'>dns_update</span><span class='rparen'>)</span> <span class='id identifier rubyid_script'>script</span> <span class='op'>=</span> <span class='const'>Tempfile</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>devdnsd-dns-cache-script</span><span class='tstring_end'>"</span></span><span class='rparen'>)</span> <span class='id identifier rubyid_script'>script</span><span class='period'>.</span><span class='id identifier rubyid_write'>write</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>dscacheutil -flushcache 2>&1 > /dev/null\n</span><span class='tstring_end'>"</span></span><span class='rparen'>)</span> <span class='id identifier rubyid_script'>script</span><span class='period'>.</span><span class='id identifier rubyid_write'>write</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>killall -9 mDNSResponder 2>&1 > /dev/null\n</span><span class='tstring_end'>"</span></span><span class='rparen'>)</span> <span class='id identifier rubyid_script'>script</span><span class='period'>.</span><span class='id identifier rubyid_write'>write</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>killall -9 mDNSResponderHelper 2>&1 > /dev/null\n</span><span class='tstring_end'>"</span></span><span class='rparen'>)</span> <span class='id identifier rubyid_script'>script</span><span class='period'>.</span><span class='id identifier rubyid_close'>close</span> <span class='const'>Kernel</span><span class='period'>.</span><span class='id identifier rubyid_system'>system</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>/usr/bin/osascript -e 'do shell script \"sh </span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_script'>script</span><span class='period'>.</span><span class='id identifier rubyid_path'>path</span><span class='embexpr_end'>}</span><span class='tstring_content'>\" with administrator privileges' 2>&1 > /dev/null</span><span class='tstring_end'>"</span></span><span class='rparen'>)</span> <span class='id identifier rubyid_script'>script</span><span class='period'>.</span><span class='id identifier rubyid_unlink'>unlink</span> <span class='kw'>end</span></pre> </td> </tr> </table> </div> <div class="method_details "> <h3 class="signature " id="execute_command-instance_method"> - (<tt>Boolean</tt>) <strong>execute_command</strong>(command) </h3><div class="docstring"> <div class="discussion"> <p>Executes a shell command.</p> </div> </div> <div class="tags"> <p class="tag_title">Parameters:</p> <ul class="param"> <li> <span class='name'>command</span> <span class='type'>(<tt>String</tt>)</span> — <div class='inline'><p>The command to execute.</p> </div> </li> </ul> <p class="tag_title">Returns:</p> <ul class="return"> <li> <span class='type'>(<tt>Boolean</tt>)</span> — <div class='inline'><p><code>true</code> if command succeeded, <code>false</code> otherwise.</p> </div> </li> </ul> </div><table class="source_code"> <tr> <td> <pre class="lines"> 30 31 32</pre> </td> <td> <pre class="code"><span class="info file"># File 'lib/devdnsd/osx.rb', line 30</span> <span class='kw'>def</span> <span class='id identifier rubyid_execute_command'>execute_command</span><span class='lparen'>(</span><span class='id identifier rubyid_command'>command</span><span class='rparen'>)</span> <span class='id identifier rubyid_system'>system</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>"</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_command'>command</span><span class='embexpr_end'>}</span><span class='tstring_content'> 2>&1 > /dev/null</span><span class='tstring_end'>"</span></span><span class='rparen'>)</span> <span class='kw'>end</span></pre> </td> </tr> </table> </div> <div class="method_details "> <h3 class="signature " id="launch_agent_path-instance_method"> - (<tt>String</tt>) <strong>launch_agent_path</strong>(name = "it.cowtech.devdnsd") </h3><div class="docstring"> <div class="discussion"> <p>Gets the path for the launch agent file.</p> </div> </div> <div class="tags"> <p class="tag_title">Parameters:</p> <ul class="param"> <li> <span class='name'>name</span> <span class='type'>(<tt>String</tt>)</span> <em class="default">(defaults to: <tt>"it.cowtech.devdnsd"</tt>)</em> — <div class='inline'><p>The base name for the agent.</p> </div> </li> </ul> <p class="tag_title">Returns:</p> <ul class="return"> <li> <span class='type'>(<tt>String</tt>)</span> — <div class='inline'><p>The path for the launch agent file.</p> </div> </li> </ul> </div><table class="source_code"> <tr> <td> <pre class="lines"> 22 23 24</pre> </td> <td> <pre class="code"><span class="info file"># File 'lib/devdnsd/osx.rb', line 22</span> <span class='kw'>def</span> <span class='id identifier rubyid_launch_agent_path'>launch_agent_path</span><span class='lparen'>(</span><span class='id identifier rubyid_name'>name</span> <span class='op'>=</span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>it.cowtech.devdnsd</span><span class='tstring_end'>"</span></span><span class='rparen'>)</span> <span class='const'>ENV</span><span class='lbracket'>[</span><span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>HOME</span><span class='tstring_end'>"</span></span><span class='rbracket'>]</span> <span class='op'>+</span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>/Library/LaunchAgents/</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_name'>name</span><span class='embexpr_end'>}</span><span class='tstring_content'>.plist</span><span class='tstring_end'>"</span></span> <span class='kw'>end</span></pre> </td> </tr> </table> </div> <div class="method_details "> <h3 class="signature " id="osx?-instance_method"> - (<tt>Boolean</tt>) <strong>osx?</strong> <span class="aliases">Also known as: <span class="names"><span id='is_osx?-instance_method'>is_osx?</span></span> </span> </h3><div class="docstring"> <div class="discussion"> <p>Checks if we are running on MacOS X.</p> <p>System services are only available on that platform.</p> </div> </div> <div class="tags"> <p class="tag_title">Returns:</p> <ul class="return"> <li> <span class='type'>(<tt>Boolean</tt>)</span> — <div class='inline'><p><code>true</code> if the current platform is MacOS X, <code>false</code> otherwise.</p> </div> </li> </ul> </div><table class="source_code"> <tr> <td> <pre class="lines"> 55 56 57</pre> </td> <td> <pre class="code"><span class="info file"># File 'lib/devdnsd/osx.rb', line 55</span> <span class='kw'>def</span> <span class='id identifier rubyid_osx?'>osx?</span> <span class='op'>::</span><span class='const'>RbConfig</span><span class='op'>::</span><span class='const'>CONFIG</span><span class='lbracket'>[</span><span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>host_os</span><span class='tstring_end'>'</span></span><span class='rbracket'>]</span> <span class='op'>=~</span> <span class='tstring'><span class='regexp_beg'>/</span><span class='tstring_content'>^darwin</span><span class='regexp_end'>/</span></span> <span class='kw'>end</span></pre> </td> </tr> </table> </div> <div class="method_details "> <h3 class="signature " id="resolver_path-instance_method"> - (<tt>String</tt>) <strong>resolver_path</strong>(tld = nil) </h3><div class="docstring"> <div class="discussion"> <p>Gets the path for the resolver file.</p> </div> </div> <div class="tags"> <p class="tag_title">Parameters:</p> <ul class="param"> <li> <span class='name'>tld</span> <span class='type'>(<tt>String</tt>)</span> <em class="default">(defaults to: <tt>nil</tt>)</em> — <div class='inline'><p>The TLD to manage.</p> </div> </li> </ul> <p class="tag_title">Returns:</p> <ul class="return"> <li> <span class='type'>(<tt>String</tt>)</span> — <div class='inline'><p>The path for the resolver file.</p> </div> </li> </ul> </div><table class="source_code"> <tr> <td> <pre class="lines"> 13 14 15 16</pre> </td> <td> <pre class="code"><span class="info file"># File 'lib/devdnsd/osx.rb', line 13</span> <span class='kw'>def</span> <span class='id identifier rubyid_resolver_path'>resolver_path</span><span class='lparen'>(</span><span class='id identifier rubyid_tld'>tld</span> <span class='op'>=</span> <span class='kw'>nil</span><span class='rparen'>)</span> <span class='id identifier rubyid_tld'>tld</span> <span class='op'>||=</span> <span class='ivar'>@config</span><span class='period'>.</span><span class='id identifier rubyid_tld'>tld</span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>/etc/resolver/</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_tld'>tld</span><span class='embexpr_end'>}</span><span class='tstring_end'>"</span></span> <span class='kw'>end</span></pre> </td> </tr> </table> </div> </div> </div> <div id="footer"> Generated on Wed Mar 30 19:23:43 2016 by <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a> 0.8.7.6 (ruby-2.3.0). </div> </body> </html>