GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  TASKD (1)

NAME

taskd - Taskserver

CONTENTS

Synopsis
Description
Commands
Common Options
Configuration
Environment Variables
See Also
Reporting Bugs

SYNOPSIS

taskd <command> [options] [<args>]
taskd -v|--version
taskd -h|--help
taskd diagnostics
taskd validate <JSON | file>
taskd help [<command>]

DESCRIPTION

Taskserver is a sync server for Taskwarrior and related products.

COMMANDS

Taskserver supports several commands, which provide administrative capabilities. The commands are:

taskd init [--data <root>] [options]
  Performs a one-time initialization of the Taskserver instance. Creates the bare data structure. Either ’--data <root>’ must be specified, or TASKDDATA must be set.

taskd help <command> [options]
  Provides option and syntax help for each command.

taskd config [options] [--data <root>] [--force] [<name> [<value>]]
  Allows modification of the taskd configuration. Can add, remove, modify or list all configuration settings. Either ’--data <root>’ must be specified, or TASKDDATA must be set.

taskd server [--daemon] [options]
  Starts the server in daemon or TTY mode. While there is no interactivity, the difference is whether taskd is attached to a TTY or not.

Note that sending the HUP signal to the taskd server causes a configuration file reload before the next request is handled.

taskd add [--data <root>] org <org>
taskd add [--data <root>] group <org> <group>
taskd add [--data <root>] user <org> <user>
  Adds organizations, groups and users. Either ’--data <root>’ must be specified, or TASKDDATA must be set.

taskd remove [--data <root>] org <org>
taskd remove [--data <root>] group <org> <group>
taskd remove [--data <root>] user <org> <user>
  Removes organizations, groups and users. Either ’--data <root>’ must be specified, or TASKDDATA must be set.

taskd suspend [--data <root>] org <org>
taskd suspend [--data <root>] group <org> <group>
taskd suspend [--data <root>] user <org> <user>
  Suspends organizations, groups and users. Either ’--data <root>’ must be specified, or TASKDDATA must be set.

taskd resume [--data <root>] org <org>
taskd resume [--data <root>] group <org> <group>
taskd resume [--data <root>] user <org> <user>
  Resumes organizations, groups and users. Either ’--data <root>’ must be specified, or TASKDDATA must be set.

taskd diagnostics
  Displays diagnostic information important when reporting bugs.

taskd validate <JSON | file>
  Parses the quoted JSON string or JSON file. Useful for debugging JSON that is generated by Taskserver clients.

taskd client [options] <host:port> <file> [<file> ...]
  Sends the Taskserver request in <file> to <host:port>. Options specified must include ca.cert (for self-signed certs), client.cert, client.key.

COMMON OPTIONS

Most commands support the following options:

--NAME=VALUE
  Temporary configuration override.

--force
  Does not ask for confirmation of changes.

--quiet
  Suppresses verbose output.

--debug
  Shows debugging information.

--data <root>
  Many commands require the location of the data root, so either it must be provided as shown, or via the TASKDDATA environment variable.

CONFIGURATION

The Taskserver configuration file can be found in the top level of the data root. It is recommended that the ’taskd config’ command is used to manipulate this file.

Note that any configuration variable may be overridden on the command line using this syntax:

$ taskd server --NAME=VALUE

In all commands but one, this will _temporarily_ override the value, but with the ’init’ command, which creates a config file, overrides are made permanent.

ENVIRONMENT VARIABLES

Environment variables provide values that would otherwise be required at the command line.

TASKDDATA=<root>
  Most command require either ’--data <root>’ or this environment variable. If both are provided, the command line overrides the environment.

CREDITS & COPYRIGHTS

Copyright (C) 2010 - 2015, Göteborg Bit Factory.

Taskserver is distributed under the MIT license. See http://www.opensource.org/licenses/mit-license.php for more information.

SEE ALSO

taskdrc(5), taskdctl(1)

For more information regarding Taskserver, see the following:

The official site at
  <http://taskwarrior.org>

The official code repository at
  <https://git.tasktools.org/scm/tm/taskd.git>

You can contact the project by emailing
  <support@taskwarrior.org>

REPORTING BUGS

Bugs in Taskserver may be reported to the issue-tracker at
  <http://taskwarrior.org

Search for    or go to Top of page |  Section 1 |  Main Index


taskd 1.1.0 TASKD (1) 2015-05-10

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.