mirror of
https://github.com/arcan1s/netctl-gui.git
synced 2025-11-04 07:23:40 +00:00
362a11f0bc
+ new force request to netctl (DBus) + PointType enum + notification on hidding, + new columns in WiFi menu * improve user expierence * fix language definition * fix tests * update 3rdparty components * small refactoring
412 lines
12 KiB
HTML
412 lines
12 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="#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 will 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 VerboseWiFi()</td>
|
|
<td>returns available WiFi points in format <code>NAME|SECURITY|TYPE|FREQS|MACS|SIGNAL|ACTIVE|EXISTS</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>
|
|
<!-- /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|ESSID|ACTIVE|ENABLED</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|ESSID|ACTIVE|ENABLED</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>
|
|
<!-- /netctlgui path -->
|
|
<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>QString Information()</td>
|
|
<td>returns general information in format <code>[ActiveProfile, ActiveProfileStatus]</code></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>
|
|
<tr>
|
|
<td>QStringList VerboseInformation()</td>
|
|
<td>returns information in format <code>[isNetctlAutoActive, ProfileList, ActiveProfile, isProfileEnabled/autoIsProfileEnabled]</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>
|