fix manpage installation and update manpage

\fB,n\fP limit from n object to last object

.SS NUMBER FACILITY

\fB10k\fP = 1000

\fB1k\fP = 1 000

.br

\fB10ki\fP = 1024

\fB1ki\fP = 1 024

.br

\fB1m\fP = 1 000 ^ 2

.br

\fB1gi\fP = 1 024 ^ 3

.SS EXAMPLE

For example, See the command \fBlist\fP

For examples, See the command \fBlist\fP

.SH GENERIC COMMANDS

.br

When a user tape a command, cli check the rights from index 0 to the last, if the method and the right tql match whith command, right is applied, else it check the next rights, and if not found a matching rights, it deny the command

.TP

Example:

\fBExample :\fP

\fB[0] tql: method:* target:allow\fP

.br

\fB[1] tql: method:list target:deny\fP

  \fB--no-color\fP

No output coloration

.TP

\fBExample\fP

\fBExample :\fP

.TP

  \fBaddright id=toto "" * allow 0\fP

.br

Allow all method whith all query tql in index 0 for account toto

  \fBaddright id=toto "id=toto" list deny 0\fP

.br

Deny method list whith tql "id=toto" for account toto in index 0 (deny commands' example: list id=toto, list id:t*, ...)

.SS alias [\fIoptions\fP] [\fIname\fP] [\fIvalue\fP]

.TP

  \fBalias w "list a&con!=offline&r=cli"\fP

Setting an alias w, which list online client

.TP

  \fBalias vm "list r=vm&status=running$cpu"\fP

Setting an alias vm, which list running vm (and show cpu)

.P

\fBExample :\fP

.br

  \fBlist\fP

.br

    list all accounts

  \fBlist r=hv&cpu=2&mem>10g\fP

.br

    list hypervisor with no vm

    list hypervisor with 2 cpu and 10G memory

  \fBlist cpu>=2$pop$alloc\fP

.br

No tagdisplay custom display

.TP

\fBExample :\fP

\fB>>right id=toto\fP

.br

  a:toto

.SS shutdown [\fIoptions\fP] \fI<tql>\fP

Shutdown a physical host

The command add tql \fB&con&r~'host|hv'\fP

.TP

\fBOptions :\fP

.TP

Halt after shutdown

.TP

  \fB-F\fP

.br

do not go through init but go down real fast

\fBip\fP : ipv4 of connection

.SS WELL KNOWN TAGS

\fBh\fP : hostname (eg: access)

.br 

\fBhv\fP : hypervisor name (eg: kvmlab-1)

\fBalloc\fP : host is allowed to be selected to a migration

.br

\fBhtype\fP : hypervisor type (xen/kvm)

\fBarch\fP : hardware architecture (x86/x64)

.br

\fBlibvirtver\fP : Libvirt version

\fBchaasset\fP : blade chassis asset tag (dell tag)

.br 

\fBstatus\fP : VM status (running/paused/stopped)

\fBchaserial\fP : blade chassis serial number (dell tag)

.br 

\fBcpu\fP : cpu count

.br 

\fBrcpu\fP : reserved cpu count

\fBcpufreq\fP : cpu core frequency

.br

\fBmem\fP : memory total size

\fBcputhread\fP : total number of cpu thread

.br 

\fBmemused\fP : memory used

\fBcpuuse\fP : global cpu usage (percentage)

.br

\fBmemfree\fP : memory free

\fBdisk\fP : disk  index list (eg: 1 2 3 4)

.br 

\fBarch\fP : hardware architecture (x86/x64)

\fBdisk1_path\fP : disk 1 path (eg: /dev/vg/sex)

.br 

\fBuname\fP : output of uname command

\fBdisk1_pool\fP : storage pool back reference (eg: vg) [vmonly]

.br

\fBuptime\fP : uptime of hostname

\fBdisk1_size\fP : disk 1 size (eg: 1024)

.br 

\fBload\fP : load average

\fBdisk1_vol\fP : storage pool volume back reference (eg: titi) [vmonly]

.br

\fBos\fP: operating system (linux/windows)

\fBh\fP : hostname (eg: access)

.br 

\fBalloc\fP : host is allowed to be selected to a migration

\fBhbios\fP : host bios version and/or date (eg: A05 (01/09/2006))

.br 

\fBhvm\fP : hardware virtualisation enabled

\fBhmodel\fP : host model (eg: PowerEdge 2850)

.br

\fBnvm\fP : vm count on an hypervisor

\fBhserial\fP : host serial number (eg: Dell service tag)

.br 

\fBvmstarted\fP : started vm count on an hypervisor

\fBhtype\fP : hypervisor type (xen/kvm)

.br 

\fBvmstopped\fP : stopped vm count on an hypervisor

\fBhv\fP : hypervisor name (eg: kvmlab-1)

.br 

\fBvmpaused\fP : paused vm count on an hypervisor

\fBhvm\fP : hardware virtualisation enabled

.br

\fBversion\fP : account reported version

\fBhvendor\fP : host vendor (eg: Dell Computer Corporation)

.br 

\fBsto\fP : storage pool names (eg: vg fg)

\fBhvver\fP : hypervisor version (eg: 0.14)

.br

\fBstovg_type\fP : vg storage pool type (eg: lvm)

\fBlibvirtver\fP : Libvirt version

.br 

\fBstovg_size\fP : vg storage pool size (eg: 1042)

\fBload\fP : load average

.br 

\fBstovg_used\fP : vg storage pool used space (eg: 1)

\fBmem\fP : memory total size

.br 

\fBstovg_free\fP : vg storage pool free space (eg: 1041)

\fBmemfree\fP : memory free

.br 

\fBstovg_path\fP : vg storage pool path (eg: /dev/vg/)

\fBmemused\fP : memory used

.br 

\fBstovg_vol\fP : vg storage pool volume list (eg: sex titi toto)

\fBnvm\fP : vm count on an hypervisor

.br

\fBdisk: disk\fP  index list (eg: 1 2 3 4)

\fBos\fP : operating system (linux/windows)

.br 

\fBdisk1_path\fP : disk 1 path (eg: /dev/vg/sex)

\fBplatform\fP : python platform info

.br 

\fBdisk1_size\fP : disk 1 size (eg: 1024)

\fBrcpu\fP : reserved cpu count

.br

\fBdisk1_pool\fP : storage pool back reference (eg: vg) [vmonly]

\fBstatus\fP : VM status (running/paused/stopped)

.br

\fBdisk1_vol\fP : storage pool volume back reference (eg: titi) [vmonly]

\fBsto\fP : storage pool names (eg: vg fg)

.br

\fBvncport\fP : vnc local port (eg: 5001)

\fBstovg_free\fP : vg storage pool free space (eg: 1041)

.br 

\fBhvver\fP : hypervisor version (eg: 0.14)

\fBstovg_path\fP : vg storage pool path (eg: /dev/vg/)

.br

\fBhserial\fP : host serial number (eg: Dell service tag)

\fBstovg_size\fP : vg storage pool size (eg: 1042)

.br   

\fBhvendor\fP : host vendor (eg: Dell Computer Corporation)

\fBstovg_type\fP : vg storage pool type (eg: lvm)

.br 

\fBhmodel\fP : host model (eg: PowerEdge 2850)

\fBstovg_used\fP : vg storage pool used space (eg: 1)

.br 

\fBhbios\fP : host bios version and/or date (eg: A05 (01/09/2006))

\fBstovg_vol\fP : vg storage pool volume list (eg: sex titi toto)

.br  

\fBcputhread\fP : total number of cpu thread

\fBuname\fP : output of uname command

.br 

\fBcpufreq\fP : cpu core frequency

\fBuptime\fP : uptime of hostname

.br  

\fBcpuuse\fP : global cpu usage (percentage)

\fBversion\fP : account reported version

.br  

\fBplatform\fP : python platform info

\fBvmpaused\fP : paused vm count on an hypervisor

.br  

\fBchaserial\fP : blade chassis serial number (dell tag)

\fBvmstarted\fP : started vm count on an hypervisor

.br 

\fBchaasset\fP : blade chassis asset tag (dell tag)

\fBvmstopped\fP : stopped vm count on an hypervisor

.br 

\fBvncport\fP : vnc local port (eg: 5001)

.SS addtag [\fIoptions\fP] \fI<tql> <tag> <value>\fP

\fBExample :\fP

.TP

  \fBaddtag id=toto hello foo\fP

Create tag hello whith value foo in the account toto

Create tag hello whith value foo for account toto

.TP

  \fBaddtag r=vm hello foo\fP

Create tag hello whith value foo in all vm

Create tag hello whith value foo for all vm

.SS deltag [\fIoptions\fP] \fI<tql> <tag>\fP

show this help message and exit

.TP

  \fB-c\fP \fISET-COLOR\fP

Set custom color on [\fItag\fP]

Set custom color on [\fItag\fP].

.br

Color available : 

.br

  \fBregular :\fP

    \fIblack\fP, \fIred\fP, \fIgreen\fP, \fIyellow\fP, \fIblue\fP, \fIpurple\fP, \fIcyan\fP, \fIwhite\fP

  \fBlighted :\fP

    \fIlgrey\fP, \fIlred\fP, \fIlgreen\fP, \fIlyellow\fP, \fIlblue\fP, \fIlpurple\fP, \fIlcyan\fP, \fIlwhite\fP

  \fBunderline :\fP

    \fIured\fP, \fIugreen\fP, \fIuyellow\fP, \fIublue\fP, \fIupurple\fP, \fIucyan\fP

.TP

  \fB-C\fP

Remove custom color on [\fItag\fP]

.TP

  \fB-t\fP \fISET-TYPE\fP

Set custom type on [\fItag\fP]

Set custom type on [\fItag\fP].

.br

Type available : 

  \fIstring\fP, \fIlower\fP, \fIupper\fP, \fIsi\fP (system international), \fIsecond\fP, \fIdate\fP, \fItime\fP, \fIdatetime\fP.

.TP

  \fB-T\fP

Remove custom type on [\fItag\fP]

.TP

  \fB--list-types\fP

List allowed types

.TP 

\fBExample :\fP

.TP

  \fBtagdisplay -c red hv\fP

The tag hv is displayed with color red

.SS tags [\fIoptions\fP] [\fItql\fP]

List only static tags

  id=\fBtoto\fP foo=bar hello=bye

.br

  id=\fBtiti\fP az=qwerty

.br

List all clients' static tags 

.SH JOB COMMANDS

react, and it's the equivalent of ripping the power cord out on a physical machine.  In most

cases you will want to use the stop command instead.

The command add tql \fI&r=vm&status!=stopped\fP

.TP

\fBOptions :\fP

.TP

.SS execute [\fIoptions\fP] \fI<tql> <command>\fP

Execute a command on the remote host

The command add tql \fI&con&r~'host|hv'\fP

.TP

\fBOptions :\fP

.TP

.TP

  \fBexecute r=hv ls\fP

Execute command ls in all hosts

.TP

.B BUG:

.br

Quand il y a une erreur, il manque un retour à la ligne apres le None

.SS jobs [\fIoptions\fP] [\fItql\fP]

List jobs

.SS pause [\fIoptions\fP] \fI<tql>\fP

Pause a running vm

The command add tql \fI&r=vm&status=running\fP

.TP

\fBOptions :\fP

.TP

  \fB--no-color\fP

No output coloration

.TP

\fBExample\fP

\fBExample :\fP

.TP

  \fBpause r=vm&status=running&p=host1\fP

Pause all vm started in the hypervisor host1

.TP

\fBBUG:\fP

.br

pause --print-tql r=vm&status=running&p=it-test-4

.br

TQL: r=vm&status=running&p=it-test-4&r=vm&status=stopped

.br

le TQL devrait ressembler plus à : r=vm&status=running&p=it-test-4&r=vm&status!=stopped

.SS resume [\fIoptions\fP] \fI<tql>\fP

This will allow a previously paused vm to

now be eligible for scheduling by the underlying hypervisor.

The command add tql \fI&r=vm&status=paused\fP

.TP

\fBOptions :\fP

.TP

.SS start [\fIoptions\fP] \fI<tql>\fP

Start a stopped vm

The command add tql \fI&r=vm&status=stopped\fP

.TP

\fBOptions :\fP

.TP

stop, so there is no guarantee that it will succeed, and may take a variable length of

time depending on what services must be shutdown in the domain

The command add tql \fI&r=vm&status=running\fP

.TP

\fBOptions :\fP

.TP

.TP

\fB~/.config/cc-cli/profile\fP

file where cli profile is stored

  \fBExample :\fP

    # Options in this section is loaded is each others section

    [DEFAULT]

    hsize = 1000

    #debug = true

    # This section is loaded at start

    [cli]

    profile = lab

    [lab]

    login = snoopy

    pass = toto

    server = 192.168.0.162

    [prod]

    login = snoopy

    pass = titi

    server = 14.8.25.32

.TP

\fB~/.local/share/cc-cli/history\fP

file where cli history are stored

.TP

\fB~/.local/share/cc-cli/expert\fP

file where expert mode history are stored

.TP

\fB~/.config/cc-cli/tagdisplay\fP

file where tagdisplay options are stored

  \fBExample :\fP

    [color]

    a = lpurple

    h = lred

    pop = lyellow

    mem* = lyellow

    r = red

    id = lblue

    cpu = lyellow

    con = cyan

    [titlecolor]

    h = red

    id = cyan

    [type]

    uptime = second

    con = second

    disk* = si

    sto* = si

    mem* = bit

    [option]

    quotespace = 1

.TP

\fB~/.config/cc-cli/alias\fP

file where alias are stored

  \fBExample :\fP

    [alias]

    zzz = list r=cli&idle>300

    versions = list -t version

    hv = list r=hv&con$cpu$mem$arch%id

    vm = list r=vm&status=running$h$cpu$mem$arch%h

    userrights = rights r=cli

    lt = list -t &con%r%h$h$cpu$r$os$version$-con$mem

    ls = list &con$h$cpu$r$os$version

    w = list -l r=cli&con$os

    host = list r=host&con$cpu$mem

.SH ENVIRONNEMENT

.TP

\fBCC_SERVER\fP

.TP

\fBCC_PROFILE\fP

.SH BUG

.TP

\fBpause\fP

.br

pause --print-tql r=vm&status=running&p=it-test-4

.br

TQL: r=vm&status=running&p=it-test-4&r=vm&status=stopped

.br

le TQL devrait ressembler plus à : r=vm&status=running&p=it-test-4&r=vm&status!=stopped

.TP

\fBexecute\fP

Quand il y a une erreur, il manque un retour à la ligne apres le None

.SH AUTHOR

SmartJog IT

debian/cc-cli.1