qtservice-example-controller.html
11.4 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE html
PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<!-- controller.qdoc -->
<head>
<title>A simple Service Controller</title>
<link href="classic.css" rel="stylesheet" type="text/css" />
</head>
<body>
<table border="0" cellpadding="0" cellspacing="0" width="100%">
<tr>
<td align="left" valign="top" width="32"><img src="images/qt-logo.png" align="left" width="57" height="67" border="0" /></td>
<td width="1"> </td><td class="postheader" valign="center"><a href="index.html"><font color="#004faf">Home</font></a></td>
</tr></table><h1 class="title">A simple Service Controller<br /><span class="subtitle"></span>
</h1>
<p>It is a very simple implementation of universal command-line controller. This controller can install and control any service written using <a href="qtservice.html">QtService</a> component. It demonstrates how to use <a href="qtservicecontroller.html">QtServiceController</a> class. On Windows, this is an alternative to using the "Services" Administrative Tool or the built-in <tt>sc.exe</tt> command-line tool to control services.</p>
<p>A note about services on Windows Vista: Installing/uninstalling and starting/stopping services requires security privileges. The simplest way to achieve this is to set the "Run as Administrator" property on the executable (right-click the executable file, select Properties, and choose the Compatibilty tab in the Properties dialog). This applies even if you are logged in as Administrator. Also, the command-line shell should be started with "Run as Administrator". Note that the service itself does not need special privileges to run. Only if you want the service to be able to install itself (the -i option) or similar, then the service will need to be run as Administrator. Otherwise, the recommended procedure is to use a controller such as this example and/or the "Services" Administrative Tool to manage the service.</p>
<p>A usability hint: in some circumstances, e.g. when running this example on Windows Vista with the "Run as Administrator" property set, output will be sent to a shell window which will close immediately upon termination, not leaving the user enough time to read the output. In such cases, append the -w(ait) argument, which will make the controller wait for a keypress before terminating.</p>
<p>Here is the complete source code:</p>
<pre><span class="comment"> /****************************************************************************
**
** Copyright (C) 2013 Digia Plc and/or its subsidiary(-ies).
** Contact: http://www.qt-project.org/legal
**
** This file is part of the Qt Solutions component.
**
** You may use this file under the terms of the BSD license as follows:
**
** "Redistribution and use in source and binary forms, with or without
** modification, are permitted provided that the following conditions are
** met:
** * Redistributions of source code must retain the above copyright
** notice, this list of conditions and the following disclaimer.
** * Redistributions in binary form must reproduce the above copyright
** notice, this list of conditions and the following disclaimer in
** the documentation and/or other materials provided with the
** distribution.
** * Neither the name of Nokia Corporation and its Subsidiary(-ies) nor
** the names of its contributors may be used to endorse or promote
** products derived from this software without specific prior written
** permission.
**
** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
** "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
** LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
** A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
** OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
** SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
** LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
** DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
** THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
** OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE."
**
****************************************************************************/</span>
#include <QtCore/QStringList>
#include <QtCore/QDir>
#include <QtCore/QSettings>
#include "qtservice.h"
int processArgs(int argc, char **argv)
{
if (argc > 2) {
QString arg1(argv[1]);
if (arg1 == QLatin1String("-i") ||
arg1 == QLatin1String("-install")) {
if (argc > 2) {
QString account;
QString password;
QString path(argv[2]);
if (argc > 3)
account = argv[3];
if (argc > 4)
password = argv[4];
printf("The service %s installed.\n",
(QtServiceController::install(path, account, password) ? "was" : "was not"));
return 0;
}
} else {
QString serviceName(argv[1]);
QtServiceController controller(serviceName);
QString option(argv[2]);
if (option == QLatin1String("-u") ||
option == QLatin1String("-uninstall")) {
printf("The service \"%s\" %s uninstalled.\n",
controller.serviceName().toLatin1().constData(),
(controller.uninstall() ? "was" : "was not"));
return 0;
} else if (option == QLatin1String("-s") ||
option == QLatin1String("-start")) {
QStringList args;
for (int i = 3; i < argc; ++i)
args.append(QString::fromLocal8Bit(argv[i]));
printf("The service \"%s\" %s started.\n",
controller.serviceName().toLatin1().constData(),
(controller.start(args) ? "was" : "was not"));
return 0;
} else if (option == QLatin1String("-t") ||
option == QLatin1String("-terminate")) {
printf("The service \"%s\" %s stopped.\n",
controller.serviceName().toLatin1().constData(),
(controller.stop() ? "was" : "was not"));
return 0;
} else if (option == QLatin1String("-p") ||
option == QLatin1String("-pause")) {
printf("The service \"%s\" %s paused.\n",
controller.serviceName().toLatin1().constData(),
(controller.pause() ? "was" : "was not"));
return 0;
} else if (option == QLatin1String("-r") ||
option == QLatin1String("-resume")) {
printf("The service \"%s\" %s resumed.\n",
controller.serviceName().toLatin1().constData(),
(controller.resume() ? "was" : "was not"));
return 0;
} else if (option == QLatin1String("-c") ||
option == QLatin1String("-command")) {
if (argc > 3) {
QString codestr(argv[3]);
int code = codestr.toInt();
printf("The command %s sent to the service \"%s\".\n",
(controller.sendCommand(code) ? "was" : "was not"),
controller.serviceName().toLatin1().constData());
return 0;
}
} else if (option == QLatin1String("-v") ||
option == QLatin1String("-version")) {
bool installed = controller.isInstalled();
printf("The service\n"
"\t\"%s\"\n\n", controller.serviceName().toLatin1().constData());
printf("is %s", (installed ? "installed" : "not installed"));
printf(" and %s\n\n", (controller.isRunning() ? "running" : "not running"));
if (installed) {
printf("path: %s\n", controller.serviceFilePath().toLatin1().data());
printf("description: %s\n", controller.serviceDescription().toLatin1().data());
printf("startup: %s\n", controller.startupType() == QtServiceController::AutoStartup ? "Auto" : "Manual");
}
return 0;
}
}
}
printf("controller [-i PATH | SERVICE_NAME [-v | -u | -s | -t | -p | -r | -c CODE] | -h] [-w]\n\n"
"\t-i(nstall) PATH\t: Install the service\n"
"\t-v(ersion)\t: Print status of the service\n"
"\t-u(ninstall)\t: Uninstall the service\n"
"\t-s(tart)\t: Start the service\n"
"\t-t(erminate)\t: Stop the service\n"
"\t-p(ause)\t: Pause the service\n"
"\t-r(esume)\t: Resume the service\n"
"\t-c(ommand) CODE\t: Send a command to the service\n"
"\t-h(elp)\t\t: Print this help info\n"
"\t-w(ait)\t\t: Wait for keypress when done\n");
return 0;
}
int main(int argc, char **argv)
{
#if !defined(Q_OS_WIN)
<span class="comment">// QtService stores service settings in SystemScope, which normally require root privileges.</span>
<span class="comment">// To allow testing this example as non-root, we change the directory of the SystemScope settings file.</span>
QSettings::setPath(QSettings::NativeFormat, QSettings::SystemScope, QDir::tempPath());
qWarning("(Example uses dummy settings file: %s/QtSoftware.conf)", QDir::tempPath().toLatin1().constData());
#endif
int result = processArgs(argc, argv);
if (QString::fromLocal8Bit(argv[argc-1]) == QLatin1String("-w") ||
QString::fromLocal8Bit(argv[argc-1]) == QLatin1String("-wait")) {
printf("\nPress Enter to continue...");
QFile input;
input.open(stdin, QIODevice::ReadOnly);
input.readLine();
printf("\n");
}
return result;
}</pre>
<p /><address><hr /><div align="center">
<table width="100%" cellspacing="0" border="0"><tr class="address">
<td width="30%" align="left">Copyright © 2010 Nokia Corporation and/or its subsidiary(-ies)</td>
<td width="40%" align="center"><a href="http://qt.nokia.com/doc/trademarks.html">Trademarks</a></td>
<td width="30%" align="right"><div align="right">Qt Solutions</div></td>
</tr></table></div></address></body>
</html>