mirror of
https://github.com/arcan1s/netctl-gui.git
synced 2025-04-24 15:37:23 +00:00
479 lines
15 KiB
HTML
479 lines
15 KiB
HTML
<!doctype html>
|
|
<html>
|
|
<head>
|
|
<meta http-equiv="content-type" content="text/html; charset=utf-8">
|
|
<title>netctl-gui DBus API desription</title>
|
|
<style type="text/css">
|
|
table {
|
|
width: 100%;
|
|
border-collapse: collapse;
|
|
}
|
|
th, td {
|
|
padding: 5px 10px;
|
|
border: 1px solid #000000;
|
|
};
|
|
td {
|
|
text-align: justify;
|
|
}
|
|
th {
|
|
text-align: center;
|
|
}
|
|
th.sub {
|
|
font-style: italic;
|
|
font-weight: normal;
|
|
}
|
|
small {
|
|
font-size: 70%;
|
|
}
|
|
</style>
|
|
</head>
|
|
<body>
|
|
|
|
<h1>netctl-gui DBus API description</h1>
|
|
<h3>Project version : @PROJECT_VERSION@</h3>
|
|
<ol>
|
|
<li><a href="#api">DBus API</a></li>
|
|
<li><a href="#helper">Helper API</a></li>
|
|
<li><a href="#ctrl">Helper ctrl API</a></li>
|
|
<li><a href="#interface">Helper interface API</a></li>
|
|
<li><a href="#netctl">Helper netctl API</a></li>
|
|
<li><a href="#gui">GUI API</a></li>
|
|
<li><a href="#netctlgui">GUI netctlgui API</a></li>
|
|
<li><a href="#links">External links</a></li>
|
|
</ol>
|
|
|
|
<h2><a href="#api" class="anchor" id="api"></a>DBus API</h2>
|
|
<table>
|
|
<tbody><tr>
|
|
<th>method</th>
|
|
<th>responce</th>
|
|
<th>run as root</th>
|
|
</tr>
|
|
<!-- helper service -->
|
|
<tr>
|
|
<th colspan="3"><a href="#helper" class="anchor" id="helper"></a><code>org.netctlgui.helper</code> service (system bus)</th>
|
|
</tr>
|
|
<!-- /ctrl path -->
|
|
<tr>
|
|
<th colspan="3" class="sub"><a href="#ctrl" class="anchor" id="ctrl"></a><code>/ctrl</code> path</th>
|
|
</tr>
|
|
<!-- helper actions -->
|
|
<tr>
|
|
<td>bool Active()</td>
|
|
<td><code>true</code> if the helper is active</td>
|
|
<td>no</td>
|
|
</tr>
|
|
<tr>
|
|
<td>QString ApiDocs()</td>
|
|
<td>returns path to this API documentation</td>
|
|
<td>no</td>
|
|
</tr>
|
|
<tr>
|
|
<td>bool Close()</td>
|
|
<td><code>true</code> and closes the helper</td>
|
|
<td>no</td>
|
|
</tr>
|
|
<tr>
|
|
<td>QStringList FindSettings()</td>
|
|
<td>scans system and suggests the recommended configuration which may be used by the library</td>
|
|
<td>no</td>
|
|
</tr>
|
|
<tr>
|
|
<td>QString LibraryDocs()</td>
|
|
<td>returns path to the library documentation</td>
|
|
<td>no</td>
|
|
</tr>
|
|
<tr>
|
|
<td>QString Pony()</td>
|
|
<td>prints Pinkie Pie to stdout. Really, just try</td>
|
|
<td>no</td>
|
|
</tr>
|
|
<tr>
|
|
<td>QString SecurityDocs()</td>
|
|
<td>returns path to the security documentation</td>
|
|
<td>no</td>
|
|
</tr>
|
|
<tr>
|
|
<td>QStringList Settings()</td>
|
|
<td>current helper settings <code>KEY==VALUE</code></td>
|
|
<td>no</td>
|
|
</tr>
|
|
<tr>
|
|
<td>QStringList UIDs()</td>
|
|
<td>returns the helper process UIDs <code>[UID, EUID]</code></td>
|
|
<td>no</td>
|
|
</tr>
|
|
<tr>
|
|
<td>bool Update()</td>
|
|
<td>calls update the helper configuration. Returns <code>true</code></td>
|
|
<td>no</td>
|
|
</tr>
|
|
<!-- netctl actions -->
|
|
<tr>
|
|
<td>bool Enable(QString profile)</td>
|
|
<td>enables or disables the profile. Returns <code>true</code> if action has been performed successfully</td>
|
|
<td>yes</td>
|
|
</tr>
|
|
<tr>
|
|
<td>bool forceStart(QString profile)</td>
|
|
<td>force starts the profile. Returns <code>true</code> if action has been performed successfully</td>
|
|
<td>yes</td>
|
|
</tr>
|
|
<tr>
|
|
<td>bool forceStop(QString profile)</td>
|
|
<td>force stops the profile. Returns <code>true</code> if action has been performed successfully</td>
|
|
<td>yes</td>
|
|
</tr>
|
|
<tr>
|
|
<td>bool Reenable(QString profile)</td>
|
|
<td>reenables the profile. Returns <code>true</code> if action has been performed successfully</td>
|
|
<td>yes</td>
|
|
</tr>
|
|
<tr>
|
|
<td>bool Restart(QString profile)</td>
|
|
<td>restarts the profile. Returns <code>true</code> if action has been performed successfully</td>
|
|
<td>yes</td>
|
|
</tr>
|
|
<tr>
|
|
<td>bool Start(QString profile)</td>
|
|
<td>starts or stops the profile. Returns <code>true</code> if action has been performed successfully</td>
|
|
<td>yes</td>
|
|
</tr>
|
|
<tr>
|
|
<td>bool StopAll()</td>
|
|
<td>stops all active profiles. Returns <code>true</code> if action has been performed successfully</td>
|
|
<td>yes</td>
|
|
</tr>
|
|
<tr>
|
|
<td>bool SwitchTo(QString profile)</td>
|
|
<td>switchs to the profile. Returns <code>true</code> if action has been performed successfully</td>
|
|
<td>yes</td>
|
|
</tr>
|
|
<tr>
|
|
<td>bool Create(QString profile, QStringList settingsList)</td>
|
|
<td>creates the profile with specified settings. Settings should be given in the format <code>KEY==VALUE</code>. Returns <code>true</code> if action has been performed successfully</td>
|
|
<td>yes</td>
|
|
</tr>
|
|
<tr>
|
|
<td>bool Remove(QString profile)</td>
|
|
<td>removes the profile. Returns <code>true</code> if action has been performed successfully</td>
|
|
<td>yes</td>
|
|
</tr>
|
|
<!-- netctl-auto actions -->
|
|
<tr>
|
|
<td>bool autoDisableAll()</td>
|
|
<td>disables all profiles (netctl-auto). Returns <code>true</code> if action has been performed successfully</td>
|
|
<td>no?</td>
|
|
</tr>
|
|
<tr>
|
|
<td>bool autoEnable(QString profile)</td>
|
|
<td>enables or disables the profile (netctl-auto). Returns <code>true</code> if action has been performed successfully</td>
|
|
<td>no?</td>
|
|
</tr>
|
|
<tr>
|
|
<td>bool autoEnableAll()</td>
|
|
<td>enables all profiles (netctl-auto). Returns <code>true</code> if action has been performed successfully</td>
|
|
<td>no?</td>
|
|
</tr>
|
|
<tr>
|
|
<td>bool autoStart(QString profile)</td>
|
|
<td>switchs to the profile (netctl-auto). Returns <code>true</code> if action has been performed successfully</td>
|
|
<td>no?</td>
|
|
</tr>
|
|
<!-- netctl-auto service actions -->
|
|
<tr>
|
|
<td>bool autoServiceEnable()</td>
|
|
<td>enables or disables netctl-auto systemd service. Returns <code>true</code> if action has been performed successfully</td>
|
|
<td>yes</td>
|
|
</tr>
|
|
<tr>
|
|
<td>bool autoServiceRestart()</td>
|
|
<td>restarts netctl-auto systemd service. Returns <code>true</code> if action has been performed successfully</td>
|
|
<td>yes</td>
|
|
</tr>
|
|
<tr>
|
|
<td>bool autoServiceStart()</td>
|
|
<td>starts or stops netctl-auto systemd service. Returns <code>true</code> if action has been performed successfully</td>
|
|
<td>yes</td>
|
|
</tr>
|
|
<!-- wpa_supplicant actions -->
|
|
<tr>
|
|
<td>QStringList CurrentWiFi()</td>
|
|
<td>returns current WiFi point in format <code>NAME|SECURITY|TYPE|FREQ|MAC|SIGNAL|ACTIVE|EXISTS</code></td>
|
|
<td>yes</td>
|
|
</tr>
|
|
<tr>
|
|
<td>QStringList VerboseWiFi()</td>
|
|
<td>returns available WiFi points in format <code>NAME|SECURITY|TYPE|FREQS|MACS|SIGNAL|ACTIVE|EXISTS</code>. First line is always active connection (see <code>CurrentWiFi()</code>)</td>
|
|
<td>yes</td>
|
|
</tr>
|
|
<tr>
|
|
<td>QStringList WiFi()</td>
|
|
<td>returns available WiFi points in format <code>NAME|SECURITY|SIGNAL|ACTIVE|EXISTS</code></td>
|
|
<td>yes</td>
|
|
</tr>
|
|
<!-- /interface path -->
|
|
<tr>
|
|
<th colspan="3" class="sub"><a href="#interface" class="anchor" id="interface"></a><code>/interface</code> path</th>
|
|
</tr>
|
|
<!-- netctl control -->
|
|
<tr>
|
|
<td>int Enable(QString profile)</td>
|
|
<td>enables or disables the profile. Returns is the profile enabled or <code>2</code> if there was an another error</td>
|
|
<td>yes</td>
|
|
</tr>
|
|
<tr>
|
|
<td>int Restart(QString profile)</td>
|
|
<td>restarts the profile. Returns is the profile active or <code>2</code> if there was an error</td>
|
|
<td>yes</td>
|
|
</tr>
|
|
<tr>
|
|
<td>int Start(QString profile)</td>
|
|
<td>starts or stops the profile. Returns is the profile active or <code>2</code> if there was an error</td>
|
|
<td>yes</td>
|
|
</tr>
|
|
<tr>
|
|
<td>bool StopAll()</td>
|
|
<td>synonym of <code>/ctlr/StopAll()</code></td>
|
|
<td>yes</td>
|
|
</tr>
|
|
<tr>
|
|
<td>bool SwitchTo(QString profile)</td>
|
|
<td>switchs to the profile (works with netctl and netctl-auto). Returns is the profile active or <code>2</code> if there was an error</td>
|
|
<td>yes</td>
|
|
</tr>
|
|
<tr>
|
|
<td>int Create(QString profile, QStringList settingsList)</td>
|
|
<td>>creates the profile with specified settings. Settings should be given in the format <code>KEY==VALUE</code>. Returns <code>1</code> if action has been performed successfully, <code>0</code> if there was an error in the profile copying and <code>2</code> if there was an another error</td>
|
|
<td>yes</td>
|
|
</tr>
|
|
<tr>
|
|
<td>QStringList Profile(QString profile)</td>
|
|
<td>synonym of <code>/netctl/Profile()</code></td>
|
|
<td>no</td>
|
|
</tr>
|
|
<tr>
|
|
<td>int Remove(QString profile)</td>
|
|
<td>synonym of <code>/ctrl/Remove()</code></td>
|
|
<td>yes</td>
|
|
</tr>
|
|
<!-- information -->
|
|
<tr>
|
|
<td>QStringList Information()</td>
|
|
<td>returns general information in format <code>[IsNetctlAutoActive, NetctlProfiles, NetctlAutoProfiles]</code></td>
|
|
<td>no</td>
|
|
</tr>
|
|
<tr>
|
|
<td>QStringList Status()</td>
|
|
<td>returns actual information in format <code>[IsNetctlAutoActive, ProfilesNames, ActiveProfile, ActiveProfileEnables]</code></td>
|
|
<td>no</td>
|
|
</tr>
|
|
<!-- wpa_supplicant actions -->
|
|
<tr>
|
|
<td>int Essid(QString essid, QStringList settingsList)</td>
|
|
<td>connects to WiFi point with the given ESSID, calls KnownEssid or UnknownESSID depending on whether there is a profile. Settings may be empty. To get return codes refer to <code>KnownEssid()</code> and <code>UnknownEssid()</code></td>
|
|
<td>yes</td>
|
|
</tr>
|
|
<tr>
|
|
<td>int KnownEssid(QString essid)</td>
|
|
<td>connects to WiFi point with the given ESSID with existent profile. Returns <code>Start()</code> if ok, in other cases returns <code>2</code></td>
|
|
<td>yes</td>
|
|
</tr>
|
|
<tr>
|
|
<td>int UnknownEssid(QString essid, QStringList settingsList)</td>
|
|
<td>creates a profile and connects to WiFi point with the given ESSID. Returns <code>Start()</code> if ok, in other cases returns <code>2</code></td>
|
|
<td>yes</td>
|
|
</tr>
|
|
<!-- /netctl path -->
|
|
<tr>
|
|
<th colspan="3" class="sub"><a href="#netctl" class="anchor" id="netctl"></a><code>/netctl</code> path</th>
|
|
</tr>
|
|
<!-- general information -->
|
|
<tr>
|
|
<td>QString ActiveProfile()</td>
|
|
<td>returns active profile from netctl or netctl-auto</td>
|
|
<td>no</td>
|
|
</tr>
|
|
<tr>
|
|
<td>QString ActiveProfileStatus()</td>
|
|
<td>returns active profile status from netctl or netctl-auto. May be <code>netctl-auto</code>, <code>active (enabled)</code>, <code>active (static)</code>, <code>inactive (enabled)</code>, <code>inactive (static)</code></td>
|
|
<td>no</td>
|
|
</tr>
|
|
<tr>
|
|
<td>QStringList Information()</td>
|
|
<td>returns general information in format <code>[ActiveProfile, ActiveProfileStatus]</code></td>
|
|
<td>no</td>
|
|
</tr>
|
|
<tr>
|
|
<td>QString netctlActiveProfile()</td>
|
|
<td>returns active profile from netctl even if netctl-auto is running</td>
|
|
<td>no</td>
|
|
</tr>
|
|
<tr>
|
|
<td>QStringList netctlProfileList()</td>
|
|
<td>returns available profiles in format <code>NAME|DESCRIPTION|ACTIVE|ENABLED</code> from netctl even if netctl-auto is running</td>
|
|
<td>no</td>
|
|
</tr>
|
|
<tr>
|
|
<td>QStringList netctlVerboseProfileList()</td>
|
|
<td>returns available profiles in format <code>NAME|DESCRIPTION|TYPE|INTERFACE|ESSID|ACTIVE|ENABLED|NETCTL-AUTO</code> from netctl even if netctl-auto is running</td>
|
|
<td>no</td>
|
|
</tr>
|
|
<tr>
|
|
<td>QStringList ProfileList()</td>
|
|
<td>returns available profiles in format <code>NAME|DESCRIPTION|ACTIVE|ENABLED</code></td>
|
|
<td>no</td>
|
|
</tr>
|
|
<tr>
|
|
<td>QStringList VerboseProfileList()</td>
|
|
<td>returns available profiles in format <code>NAME|DESCRIPTION|TYPE|INTERFACE|ESSID|ACTIVE|ENABLED|NETCTL-AUTO</code></td>
|
|
<td>no</td>
|
|
</tr>
|
|
<tr>
|
|
<td>QStringList WirelessInterface()</td>
|
|
<td>returns wireless interfaces</td>
|
|
<td>no</td>
|
|
</tr>
|
|
<!-- netctl specific information -->
|
|
<tr>
|
|
<td>bool isProfileActive(QString profile)</td>
|
|
<td>returns <code>true</code> if the profile is active</td>
|
|
<td>no</td>
|
|
</tr>
|
|
<tr>
|
|
<td>bool isProfileEnabled(QString profile)</td>
|
|
<td>returns <code>true</code> if the profile is enabled</td>
|
|
<td>no</td>
|
|
</tr>
|
|
<!-- netctl-auto specific information -->
|
|
<tr>
|
|
<td>bool autoIsProfileActive(QString profile)</td>
|
|
<td>returns <code>true</code> if the profile is active (netctl-auto)</td>
|
|
<td>no</td>
|
|
</tr>
|
|
<tr>
|
|
<td>bool autoIsProfileEnabled(QString profile)</td>
|
|
<td>returns <code>true</code> if the profile is enabled (netctl-auto)</td>
|
|
<td>no</td>
|
|
</tr>
|
|
<tr>
|
|
<td>bool isNetctlAutoActive()</td>
|
|
<td>returns <code>true</code> if netctl-auto is active</td>
|
|
<td>no</td>
|
|
</tr>
|
|
<tr>
|
|
<td>bool isNetctlAutoEnabled()</td>
|
|
<td>returns <code>true</code> if netctl-auto is enabled</td>
|
|
<td>no</td>
|
|
</tr>
|
|
<!-- profile information -->
|
|
<tr>
|
|
<td>QStringList Profile(QString profile)</td>
|
|
<td>returns the profile settings in format <code>KEY==VALUE</code></td>
|
|
<td>no</td>
|
|
</tr>
|
|
<tr>
|
|
<td>QString ProfileByEssid(QString essid)</td>
|
|
<td>returns the profile name by the given ESSID or empty line</td>
|
|
<td>no</td>
|
|
</tr>
|
|
<tr>
|
|
<td>QString ProfileValue(QString profile, QString key)</td>
|
|
<td>returns value of the key by the given profile or empty line</td>
|
|
<td>no</td>
|
|
</tr>
|
|
<tr>
|
|
<td>QStringList ProfileValues(QString profile, QStringList keys)</td>
|
|
<td>returns values of the keys by the given profile or empty lines</td>
|
|
<td>no</td>
|
|
</tr>
|
|
<!-- gui service -->
|
|
<tr>
|
|
<th colspan="3"><a href="#gui" class="anchor" id="gui"></a><code>org.netctlgui.netctlgui</code> service (session bus)</th>
|
|
</tr>
|
|
<tr>
|
|
<th colspan="3" class="sub"><a href="#netctlgui" class="anchor" id="netctlgui"></a><code>/netctlgui</code> path</th>
|
|
</tr>
|
|
<!-- gui actions -->
|
|
<tr>
|
|
<td>bool Active()</td>
|
|
<td><code>true</code> if the application is active</td>
|
|
<td>no</td>
|
|
</tr>
|
|
<tr>
|
|
<td>void ApiDocs()</td>
|
|
<td>opens this API documentation</td>
|
|
<td>no</td>
|
|
</tr>
|
|
<tr>
|
|
<td>bool Close()</td>
|
|
<td><code>true</code> and closes the application</td>
|
|
<td>no</td>
|
|
</tr>
|
|
<tr>
|
|
<td>void LibraryDocs()</td>
|
|
<td>opens the library documentation</td>
|
|
<td>no</td>
|
|
</tr>
|
|
<tr>
|
|
<td>QString Pony()</td>
|
|
<td>prints Pinkie Pie to stdout. Really, just try</td>
|
|
<td>no</td>
|
|
</tr>
|
|
<tr>
|
|
<td>bool Restore()</td>
|
|
<td><code>true</code> and restores the application</td>
|
|
<td>no</td>
|
|
</tr>
|
|
<tr>
|
|
<td>void SecurityDocs()</td>
|
|
<td>opens the security documentation</td>
|
|
<td>no</td>
|
|
</tr>
|
|
<tr>
|
|
<td>QStringList Settings()</td>
|
|
<td>current application settings <code>KEY==VALUE</code></td>
|
|
<td>no</td>
|
|
</tr>
|
|
<tr>
|
|
<td>bool ShowAbout()</td>
|
|
<td><code>true</code> and shows about window</td>
|
|
<td>no</td>
|
|
</tr>
|
|
<tr>
|
|
<td>bool ShowMain()</td>
|
|
<td><code>true</code> and shows main window</td>
|
|
<td>no</td>
|
|
</tr>
|
|
<tr>
|
|
<td>bool ShowNetctlAuto()</td>
|
|
<td><code>true</code> and shows netctl-auto window</td>
|
|
<td>no</td>
|
|
</tr>
|
|
<tr>
|
|
<td>bool ShowSettings()</td>
|
|
<td><code>true</code> and shows settings window</td>
|
|
<td>no</td>
|
|
</tr>
|
|
<tr>
|
|
<td>QStringList UIDs()</td>
|
|
<td>returns the application process UIDs <code>[UID, EUID]</code></td>
|
|
<td>no</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<h2><a href="#links" class="anchor" id="links"></a>External links</h2>
|
|
<ul>
|
|
<li><a href="http://arcanis.name/projects/netctl-gui/">Homepage</a></li>
|
|
<li><a href="https://github.com/arcan1s/netctl-gui">Repository</a></li>
|
|
<li><a href="https://github.com/arcan1s/netctl-gui/issues">Bugtracker</a></li>
|
|
</ul>
|
|
|
|
<small>
|
|
© 2014-@CURRENT_YEAR@ <a href="mailto:@PROJECT_CONTACT@">@PROJECT_AUTHOR@</a><br>
|
|
This software is licensed under @PROJECT_LICENSE@
|
|
</small>
|
|
|
|
</body>
|
|
</html>
|