Add descriptions to the configurations

pull/656/head
Buddhika Chathuranga 2020-08-24 00:02:00 +05:30
parent 81bce5e41b
commit 0450cb177d
1 changed files with 26 additions and 6 deletions

View File

@ -12,28 +12,29 @@
"properties": { "properties": {
"id": { "id": {
"$id": "#/properties/id", "$id": "#/properties/id",
"description": "Specifies the ID that Windows uses internally to identify the service.",
"type": "string", "type": "string",
"title": "Service Id",
"maxLength": 256 "maxLength": 256
}, },
"name": { "name": {
"$id": "#/properties/name", "$id": "#/properties/name",
"description": "Short display name of the service, which can contain spaces and other characters.",
"type": "string", "type": "string",
"title": "Service Display Name",
"maxLength": 256 "maxLength": 256
}, },
"description": { "description": {
"$id": "#/properties/description", "$id": "#/properties/description",
"type": "string", "description": "Long human-readable description of the service.",
"title": "Service Description" "type": "string"
}, },
"executable": { "executable": {
"$id": "#/properties/executable", "$id": "#/properties/executable",
"type": "string", "description": "This element specifies the executable to be launched.",
"title": "Service Description" "type": "string"
}, },
"executablePath": { "executablePath": {
"$id": "#/properties/executablePath", "$id": "#/properties/executablePath",
"description": "Path to the WinSW executable",
"type": "string" "type": "string"
}, },
"hideWindow": { "hideWindow": {
@ -42,10 +43,12 @@
}, },
"workingdirectory": { "workingdirectory": {
"$id": "#/properties/workingdirectory", "$id": "#/properties/workingdirectory",
"description": "Some services need to run with a working directory specified. To do this, specify the workingdirectory element",
"type": "string" "type": "string"
}, },
"serviceAccount": { "serviceAccount": {
"$id": "#/properties/serviceAccount", "$id": "#/properties/serviceAccount",
"description": "Defines account, under which the service should run.",
"type": "object", "type": "object",
"properties": { "properties": {
"user": { "user": {
@ -68,6 +71,7 @@
}, },
"log": { "log": {
"$id": "#/properties/log", "$id": "#/properties/log",
"description": "All the log details. Read the loggingAndErrorreporting.md for more details",
"type": "object", "type": "object",
"properties": { "properties": {
"mode": { "mode": {
@ -140,29 +144,35 @@
}, },
"download": { "download": {
"$id": "#/properties/download", "$id": "#/properties/download",
"description": "This optional element can be specified to have the service wrapper retrieve resources from URL and place it locally as a file.",
"type": "array", "type": "array",
"items": { "items": {
"$ref": "#/definitions/download" "$ref": "#/definitions/download"
} }
}, },
"arguments": { "arguments": {
"description": "Specifies the arguments to be passed to the executable. User can specify all the commands as a single line.",
"$id": "#/properties/arguments", "$id": "#/properties/arguments",
"type": "string" "type": "string"
}, },
"startArguments": { "startArguments": {
"description": "When you use the stoparguments you must use startarguments instead of arguments",
"$id": "#/properties/startArguments", "$id": "#/properties/startArguments",
"type": "string" "type": "string"
}, },
"stopArguments": { "stopArguments": {
"$id": "#/properties/stopArguments", "$id": "#/properties/stopArguments",
"description": "If this configurations is present WinSW will launch another process of executable or stopexecutable (if specified) with stoparguments instead terminating the WinSW process.",
"type": "string" "type": "string"
}, },
"stopExecutable": { "stopExecutable": {
"$id": "#/properties/stopExecutable", "$id": "#/properties/stopExecutable",
"description": "If stoparguments is present then WinSW will laungh this executable with stoparguments instead terminating the WinSW process.",
"type": "string" "type": "string"
}, },
"stopParentProcessFirst": { "stopParentProcessFirst": {
"$id": "#/properties/stopParentProcessFirst", "$id": "#/properties/stopParentProcessFirst",
"description": "Optionally specify the order of service shutdown. If configed as true, parent process is shutdown first",
"$ref": "#/definitions/boolPattern" "$ref": "#/definitions/boolPattern"
}, },
"resetFailureAfter": { "resetFailureAfter": {
@ -171,10 +181,12 @@
}, },
"stopTimeout": { "stopTimeout": {
"$id": "#/properties/stopTimeout", "$id": "#/properties/stopTimeout",
"description": "This optional element allows you to change this 15 seconds value, so that you can control how long winsw gives the service to shut itself down.",
"type": "string" "type": "string"
}, },
"startMode": { "startMode": {
"$id": "#/properties/startMode", "$id": "#/properties/startMode",
"description": "This element specifies the start mode of the Windows service.",
"type": "string", "type": "string",
"enum": [ "enum": [
"Boot", "Boot",
@ -186,6 +198,7 @@
}, },
"serviceDependencies": { "serviceDependencies": {
"$id": "#/properties/serviceDependencies", "$id": "#/properties/serviceDependencies",
"description": "Optionally specified depend services that must start before this service starts.",
"type": "array", "type": "array",
"items": { "items": {
"type": "string" "type": "string"
@ -201,10 +214,12 @@
}, },
"interactive": { "interactive": {
"$id": "#/properties/interactive", "$id": "#/properties/interactive",
"description": "If this optional element is specified, the service will be allowed to interact with the desktop, such as by showing a new window and dialog boxes.",
"$ref": "#/definitions/boolPattern" "$ref": "#/definitions/boolPattern"
}, },
"priority": { "priority": {
"$id": "#/properties/priority", "$id": "#/properties/priority",
"description": "Optionally specify the scheduling priority of the service process.",
"type": "string", "type": "string",
"enum": [ "enum": [
"Normal", "Normal",
@ -217,16 +232,20 @@
}, },
"beepOnShutdown": { "beepOnShutdown": {
"$id": "#/properties/beepOnShutdown", "$id": "#/properties/beepOnShutdown",
"description": "This optional element is to emit beepsound when the service shuts down.",
"$ref": "#/definitions/boolPattern" "$ref": "#/definitions/boolPattern"
}, },
"env": { "env": {
"$id": "#/properties/env", "$id": "#/properties/env",
"description": "User can use specify environment variables with this configurations. Variables will be expand while parsing.",
"type": "array", "type": "array",
"items": { "items": {
"$ref": "#/definitions/env" "$ref": "#/definitions/env"
} }
}, },
"delayedAutoStart": { "delayedAutoStart": {
"$id": "#/properties/delayedAutoStart",
"description": "This Boolean option enables the delayed start mode if the Automatic start mode is defined. ",
"$ref": "#/definitions/boolPattern" "$ref": "#/definitions/boolPattern"
}, },
"securityDescriptor": { "securityDescriptor": {
@ -235,6 +254,7 @@
}, },
"extensions": { "extensions": {
"$id": "#/properties/extensions", "$id": "#/properties/extensions",
"description": "Read extension.md for more details",
"type": "array", "type": "array",
"items": { "items": {
"$ref": "#/definitions/extensions" "$ref": "#/definitions/extensions"