aboutsummaryrefslogtreecommitdiffstatshomepage
path: root/utils
diff options
context:
space:
mode:
authorEgor Tensin <Egor.Tensin@gmail.com>2015-05-13 18:36:10 +0300
committerEgor Tensin <Egor.Tensin@gmail.com>2015-05-13 18:36:10 +0300
commit59a48c0dad5e3e5df3bb74e14af0f93907393279 (patch)
tree99f16d650a27c4d032f17fad057338ae96230caa /utils
parentutils: README update (diff)
downloadwindows7-drivers-59a48c0dad5e3e5df3bb74e14af0f93907393279.tar.gz
windows7-drivers-59a48c0dad5e3e5df3bb74e14af0f93907393279.zip
libservice: add README
Diffstat (limited to 'utils')
-rw-r--r--utils/libservice/README.md63
1 files changed, 63 insertions, 0 deletions
diff --git a/utils/libservice/README.md b/utils/libservice/README.md
new file mode 100644
index 0000000..a652f7b
--- /dev/null
+++ b/utils/libservice/README.md
@@ -0,0 +1,63 @@
+# libservice
+
+Simple service management library and utilities.
+
+## Usage
+
+### libservice.lib
+
+Clients may include the headers by `#include`ing `include/libservice/all.hpp`, which includes all of the other header files.
+
+For service management usage examples, see the utilities descriptions below.
+
+For virtual device usage examples, refer e.g. to [libnt_path_converter](https://github.com/egor-tensin/windows_drivers/tree/master/utils/libnt_path_converter).
+
+### install_service.exe
+
+ Usage: install_service.exe NAME SYS_PATH
+
+Installs a driver as a service.
+The service is started manually.
+The same as
+
+ sc create NAME type= kernel binPath= SYS_PATH
+
+### start_service.exe
+
+ Usage: start_service.exe NAME
+
+Starts a service (loading the corresponding driver).
+The same as
+
+ sc start NAME
+
+except that `start_service.exe` waits until the service is actually loaded.
+
+### stop_service.exe
+
+ Usage: stop_service.exe NAME
+
+Stops the service `NAME` (unloading the corresponding driver).
+The same as
+
+ sc stop NAME
+
+except that `stop_service.exe` waits until the service is actually stopped.
+
+### uninstall_service.exe
+
+ Usage: uninstall_service.exe NAME
+
+Uninstalls the service `NAME`, wiping the corresponding record from the registry.
+The same as
+
+ sc delete NAME
+
+## Building
+
+See [Building](https://github.com/egor-tensin/windows_drivers/tree/master/utils#building).
+
+## Licensing
+
+This project is licensed under the terms of the MIT License.
+See [Licensing](https://github.com/egor-tensin/windows_drivers#licensing) for details.