maj de l'arborescence de la doc
This commit is contained in:
parent
96b1866049
commit
2425cbe0f8
|
|
@ -1,25 +0,0 @@
|
|||
# -*- coding: utf-8 mode: markdown -*- vim:sw=4:sts=4:et:ai:si:sta:fenc=utf-8
|
||||
# Pense-bête:
|
||||
# ''bold'' ==striked== __underline__ //italic// ^^super^^ ~~sub~~
|
||||
# @@highlight@@ @@color:red;background-color:white; rouge sur noir@@
|
||||
# ~NotAWikiWord [[force wikiword]] [[friendly name|WikiWord]]
|
||||
# [[external|http://site.com]] ---- {{monospace}}
|
||||
# !h1 !!h2 !!!h3 !!!!h4 !!!!!h5
|
||||
# * dotlist ** sublist # numlist ## sublist
|
||||
# {{{ |caption|c [img[title|filename]]
|
||||
# pre text |!header|!header|h [img[filename]]
|
||||
# }}} |cell|cell| [img[title|filename][link]]
|
||||
# <<< |>|colspan| [img[filename][link]]
|
||||
# blockquote |rowspan|one| [<img[filename]]
|
||||
# <<< |~|two| [>img[filename]]
|
||||
# >quote1 |left| right|
|
||||
# >>quote2 |>| center |
|
||||
# >>>quote3
|
||||
##@creator: jclain
|
||||
##@created: 09/03/2012 05:08
|
||||
##@modifier: jclain
|
||||
##@changecount: 1
|
||||
##@tags:
|
||||
##@title: DefaultTiddlers
|
||||
|
||||
[[Main]]
|
||||
|
|
@ -1,16 +0,0 @@
|
|||
# -*- coding: utf-8 mode: markdown -*- vim:sw=4:sts=4:et:ai:si:sta:fenc=utf-8
|
||||
##@creator: jclain
|
||||
##@created: 15/03/2012 22:19
|
||||
##@modifier: jclain
|
||||
##@changecount: 1
|
||||
##@tags:
|
||||
##@title: EnsureVM
|
||||
|
||||
{{{
|
||||
EnsureVM: s'assurer que les services sont lancés pour un type de virtualisation
|
||||
|
||||
USAGE
|
||||
EnsureVM type
|
||||
|
||||
Les types supportés sont virtualbox et kvm (par défaut)
|
||||
}}}
|
||||
46
doc/Main.twp
46
doc/Main.twp
|
|
@ -1,46 +0,0 @@
|
|||
# -*- coding: utf-8 mode: markdown -*- vim:sw=4:sts=4:et:ai:si:sta:fenc=utf-8
|
||||
# Pense-bête:
|
||||
# ''bold'' ==striked== __underline__ //italic// ^^super^^ ~~sub~~
|
||||
# @@highlight@@ @@color:red;background-color:white; rouge sur noir@@
|
||||
# ~NotAWikiWord [[force wikiword]] [[friendly name|WikiWord]]
|
||||
# [[external|http://site.com]] ---- {{monospace}}
|
||||
# !h1 !!h2 !!!h3 !!!!h4 !!!!!h5
|
||||
# * dotlist ** sublist # numlist ## sublist
|
||||
# {{{ |caption|c [img[title|filename]]
|
||||
# pre text |!header|!header|h [img[filename]]
|
||||
# }}} |cell|cell| [img[title|filename][link]]
|
||||
# <<< |>|colspan| [img[filename][link]]
|
||||
# blockquote |rowspan|one| [<img[filename]]
|
||||
# <<< |~|two| [>img[filename]]
|
||||
# >quote1 |left| right|
|
||||
# >>quote2 |>| center |
|
||||
# >>>quote3
|
||||
##@creator: jclain
|
||||
##@created: 09/03/2012 05:08
|
||||
##@modifier: jclain
|
||||
##@changecount: 1
|
||||
##@tags:
|
||||
##@title: Main
|
||||
|
||||
!Présentation
|
||||
nutools est un ensemble d'utilitaires pour faciliter l'utililisation des Unixes, en particulier Linux, mais aussi MacOS X et Cygwin.
|
||||
C'est aussi une librairie de scripts shell réutilisables ([[ulib]]) et une librairie de modules python réutilisables (pyulib)
|
||||
|
||||
!Prérequis
|
||||
Python >= 2.3 et GNU Awk sont requis pour que toutes les fonctionnalités soient supportées.
|
||||
* Sous Linux, lors de l'installation du package, les meilleurs efforts sont fait pour que ces packages soient installés.
|
||||
* Sous MacOSX, il faut installer manuellement Fink, DarwinPorts ou Homebrew
|
||||
|
||||
! Outils
|
||||
Chaque outil contient une aide intégrée. Il suffit de lancer l'outil avec l'argument {{{--help}}} pour avoir une aide détaillée.
|
||||
* Déploiement d'un répertoire ou d'une archive
|
||||
** [[uinst]]: Déploiement local
|
||||
** [[mkusfx]]: Faire une archive auto-installable avec uinst
|
||||
** [[ruinst]]: Déploiement distant avec uinst
|
||||
** [[runs]]: Lancer un script avec le protocole RUNS
|
||||
** [[rruns]]: Déploiement distant avec runs
|
||||
* Librairie réutilisable de scripts shell
|
||||
** [[uinc]]: Dépliage des inclusions dans un fichier
|
||||
** [[ulibsync]]: Faire une copie locale pour un projet de ulib et/ou pyulib
|
||||
* Autres outils
|
||||
** [[udir]]: Gestion des paramètres d'un répertoire. Ces paramètres sont entre autres utilisés par uinst et uinc.
|
||||
|
|
@ -1,25 +0,0 @@
|
|||
# -*- coding: utf-8 mode: markdown -*- vim:sw=4:sts=4:et:ai:si:sta:fenc=utf-8
|
||||
# Pense-bête:
|
||||
# ''bold'' ==striked== __underline__ //italic// ^^super^^ ~~sub~~
|
||||
# @@highlight@@ @@color:red;background-color:white; rouge sur noir@@
|
||||
# ~NotAWikiWord [[force wikiword]] [[friendly name|WikiWord]]
|
||||
# [[external|http://site.com]] ---- {{monospace}}
|
||||
# !h1 !!h2 !!!h3 !!!!h4 !!!!!h5
|
||||
# * dotlist ** sublist # numlist ## sublist
|
||||
# {{{ |caption|c [img[title|filename]]
|
||||
# pre text |!header|!header|h [img[filename]]
|
||||
# }}} |cell|cell| [img[title|filename][link]]
|
||||
# <<< |>|colspan| [img[filename][link]]
|
||||
# blockquote |rowspan|one| [<img[filename]]
|
||||
# <<< |~|two| [>img[filename]]
|
||||
# >quote1 |left| right|
|
||||
# >>quote2 |>| center |
|
||||
# >>>quote3
|
||||
##@creator: jclain
|
||||
##@created: 09/03/2012 05:08
|
||||
##@modifier: jclain
|
||||
##@changecount: 1
|
||||
##@tags:
|
||||
##@title: MainMenu
|
||||
|
||||
[[GettingStarted]]
|
||||
40
doc/SKvm.twp
40
doc/SKvm.twp
|
|
@ -1,40 +0,0 @@
|
|||
# -*- coding: utf-8 mode: markdown -*- vim:sw=4:sts=4:et:ai:si:sta:fenc=utf-8
|
||||
##@creator: jclain
|
||||
##@created: 27/04/2016 03:19
|
||||
##@modifier: jclain
|
||||
##@changecount: 1
|
||||
##@tags:
|
||||
##@title: SKvm
|
||||
|
||||
{{{
|
||||
SKvm: lancer une machine virtuelle kvm
|
||||
|
||||
USAGE
|
||||
SKvm [options] vmName
|
||||
SKvm {-l|-A|-g}
|
||||
|
||||
OPTIONS
|
||||
-n, --check
|
||||
Ne rien faire excepté s'assurer que les modules kvm sont chargés
|
||||
-u, --user
|
||||
Lancer l'opération avec les droits de l'utilisateur courant. Par défaut,
|
||||
ce script tente d'acquérir les droits de root.
|
||||
-l, --list
|
||||
Lister les machines virtuelles
|
||||
-s, --start
|
||||
Démarrer la machine virtuelle (par défaut)
|
||||
Si le nom de la machine virtuelle n'est pas spécifiée, un menu est
|
||||
affiché
|
||||
-k, --stop
|
||||
Arrêter la machine virtuelle
|
||||
-H, --destroy
|
||||
Arrêter sauvagement la machine virtuelle
|
||||
-r, --restart
|
||||
Redémarrer la machine virtuelle
|
||||
-S, --managed-save
|
||||
Enregistrer l'état de la machine virtuelle
|
||||
-A, --stop-all
|
||||
Arrêter toutes les machines virtuelles qui tournent actuellement
|
||||
-g, --gui
|
||||
Afficher le gestionnaire de machines virtuelle
|
||||
}}}
|
||||
|
|
@ -1,29 +0,0 @@
|
|||
# -*- coding: utf-8 mode: markdown -*- vim:sw=4:sts=4:et:ai:si:sta:fenc=utf-8
|
||||
##@creator: jclain
|
||||
##@created: 27/04/2016 03:19
|
||||
##@modifier: jclain
|
||||
##@changecount: 1
|
||||
##@tags:
|
||||
##@title: SVirtualBox
|
||||
|
||||
{{{
|
||||
SVirtualBox: lancer une machine virtuelle VirtualBox
|
||||
|
||||
USAGE
|
||||
SVirtualBox [options] vmName
|
||||
|
||||
OPTIONS
|
||||
-n Ne rien faire excepté s'assurer que les modules VirtualBox sont chargés
|
||||
-l Lister les machines virtuelles
|
||||
-s Démarrer la machine virtuelle (par défaut)
|
||||
Si le nom de la machine virtuelle n'est pas spécifiée, un menu est
|
||||
affiché
|
||||
-b Démarrer la VM sans interface graphique. Cette option n'est valide
|
||||
qu'avec -s
|
||||
-k Arrêter la machine virtuelle (par ACPI)
|
||||
-p Mettre en veille la machine virtuelle (par ACPI)
|
||||
-H Arrêter sauvagement la machine virtuelle
|
||||
-R Redémarrer sauvagement la machine virtuelle
|
||||
-S Enregistrer l'état de la machine virtuelle
|
||||
-g Afficher le gestionnaire de machines virtuelle
|
||||
}}}
|
||||
|
|
@ -1,25 +0,0 @@
|
|||
# -*- coding: utf-8 mode: markdown -*- vim:sw=4:sts=4:et:ai:si:sta:fenc=utf-8
|
||||
# Pense-bête:
|
||||
# ''bold'' ==striked== __underline__ //italic// ^^super^^ ~~sub~~
|
||||
# @@highlight@@ @@color:red;background-color:white; rouge sur noir@@
|
||||
# ~NotAWikiWord [[force wikiword]] [[friendly name|WikiWord]]
|
||||
# [[external|http://site.com]] ---- {{monospace}}
|
||||
# !h1 !!h2 !!!h3 !!!!h4 !!!!!h5
|
||||
# * dotlist ** sublist # numlist ## sublist
|
||||
# {{{ |caption|c [img[title|filename]]
|
||||
# pre text |!header|!header|h [img[filename]]
|
||||
# }}} |cell|cell| [img[title|filename][link]]
|
||||
# <<< |>|colspan| [img[filename][link]]
|
||||
# blockquote |rowspan|one| [<img[filename]]
|
||||
# <<< |~|two| [>img[filename]]
|
||||
# >quote1 |left| right|
|
||||
# >>quote2 |>| center |
|
||||
# >>>quote3
|
||||
##@creator: jclain
|
||||
##@created: 09/03/2012 05:08
|
||||
##@modifier: jclain
|
||||
##@changecount: 1
|
||||
##@tags:
|
||||
##@title: SiteSubtitle
|
||||
|
||||
Outils divers pour linux/macosx, et librairies pour bash
|
||||
|
|
@ -1,25 +0,0 @@
|
|||
# -*- coding: utf-8 mode: markdown -*- vim:sw=4:sts=4:et:ai:si:sta:fenc=utf-8
|
||||
# Pense-bête:
|
||||
# ''bold'' ==striked== __underline__ //italic// ^^super^^ ~~sub~~
|
||||
# @@highlight@@ @@color:red;background-color:white; rouge sur noir@@
|
||||
# ~NotAWikiWord [[force wikiword]] [[friendly name|WikiWord]]
|
||||
# [[external|http://site.com]] ---- {{monospace}}
|
||||
# !h1 !!h2 !!!h3 !!!!h4 !!!!!h5
|
||||
# * dotlist ** sublist # numlist ## sublist
|
||||
# {{{ |caption|c [img[title|filename]]
|
||||
# pre text |!header|!header|h [img[filename]]
|
||||
# }}} |cell|cell| [img[title|filename][link]]
|
||||
# <<< |>|colspan| [img[filename][link]]
|
||||
# blockquote |rowspan|one| [<img[filename]]
|
||||
# <<< |~|two| [>img[filename]]
|
||||
# >quote1 |left| right|
|
||||
# >>quote2 |>| center |
|
||||
# >>>quote3
|
||||
##@creator: jclain
|
||||
##@created: 09/03/2012 05:08
|
||||
##@modifier: jclain
|
||||
##@changecount: 1
|
||||
##@tags:
|
||||
##@title: SiteTitle
|
||||
|
||||
nutools
|
||||
|
|
@ -1,25 +0,0 @@
|
|||
# -*- coding: utf-8 mode: markdown -*- vim:sw=4:sts=4:et:ai:si:sta:fenc=utf-8
|
||||
# Pense-bête:
|
||||
# ''bold'' ==striked== __underline__ //italic// ^^super^^ ~~sub~~
|
||||
# @@highlight@@ @@color:red;background-color:white; rouge sur noir@@
|
||||
# ~NotAWikiWord [[force wikiword]] [[friendly name|WikiWord]]
|
||||
# [[external|http://site.com]] ---- {{monospace}}
|
||||
# !h1 !!h2 !!!h3 !!!!h4 !!!!!h5
|
||||
# * dotlist ** sublist # numlist ## sublist
|
||||
# {{{ |caption|c [img[title|filename]]
|
||||
# pre text |!header|!header|h [img[filename]]
|
||||
# }}} |cell|cell| [img[title|filename][link]]
|
||||
# <<< |>|colspan| [img[filename][link]]
|
||||
# blockquote |rowspan|one| [<img[filename]]
|
||||
# <<< |~|two| [>img[filename]]
|
||||
# >quote1 |left| right|
|
||||
# >>quote2 |>| center |
|
||||
# >>>quote3
|
||||
##@creator: jclain
|
||||
##@created: 09/03/2012 05:08
|
||||
##@modifier: jclain
|
||||
##@changecount: 1
|
||||
##@tags:
|
||||
##@title: SiteUrl
|
||||
|
||||
|
||||
|
|
@ -1,12 +0,0 @@
|
|||
# -*- coding: utf-8 mode: markdown -*- vim:sw=4:sts=4:et:ai:si:sta:fenc=utf-8
|
||||
##@creator: jclain
|
||||
##@created: 15/03/2012 22:20
|
||||
##@modifier: jclain
|
||||
##@changecount: 1
|
||||
##@tags:
|
||||
##@title: _root
|
||||
|
||||
{{{
|
||||
_root: devenir l'utilisateur root, avec 'sudo' si possible, ou 'su' si
|
||||
'sudo' n'est pas installé
|
||||
}}}
|
||||
|
|
@ -1,69 +0,0 @@
|
|||
# -*- coding: utf-8 mode: markdown -*- vim:sw=4:sts=4:et:ai:si:sta:fenc=utf-8
|
||||
##@creator: jclain
|
||||
##@created: 27/04/2016 03:18
|
||||
##@modifier: jclain
|
||||
##@changecount: 1
|
||||
##@tags:
|
||||
##@title: apacheconfig
|
||||
|
||||
{{{
|
||||
apacheconfig: Gérer la configuration d'un serveur web apache
|
||||
|
||||
USAGE
|
||||
apacheconfig -c
|
||||
apacheconfig -t -- args...
|
||||
|
||||
OPTIONS
|
||||
-c, --create
|
||||
Créer un nouveau répertoire de configuration pour un hôte
|
||||
-d, --destdir DESTDIR[=apacheconfig]
|
||||
Nom du répertoire local de configuration.
|
||||
|
||||
-t, --template [OPT]
|
||||
Gérer les fichiers du répertoire local avec templatectl. La valeur de
|
||||
cette option est utilisée comme argument court pour l'invocation de
|
||||
templatectl, e.g
|
||||
apacheconfig -tm args
|
||||
est équivalent à
|
||||
templatectl -m args
|
||||
Les arguments qui restent sont passés tels quels à templatectl
|
||||
Les options courantes de templatectl -l, -v, -m, -L sont disponibles
|
||||
directement
|
||||
--help-template
|
||||
Afficher l'aide concernent la gestion des templates.
|
||||
Equivalent à -t -- --help
|
||||
-h, --host HOST
|
||||
Spécifier l'hôte. Equivalent à -v host=HOST
|
||||
--sysname SYSNAME
|
||||
--sysdist SYSDIST
|
||||
-s, --sysver SYSVER
|
||||
Spécifier la distribution pour laquelle synchroniser le template. Par
|
||||
défaut, choisir les valeurs correspondantes au système courant.
|
||||
Les options -7 et -8 sont des aliases respectivement pour -s wheezy et
|
||||
-s jessie, parce que les fichiers par défaut ont changé à partir de
|
||||
debian jessie.
|
||||
|
||||
-u, --update, --deploy
|
||||
Mettre à jour la configuration système à partir du répertoire local.
|
||||
Lors du déploiement de la configuration, les valeurs des variables
|
||||
dynamiques sont remplacées dans les fichiers destination.
|
||||
Les arguments qui restent sont passés tels quels à apache_autoconf
|
||||
-r, --certsdir CERTSDIR
|
||||
Spécifier le cas échéant le répertoire contenant les certificats à
|
||||
déployer. Cet argument est requis si le répertoire certsconf/ existe.
|
||||
|
||||
--localhosts
|
||||
Créer dans le fichier /etc/hosts tous les noms d'hôte ayant un suffixe
|
||||
.local mentionnés dans les fichiers de site. Cette option est utile pour
|
||||
le développement et les tests.
|
||||
-C, --one-conf CONF
|
||||
Ne déployer que le fichier de configuration spécifié. Cette option est
|
||||
utilisée avec --deploy et est utile pour le développement et les tests.
|
||||
-M, --one-module MODULE
|
||||
Ne déployer que le fichier de module spécifié. Cette option est utilisée
|
||||
avec --deploy et est utile pour le développement et les tests.
|
||||
-S, --one-site SITE
|
||||
Ne déployer que le fichier de site spécifié. Cette option est utilisée
|
||||
avec --deploy ou --localhosts et est utile pour le développement et les
|
||||
tests.
|
||||
}}}
|
||||
|
|
@ -1,39 +0,0 @@
|
|||
# -*- coding: utf-8 mode: markdown -*- vim:sw=4:sts=4:et:ai:si:sta:fenc=utf-8
|
||||
##@creator: jclain
|
||||
##@created: 27/04/2016 03:18
|
||||
##@modifier: jclain
|
||||
##@changecount: 1
|
||||
##@tags:
|
||||
##@title: authftp
|
||||
|
||||
{{{
|
||||
authftp: Se connecter sur un site FTP authentifié
|
||||
Ce script nécessite ncftp. Il est conçu pour faciliter l'accès à des sites FTP
|
||||
s'il est requis d'y accéder par un proxy FTP pour les connexion authentifiées.
|
||||
|
||||
USAGE
|
||||
authftp [options] host login password [path]
|
||||
|
||||
OPTIONS
|
||||
-p, --proxy
|
||||
-n, --noproxy
|
||||
Forcer l'utilisation, resp. ne pas utiliser, le proxy FTP (i.e. faire la
|
||||
connexion directement)
|
||||
-l, --lftp
|
||||
Se connecter avec lftp au lieu de ncftp. Le fonctionnement n'est pas
|
||||
garanti si l'on utilise un proxy FTP.
|
||||
-o OPTION
|
||||
Ajouter une option à la commande lancée. Si l'option prend un argument,
|
||||
il faut doubler l'option -o, e.g.
|
||||
authftp -l -o -e -o 'mirror remote local' host login pass
|
||||
Dans cet exemple, l'option -e de lftp est utilisée pour faire un miroir
|
||||
local du répertoire remote.
|
||||
--tls
|
||||
Indiquer que la connexion se fera en TLS. Implique --lftp puisque ncftp
|
||||
ne le supporte pas.
|
||||
|
||||
note: A cause d'une limitation de lftp, ce n'est pas possible de se connecter
|
||||
automatiquement avec lftp si le mot de passe contient une virgule. A cause de la
|
||||
façon dont le proxy ftp est configuré, il n'est pas possible de se connecter
|
||||
avec un mot de passe qui contient le caractère @
|
||||
}}}
|
||||
|
|
@ -1,20 +0,0 @@
|
|||
# -*- coding: utf-8 mode: markdown -*- vim:sw=4:sts=4:et:ai:si:sta:fenc=utf-8
|
||||
##@creator: jclain
|
||||
##@created: 13/05/2016 09:36
|
||||
##@modifier: jclain
|
||||
##@changecount: 1
|
||||
##@tags:
|
||||
##@title: caturl
|
||||
|
||||
{{{
|
||||
caturl: Afficher une url
|
||||
|
||||
USAGE
|
||||
caturl <file.url|file.desktop|URL>
|
||||
|
||||
OPTIONS
|
||||
-c, --check
|
||||
Vérifier que le fichier est valide
|
||||
-g, --get
|
||||
Attaquer l'url spécifiée avec curl
|
||||
}}}
|
||||
|
|
@ -1,11 +0,0 @@
|
|||
# -*- coding: utf-8 mode: markdown -*- vim:sw=4:sts=4:et:ai:si:sta:fenc=utf-8
|
||||
##@creator: jclain
|
||||
##@created: 15/03/2012 22:19
|
||||
##@modifier: jclain
|
||||
##@changecount: 1
|
||||
##@tags:
|
||||
##@title: compileAndGo
|
||||
|
||||
{{{
|
||||
compileAndGo: see http://Yost.com/computers/compileAndGo
|
||||
}}}
|
||||
18
doc/cssh.twp
18
doc/cssh.twp
|
|
@ -1,18 +0,0 @@
|
|||
# -*- coding: utf-8 mode: markdown -*- vim:sw=4:sts=4:et:ai:si:sta:fenc=utf-8
|
||||
##@creator: jclain
|
||||
##@created: 27/04/2016 03:18
|
||||
##@modifier: jclain
|
||||
##@changecount: 1
|
||||
##@tags:
|
||||
##@title: cssh
|
||||
|
||||
{{{
|
||||
cssh: Faire une connexion ssh en lançant automatiquement un screen sur l'hôte distant
|
||||
|
||||
USAGE
|
||||
cssh [user@]host [options]
|
||||
|
||||
En principe, hormis l'argument user@host, il ne faudrait spécifier que des
|
||||
options. Dans le cas où d'autres arguments seraient spécifiés, les meilleurs
|
||||
efforts sont faits pour lancer ces commandes avant screen.
|
||||
}}}
|
||||
|
|
@ -1,35 +0,0 @@
|
|||
# -*- coding: utf-8 mode: markdown -*- vim:sw=4:sts=4:et:ai:si:sta:fenc=utf-8
|
||||
##@creator: jclain
|
||||
##@created: 27/04/2016 03:18
|
||||
##@modifier: jclain
|
||||
##@changecount: 1
|
||||
##@tags:
|
||||
##@title: doinplace
|
||||
|
||||
{{{
|
||||
doinplace: filtrer en place un fichier à travers une suite de commandes
|
||||
|
||||
USAGE
|
||||
doinplace FILE COMMAND [ARGS...]
|
||||
|
||||
Si on utilise une commande avec des options, penser à utliser '--' pour séparer
|
||||
les options de ce script des options de la commande
|
||||
|
||||
En plus des commandes systèmes, il est possible d'utiliser toute fonction de
|
||||
nutools qui effectue des traitement sur un flux comme stripnl, filter_empty,
|
||||
merge_contlines, filter_comment, filter_conf, etc. Les fonctions nl2lf, nl2crlf,
|
||||
nl2cr, latin1compat et noaccents sont aussi disponibles par convenance.
|
||||
|
||||
OPTIONS
|
||||
-p, --evalp
|
||||
Evaluer la commande avec evalp(), ce qui permet de chainer plusieurs
|
||||
commandes en les séparant par //. Cette option est automatiquement
|
||||
activée si ce script est lancé avec le nom doinplacex
|
||||
-g, --ignore-error, --replace-always
|
||||
Normalement, le fichier n'est pas remplacé si la commande retourne une
|
||||
erreur. Avec cette option, le fichier est remplacé quel que soit le code
|
||||
de retour de la commande. A utiliser par exemple avec des commandes
|
||||
comme grep qui peuvent retourner FAUX s'ils ne trouvent pas le motif.
|
||||
Cette option est automatiquement activée si ce script est lancé avec le
|
||||
nom doinplacef
|
||||
}}}
|
||||
|
|
@ -1,30 +0,0 @@
|
|||
# -*- coding: utf-8 mode: markdown -*- vim:sw=4:sts=4:et:ai:si:sta:fenc=utf-8
|
||||
##@creator: jclain
|
||||
##@created: 27/04/2016 03:18
|
||||
##@modifier: jclain
|
||||
##@changecount: 1
|
||||
##@tags:
|
||||
##@title: dumpclients
|
||||
|
||||
{{{
|
||||
dumpclients: afficher les connexions TCP entrantes sur un port
|
||||
|
||||
USAGE
|
||||
dumpclients [options] port
|
||||
|
||||
OPTIONS
|
||||
-4, --only-tcp
|
||||
-6, --only-tcp6
|
||||
Se limiter au protocole spécifié. Par défaut, afficher toutes les
|
||||
connexions, qu'elles soient en IPv4 ou en IPv6
|
||||
-a, --all
|
||||
Afficher tous les sockets, y compris les ports d'écoute. Par défaut,
|
||||
seules les sockets ouvertes sont affichées.
|
||||
-n, --numeric
|
||||
Afficher uniquement les adresses IP au lieu du nom d'hôte.
|
||||
-z, --allow-no-port
|
||||
Ne pas exiger que le port soit spécifié
|
||||
--show none,ip,port,state
|
||||
Spécifier d'afficher comme informations supplémentaire: rien, l'adresse
|
||||
ip, le port et/ou l'état. Par défaut, afficher le port et l'état.
|
||||
}}}
|
||||
95
doc/em.twp
95
doc/em.twp
|
|
@ -1,95 +0,0 @@
|
|||
# -*- coding: utf-8 mode: markdown -*- vim:sw=4:sts=4:et:ai:si:sta:fenc=utf-8
|
||||
##@creator: jclain
|
||||
##@created: 27/04/2016 03:18
|
||||
##@modifier: jclain
|
||||
##@changecount: 1
|
||||
##@tags:
|
||||
##@title: em
|
||||
|
||||
{{{
|
||||
Usage: /usr/bin/emacs [OPTION-OR-FILENAME]...
|
||||
|
||||
Run Emacs, the extensible, customizable, self-documenting real-time
|
||||
display editor. The recommended way to start Emacs for normal editing
|
||||
is with no options at all.
|
||||
|
||||
Run M-x info RET m emacs RET m emacs invocation RET inside Emacs to
|
||||
read the main documentation for these command-line arguments.
|
||||
|
||||
Initialization options:
|
||||
|
||||
--batch do not do interactive display; implies -q
|
||||
--daemon start a server in the background
|
||||
--debug-init enable Emacs Lisp debugger for init file
|
||||
--display, -d DISPLAY use X server DISPLAY
|
||||
--no-desktop do not load a saved desktop
|
||||
--no-init-file, -q load neither ~/.emacs nor default.el
|
||||
--no-shared-memory, -nl do not use shared memory
|
||||
--no-site-file do not load site-start.el
|
||||
--no-splash do not display a splash screen on startup
|
||||
--no-window-system, -nw do not communicate with X, ignoring $DISPLAY
|
||||
--quick, -Q equivalent to -q --no-site-file --no-splash
|
||||
--script FILE run FILE as an Emacs Lisp script
|
||||
--terminal, -t DEVICE use DEVICE for terminal I/O
|
||||
--user, -u USER load ~USER/.emacs instead of your own
|
||||
|
||||
Action options:
|
||||
|
||||
FILE visit FILE using find-file
|
||||
+LINE go to line LINE in next FILE
|
||||
+LINE:COLUMN go to line LINE, column COLUMN, in next FILE
|
||||
--directory, -L DIR add DIR to variable load-path
|
||||
--eval EXPR evaluate Emacs Lisp expression EXPR
|
||||
--execute EXPR evaluate Emacs Lisp expression EXPR
|
||||
--file FILE visit FILE using find-file
|
||||
--find-file FILE visit FILE using find-file
|
||||
--funcall, -f FUNC call Emacs Lisp function FUNC with no arguments
|
||||
--insert FILE insert contents of FILE into current buffer
|
||||
--kill exit without asking for confirmation
|
||||
--load, -l FILE load Emacs Lisp FILE using the load function
|
||||
--visit FILE visit FILE using find-file
|
||||
|
||||
Display options:
|
||||
|
||||
--background-color, -bg COLOR window background color
|
||||
--basic-display, -D disable many display features;
|
||||
used for debugging Emacs
|
||||
--border-color, -bd COLOR main border color
|
||||
--border-width, -bw WIDTH width of main border
|
||||
--color, --color=MODE override color mode for character terminals;
|
||||
MODE defaults to `auto', and can also
|
||||
be `never', `auto', `always',
|
||||
or a mode name like `ansi8'
|
||||
--cursor-color, -cr COLOR color of the Emacs cursor indicating point
|
||||
--font, -fn FONT default font; must be fixed-width
|
||||
--foreground-color, -fg COLOR window foreground color
|
||||
--fullheight, -fh make the first frame high as the screen
|
||||
--fullscreen, -fs make first frame fullscreen
|
||||
--fullwidth, -fw make the first frame wide as the screen
|
||||
--maximized, -mm make the first frame maximized
|
||||
--geometry, -g GEOMETRY window geometry
|
||||
--no-bitmap-icon, -nbi do not use picture of gnu for Emacs icon
|
||||
--iconic start Emacs in iconified state
|
||||
--internal-border, -ib WIDTH width between text and main border
|
||||
--line-spacing, -lsp PIXELS additional space to put between lines
|
||||
--mouse-color, -ms COLOR mouse cursor color in Emacs window
|
||||
--name NAME title for initial Emacs frame
|
||||
--no-blinking-cursor, -nbc disable blinking cursor
|
||||
--reverse-video, -r, -rv switch foreground and background
|
||||
--title, -T TITLE title for initial Emacs frame
|
||||
--vertical-scroll-bars, -vb enable vertical scroll bars
|
||||
--xrm XRESOURCES set additional X resources
|
||||
--parent-id XID set parent window
|
||||
--help display this help and exit
|
||||
--version output version information and exit
|
||||
|
||||
You can generally also specify long option names with a single -; for
|
||||
example, -batch as well as --batch. You can use any unambiguous
|
||||
abbreviation for a --option.
|
||||
|
||||
Various environment variables and window system resources also affect
|
||||
Emacs' operation. See the main documentation.
|
||||
|
||||
Report bugs to bug-gnu-emacs@gnu.org. First, please see the Bugs
|
||||
section of the Emacs manual or the file BUGS.
|
||||
}}}
|
||||
|
|
@ -1,64 +0,0 @@
|
|||
# -*- coding: utf-8 mode: markdown -*- vim:sw=4:sts=4:et:ai:si:sta:fenc=utf-8
|
||||
##@creator: jclain
|
||||
##@created: 27/04/2016 03:18
|
||||
##@modifier: jclain
|
||||
##@changecount: 1
|
||||
##@tags:
|
||||
##@title: fconv
|
||||
|
||||
{{{
|
||||
fconv: convertir un fichier ou les fichiers d'un répertoire
|
||||
|
||||
USAGE
|
||||
fconv -f FILE [cmds...]
|
||||
fconv FILE [cmds...]
|
||||
|
||||
Une ou plusieurs commandes peuvent être spécifiées, séparées par //
|
||||
La commande par défaut est 'lf'
|
||||
Si des commandes utilisant des options sont utilisées, penser à séparer les
|
||||
options de fconv avec --
|
||||
|
||||
OPTIONS
|
||||
-N, --detect-always
|
||||
Pour la commande conv, ne pas optimiser le calcul de l'encoding. Cette
|
||||
option n'est valide que si src_enc n'est pas spécifié. On assume que
|
||||
tous les fichiers n'ont pas le même encoding: l'encoding src_enc est
|
||||
donc recalculé à chaque fois.
|
||||
-r, --reverse
|
||||
Pour la commande conv, inverser src_enc et dest_enc, qui doivent être
|
||||
tous les deux spécifiés.
|
||||
-f, --file FILE
|
||||
Spécifier le fichier ou le répertoire concerné par la conversion. Les
|
||||
aliases -d et --dir sont aussi reconnus.
|
||||
Si cette option n'est pas spécifiée, le premier argument est considéré
|
||||
comme le nom du fichier ou du répertoire à convertir. Par défaut,
|
||||
convertir l'entrée standard.
|
||||
Si un répertoire est spécifié, tous les fichiers de ce répertoire et de
|
||||
ses sous-répertoires sont recherchés de façon récursive, sans limite de
|
||||
profondeur. Ensuite, chacun de ces fichiers est converti.
|
||||
--show-cmd
|
||||
Afficher la commande qui serait exécutée
|
||||
|
||||
COMMANDES
|
||||
c, conv dest_enc [src_enc]
|
||||
Convertir le fichier dans un autre encoding.
|
||||
dest_enc est l'encoding destination. Il doit être spécifié.
|
||||
src_enc est l'encoding source. S'il n'est pas spécifié ou vaut 'detect',
|
||||
il est autodétecté.
|
||||
U, utf8 [src_enc]
|
||||
Equivalent à conv utf8 src_enc
|
||||
L, latin1 [src_enc]
|
||||
Equivalent à conv latin1 src_enc
|
||||
lf
|
||||
crlf
|
||||
cr
|
||||
Convertir respectivement les caractères de fin de ligne en LF, CR/LF ou CR
|
||||
lc, latin1compat
|
||||
Transformer certains caratères UTF-8 en équivalents qui existent en Latin1
|
||||
na, noaccents
|
||||
Transformer les caractères accentués en caractères non accentués
|
||||
sort [-u]
|
||||
Trier le fichier avec la commande sort. Attention! Il ne faut utiliser
|
||||
que les options de sort qui agissent sur un flux e.g. -u pour trier les
|
||||
lignes de façon unique.
|
||||
}}}
|
||||
|
|
@ -1,58 +0,0 @@
|
|||
# -*- coding: utf-8 mode: markdown -*- vim:sw=4:sts=4:et:ai:si:sta:fenc=utf-8
|
||||
##@creator: jclain
|
||||
##@created: 27/04/2016 03:18
|
||||
##@modifier: jclain
|
||||
##@changecount: 1
|
||||
##@tags:
|
||||
##@title: fnconv
|
||||
|
||||
{{{
|
||||
fnconv: renommer un fichier ou les fichiers d'un répertoire
|
||||
|
||||
USAGE
|
||||
fnconv -f FILE [cmds...]
|
||||
fnconv FILE [cmds...]
|
||||
|
||||
Une ou plusieurs commandes peuvent être spécifiées, séparées //
|
||||
La commande par défaut est 'fixcase'
|
||||
|
||||
OPTIONS
|
||||
-N, --detect-always
|
||||
Pour la commande conv, ne pas optimiser le calcul de l'encoding. Cette
|
||||
option n'est valide que si src_enc n'est pas spécifié. On assume que
|
||||
tous les fichiers n'ont pas le même encoding: l'encoding src_enc est
|
||||
donc recalculé à chaque fois.
|
||||
-r, --reverse
|
||||
Pour la commande conv, inverser src_enc et dest_enc, qui doivent être
|
||||
tous les deux spécifiés.
|
||||
-f, --file FILE
|
||||
Spécifier le fichier ou le répertoire concerné par le renommage. Les
|
||||
aliases -d et --dir sont aussi reconnus.
|
||||
Si cette option n'est pas spécifiée, le premier argument est considéré
|
||||
comme le nom du fichier ou du répertoire à renommer.
|
||||
Si un répertoire est spécifié, le traitement est appliqué à tous les
|
||||
fichiers et répertoires de façon récursive, sans limite de profondeur.
|
||||
--show-cmd
|
||||
Afficher la commande qui serait exécutée
|
||||
|
||||
COMMANDES
|
||||
C, conv dest_enc [src_enc]
|
||||
Convertir le nom du fichier dans un autre encoding.
|
||||
dest_enc est l'encoding destination. Il doit être spécifié.
|
||||
src_enc est l'encoding source. S'il n'est pas spécifié ou vaut 'detect',
|
||||
il est autodétecté.
|
||||
U, utf8 [src_enc]
|
||||
Equivalent à conv utf8 src_enc
|
||||
L, latin1 [src_enc]
|
||||
Equivalent à conv latin1 src_enc
|
||||
lc, latin1compat
|
||||
Transformer certains caratères UTF-8 en équivalents qui existent en Latin1
|
||||
na, noaccents
|
||||
Transformer les caractères accentués en caractères non accentués
|
||||
l, lowercase
|
||||
Transfomer le nom en minuscule
|
||||
u, uppercase
|
||||
Transformer le nom en majuscule
|
||||
f, fixcase
|
||||
Transformer le nom en minuscule s'il est entièrement en majuscule
|
||||
}}}
|
||||
|
|
@ -1,14 +0,0 @@
|
|||
# -*- coding: utf-8 mode: markdown -*- vim:sw=4:sts=4:et:ai:si:sta:fenc=utf-8
|
||||
##@creator: jclain
|
||||
##@created: 15/03/2012 22:19
|
||||
##@modifier: jclain
|
||||
##@changecount: 1
|
||||
##@tags:
|
||||
##@title: geturl
|
||||
|
||||
{{{
|
||||
geturl: Télécharger un fichier avec wget ou curl
|
||||
|
||||
USAGE
|
||||
geturl <file.url|file.desktop|URL> [wget options]
|
||||
}}}
|
||||
18
doc/index.md
18
doc/index.md
|
|
@ -20,16 +20,16 @@ Chaque outil contient une aide intégrée. Il suffit de lancer l'outil avec
|
|||
l'argument `--help` pour avoir une aide détaillée.
|
||||
|
||||
* Déploiement d'un répertoire ou d'une archive
|
||||
* [uinst](): Déploiement local
|
||||
* [mkusfx](): Faire une archive auto-installable avec uinst
|
||||
* [ruinst](): Déploiement distant avec uinst
|
||||
* [runs](): Lancer un script avec le protocole RUNS
|
||||
* [rruns](): Déploiement distant avec runs
|
||||
* [uinst](tools/uinst): Déploiement local
|
||||
* [mkusfx](tools/mkusfx): Faire une archive auto-installable avec uinst
|
||||
* [ruinst](tools/ruinst): Déploiement distant avec uinst
|
||||
* [runs](tools/runs): Lancer un script avec le protocole RUNS
|
||||
* [rruns](tools/rruns): Déploiement distant avec runs
|
||||
* Librairie réutilisable de scripts shell
|
||||
* [uinc](): Dépliage des inclusions dans un fichier
|
||||
* [ulibsync](): Faire une copie locale pour un projet de ulib et/ou pyulib
|
||||
* [uinc](tools/uinc): Dépliage des inclusions dans un fichier
|
||||
* [ulibsync](tools/ulibsync): Faire une copie locale pour un projet de ulib et/ou pyulib
|
||||
* Autres outils
|
||||
* [udir](): Gestion des paramètres d'un répertoire. Ces paramètres sont entre
|
||||
autres utilisés par uinst et uinc.
|
||||
* [udir](tools/udir): Gestion des paramètres d'un répertoire. Ces paramètres sont entre
|
||||
autres utilisés par uinst et uinc.
|
||||
|
||||
-*- coding: utf-8 mode: markdown -*- vim:sw=4:sts=4:et:ai:si:sta:fenc=utf-8:noeol:binary
|
||||
|
|
@ -1,86 +0,0 @@
|
|||
# -*- coding: utf-8 mode: markdown -*- vim:sw=4:sts=4:et:ai:si:sta:fenc=utf-8
|
||||
##@creator: jclain
|
||||
##@created: 15/03/2012 22:19
|
||||
##@modifier: jclain
|
||||
##@changecount: 1
|
||||
##@tags:
|
||||
##@title: mkRewriteRules
|
||||
|
||||
{{{
|
||||
mkRewriteRules: Créer un fichier de redirections pour Apache à partir d'un certain
|
||||
nombre de règles
|
||||
|
||||
USAGE
|
||||
mkRewriteRules -f rewrite.rules [-o RewriteRules.conf] [-w RewriteRules.html] host
|
||||
|
||||
OPTIONS
|
||||
-p Générer les directives <Proxy...> et tenir compte de proxy_acls
|
||||
Par défaut, le champ proxy_acls est ignoré
|
||||
|
||||
FORMAT des règles de mapping
|
||||
============================
|
||||
|
||||
Les commentaires commencent par le signe "#"
|
||||
Les règles sont de la forme:
|
||||
src:dest:host:suffix:OPTS:prot:proxy_acls
|
||||
^prefix
|
||||
=literal
|
||||
|
||||
prot vaut par défaut http. Il peut valoir aussi https
|
||||
|
||||
Si dest ou suffix se terminent par $, on est en mode NO_SLASH
|
||||
En mode NO_SLASH, si src se termine par $, on est en mode NO_TRAIL
|
||||
|
||||
* Si dest est de la forme Application.woa
|
||||
En mode NO_SLASH, on génère
|
||||
RewriteRule ^/src(.*) [prot://host]/cgi-bin/WebObjects/dest[/suffix]$1 [L,OPTS]
|
||||
En mode NO_SLASH+NO_TRAIL, on génère
|
||||
RewriteRule ^/src [prot://host]/cgi-bin/WebObjects/dest[/suffix] [L,OPTS]
|
||||
En mode normal, on génère
|
||||
RewriteRule ^/src$ /src/
|
||||
RewriteRule ^/src/(.*) [prot://host]/cgi-bin/WebObjects/dest[/suffix]/$1 [L,OPTS]
|
||||
|
||||
* Si dest n'est pas de la forme Application.woa
|
||||
En mode NO_SLASH, on génère
|
||||
RewriteRule ^/src(.*) [prot://host]/dest[/suffix]$1 [L,OPTS]
|
||||
En mode NO_SLASH+NO_TRAIL, on génère
|
||||
RewriteRule ^/src [prot://host]/dest[/suffix] [L,OPTS]
|
||||
En mode normal, on génère
|
||||
RewriteRule ^/src$ /src/
|
||||
RewriteRule ^/src/(.*) /dest[/suffix]/$1 [L,OPTS]
|
||||
|
||||
Si une règle est précédée d'une ou plusieurs lignes de la forme "^prefix",
|
||||
ces lignes sont copiées avant chacune des commandes RewriteRule générées
|
||||
pour une règle. Ceci permet d'ajouter des conditions avec RewriteCond pour
|
||||
une règle. e.g.
|
||||
^RewriteCond %{REMOTE_ADDR} 10\..*
|
||||
src:dest.woa
|
||||
qui génère:
|
||||
RewriteCond %{REMOTE_ADDR} 10\..*
|
||||
RewriteRule ^/src$ /src/
|
||||
RewriteCond %{REMOTE_ADDR} 10\..*
|
||||
RewriteRule ^/src/(.*) /cgi-bin/WebObjects/dest.woa/$1 [L]
|
||||
|
||||
Une ligne de la forme "=literal" est recopiée sans modifications (sans le "=")
|
||||
dans le fichier de sortie.
|
||||
|
||||
proxy_acls est utilisé si l'option -p est spécifiée et OPTS contient P (comme
|
||||
proxy), ou si le mode de réécriture requière l'utilisation d'un proxy.
|
||||
|
||||
* Avec la valeur "None", aucune directive <Proxy> n'est générée
|
||||
* Si aucune valeur n'est spécifiée, la directive suivante est générée:
|
||||
<Proxy $URL>
|
||||
AddDefaultCharset off
|
||||
Order Deny,Allow
|
||||
Allow from all
|
||||
</Proxy>
|
||||
* Si une valeur est spécifiée, la directive suivante est générée:
|
||||
<Proxy $URL>
|
||||
AddDefaultCharset off
|
||||
Order Allow,Deny
|
||||
Allow from $proxy_acls
|
||||
</Proxy>
|
||||
|
||||
Dans les exemples donnés ci-dessus, $URL est l'url générée par la réécriture,
|
||||
et $proxy_acls la valeur du champ proxy_acls spécifiée ci-dessus.
|
||||
}}}
|
||||
|
|
@ -1,25 +0,0 @@
|
|||
# -*- coding: utf-8 mode: markdown -*- vim:sw=4:sts=4:et:ai:si:sta:fenc=utf-8
|
||||
##@creator: jclain
|
||||
##@created: 27/04/2016 03:18
|
||||
##@modifier: jclain
|
||||
##@changecount: 1
|
||||
##@tags:
|
||||
##@title: mkiso
|
||||
|
||||
{{{
|
||||
mkiso: créer une image iso d'un répertoire
|
||||
|
||||
USAGE
|
||||
mkiso [options] srcdir [dest.iso]
|
||||
|
||||
OPTIONS
|
||||
-M, --hfs
|
||||
créer une image hybride ISO/HFS
|
||||
-V, --volume
|
||||
Nom du volume. Par défaut, prendre le nom de base du répertoire
|
||||
d'origine. La taille est de 32 caractères max.
|
||||
-A, --application
|
||||
Description de l'application qui est sur l'image créée. Par défaut,
|
||||
prendre le nom de base du répertoire d'origine. La taille est de 128
|
||||
caractères max.
|
||||
}}}
|
||||
|
|
@ -1,20 +0,0 @@
|
|||
# -*- coding: utf-8 mode: markdown -*- vim:sw=4:sts=4:et:ai:si:sta:fenc=utf-8
|
||||
##@creator: jclain
|
||||
##@created: 15/03/2012 22:20
|
||||
##@modifier: jclain
|
||||
##@changecount: 1
|
||||
##@tags:
|
||||
##@title: mkurl
|
||||
|
||||
{{{
|
||||
mkurl: Enregistrer une url dans un fichier raccourci
|
||||
|
||||
USAGE
|
||||
mkurl <url> [output]
|
||||
|
||||
OPTIONS
|
||||
Par défaut, l'url est enregistrée dans un fichier homepage.url
|
||||
Mais il est possible de spécifier un fichier avec l'extension .url pour un
|
||||
raccourci utilisable aussi sous Windows, ou avec l'extension .desktop pour
|
||||
compatibilité avec le standard XDG
|
||||
}}}
|
||||
|
|
@ -1,35 +0,0 @@
|
|||
# -*- coding: utf-8 mode: markdown -*- vim:sw=4:sts=4:et:ai:si:sta:fenc=utf-8
|
||||
##@creator: jclain
|
||||
##@created: 15/03/2012 22:20
|
||||
##@modifier: jclain
|
||||
##@changecount: 1
|
||||
##@tags:
|
||||
##@title: mkusfx
|
||||
|
||||
{{{
|
||||
mkusfx: Créer une archive auto-extractible qui installe son contenu avec uinst
|
||||
|
||||
USAGE
|
||||
mkusfx [options] [--bare] src cmd...
|
||||
mkusfx [options] [--uinst] src
|
||||
|
||||
OPTIONS
|
||||
--bare
|
||||
Installer le contenu de l'archive en lançant la commande 'cmd...' avec
|
||||
le répertoire courant étant le contenu de l'archive. Typiquement, ce
|
||||
sera une commande de forme './script', où script est un fichier situé à
|
||||
la racine de l'archive
|
||||
Dans ce mode d'installation, l'option --self-contained est ignorée.
|
||||
--uinst
|
||||
Installer le contenu de l'archive avec uinst (par défaut)
|
||||
-o dest
|
||||
Spécifier le fichier de sortie. Par défaut, il s'agit de
|
||||
${src}-installer.run
|
||||
--tmp-archive
|
||||
Spécifier qu'il s'agit d'une archive temporaire. Cette archive
|
||||
s'auto-détruit après utilisation.
|
||||
--self-contained
|
||||
Spécifier que l'archive doit pouvoir s'installer même sur un système sur
|
||||
lequel nutools n'est pas installé. Cette archive contiendra une copie
|
||||
locale de ulib et uinst.sh
|
||||
}}}
|
||||
|
|
@ -1,30 +0,0 @@
|
|||
# -*- coding: utf-8 mode: markdown -*- vim:sw=4:sts=4:et:ai:si:sta:fenc=utf-8
|
||||
##@creator: jclain
|
||||
##@created: 27/04/2016 03:18
|
||||
##@modifier: jclain
|
||||
##@changecount: 1
|
||||
##@tags:
|
||||
##@title: mocifs
|
||||
|
||||
{{{
|
||||
mocifs: Monter un partage Windows/Samba/CIFS
|
||||
|
||||
USAGE
|
||||
mocifs [user@]host[/path] [mountpoint]
|
||||
|
||||
Par défaut, le répertoire distant est montée sur un répertoire avec le même nom
|
||||
de base que l'hôte. Si le répertoire distant est déjà monté, il est démonté.
|
||||
Les options -M et -U permettent de modifier le comportement par défaut.
|
||||
|
||||
OPTIONS
|
||||
-M
|
||||
Forcer le montage
|
||||
-U
|
||||
Forcer le démontage
|
||||
-o OPTIONS
|
||||
Ajouter les options spécifiées à la commande de montage mount.cifs
|
||||
-u USERNAME
|
||||
-p PASSWORD
|
||||
-c USERNAME:PASSWORD
|
||||
Spécifier les credentials à utiliser pour la connexion
|
||||
}}}
|
||||
|
|
@ -1,44 +0,0 @@
|
|||
# -*- coding: utf-8 mode: markdown -*- vim:sw=4:sts=4:et:ai:si:sta:fenc=utf-8
|
||||
##@creator: jclain
|
||||
##@created: 27/04/2016 03:18
|
||||
##@modifier: jclain
|
||||
##@changecount: 1
|
||||
##@tags:
|
||||
##@title: modav
|
||||
|
||||
{{{
|
||||
modav: Monter un répertoire sur un hôte distant avec davfs
|
||||
|
||||
USAGE
|
||||
modav http[s]://host[/path] [mountpoint]
|
||||
|
||||
Par défaut, le répertoire distant est montée sur un répertoire avec le même nom
|
||||
de base que l'hôte. Si le répertoire distant est déjà monté, il est démonté.
|
||||
Les options -M et -U permettent de modifier le comportement par défaut.
|
||||
|
||||
OPTIONS
|
||||
-M
|
||||
Forcer le montage
|
||||
-U
|
||||
Forcer le démontage
|
||||
-o OPTIONS
|
||||
Ajouter les options spécifiées à la commande de montage
|
||||
-u USERNAME
|
||||
-p PASSWORD
|
||||
-c USERNAME:PASSWORD
|
||||
Si les credentials à utiliser ne sont pas configuré dans le fichier
|
||||
/etc/davfs2/secrets, cette option permet de les spécifier. Si cette
|
||||
option est utilisée, il est possible de rajouter
|
||||
ask_auth 0
|
||||
dans le fichier /etc/davfs2/davfs2.conf pour éviter le conflit qui se
|
||||
produit quand des informations sont demandées interactivement. C'est le
|
||||
cas par exemple si une connexion en https est faite et que la chaine de
|
||||
certification n'est pas configurée. Pour mémoire, cela se fait avec
|
||||
servercert myCAs.pem
|
||||
dans le fichier /etc/davfs2/davfs2.conf
|
||||
Bien entendu, il est préférable de configurer les credentials dans le
|
||||
fichier /etc/davfs2/secrets avec la syntaxe
|
||||
url username password
|
||||
ou
|
||||
mountpoint username password
|
||||
}}}
|
||||
|
|
@ -1,24 +0,0 @@
|
|||
# -*- coding: utf-8 mode: markdown -*- vim:sw=4:sts=4:et:ai:si:sta:fenc=utf-8
|
||||
##@creator: jclain
|
||||
##@created: 27/04/2016 03:18
|
||||
##@modifier: jclain
|
||||
##@changecount: 1
|
||||
##@tags:
|
||||
##@title: moiso
|
||||
|
||||
{{{
|
||||
moiso: Monter une image ISO
|
||||
|
||||
USAGE
|
||||
moiso image.iso [mountpoint]
|
||||
|
||||
Par défaut, l'image iso est montée sur un répertoire avec le même nom de base.
|
||||
Si l'image est déjà montée, elle est démontée. Les options -m et -u permettent
|
||||
de modifier le comportement par défaut.
|
||||
|
||||
OPTIONS
|
||||
-m
|
||||
Forcer le montage
|
||||
-u
|
||||
Forcer le démontage
|
||||
}}}
|
||||
|
|
@ -1,33 +0,0 @@
|
|||
# -*- coding: utf-8 mode: markdown -*- vim:sw=4:sts=4:et:ai:si:sta:fenc=utf-8
|
||||
##@creator: jclain
|
||||
##@created: 27/04/2016 03:18
|
||||
##@modifier: jclain
|
||||
##@changecount: 1
|
||||
##@tags:
|
||||
##@title: mossh
|
||||
|
||||
{{{
|
||||
mossh: Monter un répertoire sur un hôte distant avec sshfs
|
||||
|
||||
USAGE
|
||||
mossh [user@]host[:/path] [mountpoint]
|
||||
|
||||
Par défaut, le répertoire distant est montée sur un répertoire avec le même nom
|
||||
de base que l'hôte. Si le répertoire distant est déjà monté, il est démonté.
|
||||
Les options -M et -U permettent de modifier le comportement par défaut.
|
||||
|
||||
OPTIONS
|
||||
-M
|
||||
Forcer le montage
|
||||
-U
|
||||
Forcer le démontage
|
||||
-o OPTIONS
|
||||
Ajouter les options spécifiées à la commande de montage
|
||||
-s
|
||||
Equivalent à -o allow_other ou -o allow_root selon que l'on est root ou
|
||||
non
|
||||
-u USER
|
||||
Spécifier le user pour la connexion distante, s'il n'est pas possible de
|
||||
le spécifier dans l'url. En cas de conflit, la valeur dans l'url est
|
||||
prioritaire par rapport à cette option.
|
||||
}}}
|
||||
|
|
@ -1,69 +0,0 @@
|
|||
# -*- coding: utf-8 mode: markdown -*- vim:sw=4:sts=4:et:ai:si:sta:fenc=utf-8
|
||||
##@creator: jclain
|
||||
##@created: 27/04/2016 03:18
|
||||
##@modifier: jclain
|
||||
##@changecount: 1
|
||||
##@tags:
|
||||
##@title: mysqlcsv
|
||||
|
||||
{{{
|
||||
mysqlcsv: Faire une requête MySQL et formater la sortie pour traitement avec awkcsv
|
||||
|
||||
USAGE
|
||||
mysqlcsv [query [db]] [-- mysql options]
|
||||
|
||||
query est la requête sql à exécuter. Si query n'est pas spécifiée, la(les)
|
||||
requête(s) sql sont prises sur l'entrée standard, ou depuis un fichier
|
||||
si l'option -f est spécifiée.
|
||||
db est le nom de la base de données. Cette argument n'est lu que si le nom
|
||||
de la base de donnée n'est ni spécifié dans le fichier de configuration,
|
||||
ni spécifié avec l'option -D
|
||||
|
||||
OPTIONS
|
||||
-h, --host HOST
|
||||
-P, --port PORT
|
||||
-u, --user USER
|
||||
-pPASSWORD
|
||||
-D, --database DATABASE
|
||||
Informations de connexion à la base de données
|
||||
-C, --config CONFIG
|
||||
Prendre les informations de connexion depuis le fichier spécifié.
|
||||
Le fichier doit être de la forme
|
||||
host=HOST
|
||||
#post=3306
|
||||
user=USER
|
||||
password=PASS
|
||||
#database=DB
|
||||
#query=QUERY
|
||||
Les variables port, database et query sont facultatives.
|
||||
Les valeurs définies dans ce fichier sont prioritaires par rapport à
|
||||
celles qui auraient été spécifiées sur la ligne de commande.
|
||||
Utiliser password=--NOT-SET-- s'il faut se connecter sans mot de passe
|
||||
Cette option peut être utilisée plusieurs fois, auquel cas les fichiers
|
||||
sont chargés dans l'ordre.
|
||||
--profile PROFILE
|
||||
La variable $PROFILE est définie avec la valeur spécifiée avant de
|
||||
sourcer les fichiers de configuration. Cela permet d'avoir des fichiers
|
||||
de configuration qui calculent dynamiquement les paramètres en fonction
|
||||
de la valeur du profil.
|
||||
-N, --no-headers
|
||||
Ne pas afficher les en-têtes
|
||||
-c, --force
|
||||
Continuer le traitement même en cas d'erreur
|
||||
-r, --raw
|
||||
Ne pas autoriser mysql à mettre en échappement certaines valeurs
|
||||
retournées par le serveur. Par défaut, les transformations suivantes
|
||||
sont effectuées:
|
||||
newline --> \n
|
||||
tab --> \t
|
||||
nul --> \0
|
||||
\ --> \\
|
||||
-n, --nulls
|
||||
Transformer dans le flux en sortie les valeurs NULL en chaines vides
|
||||
-f, --input INPUT
|
||||
Lire la requête depuis le fichier input au lieu de le lire depuis la
|
||||
ligne de commande ou l'entrée standard. Ne pas spécifier cette option
|
||||
ou utiliser '-' pour lire depuis l'entrée standard.
|
||||
Cette option est ignorée si la requête est spécifiée parmi les
|
||||
arguments.
|
||||
}}}
|
||||
|
|
@ -1,112 +0,0 @@
|
|||
# -*- coding: utf-8 mode: markdown -*- vim:sw=4:sts=4:et:ai:si:sta:fenc=utf-8
|
||||
##@creator: jclain
|
||||
##@created: 27/04/2016 03:18
|
||||
##@modifier: jclain
|
||||
##@changecount: 1
|
||||
##@tags:
|
||||
##@title: mysqlloadcsv
|
||||
|
||||
{{{
|
||||
mysqlloadcsv: Charger une table MySQL avec un fichier csv
|
||||
|
||||
USAGE
|
||||
mysqlloadcsv [db.]table [fields...] [-- mysql options]
|
||||
|
||||
db est le nom de la base de données
|
||||
table est le nom de la table à charger
|
||||
fields est la liste des colonnes. Si cette valeur est spécifiée, il faudra
|
||||
peut-être utiliser l'option -s pour ignorer le cas échéant la ligne des
|
||||
en-têtes dans le fichier en entrée. Sinon, les colonnes à utiliser sont
|
||||
calculées à partir du fichier en entrée.
|
||||
|
||||
Dans les données en entrées, qui doivent être en UTF8, les conversions suivantes
|
||||
sont effectuées par MySQL:
|
||||
|
||||
\0 --> <caractère NUL>
|
||||
\b --> <backspace>
|
||||
\n --> <newline>
|
||||
\r --> <carriage return>
|
||||
\t --> <tab>
|
||||
\Z --> Ctrl+Z
|
||||
\N --> NULL
|
||||
|
||||
OPTIONS
|
||||
-h, --host host
|
||||
-P, --port port
|
||||
-u, --user user
|
||||
-ppassword
|
||||
Informations de connexion à la base de données
|
||||
-C, --config CONFIG
|
||||
Prendre les informations de connexion depuis le fichier spécifié.
|
||||
Le fichier doit être de la forme
|
||||
host=HOST.TLD
|
||||
#post=3306
|
||||
user=USER
|
||||
password=PASS
|
||||
#dbtable=DB.TABLE
|
||||
#fields=(FIELDS...)
|
||||
# Il est possible aussi de spécifier DB et TABLE séparément:
|
||||
#database=DB
|
||||
#table=TABLE
|
||||
Les variables port, dbtable et fields sont facultatives.
|
||||
Les valeurs définies dans ce fichier sont prioritaires par rapport à
|
||||
celles qui auraient été spécifiées sur la ligne de commande.
|
||||
Utiliser password=--NOT-SET-- s'il faut se connecter sans mot de passe
|
||||
Cette option peut être utilisée plusieurs fois, auquel cas les fichiers
|
||||
sont chargés dans l'ordre.
|
||||
--profile PROFILE
|
||||
La variable $PROFILE est définie avec la valeur spécifiée avant de
|
||||
sourcer les fichiers de configuration. Cela permet d'avoir des fichiers
|
||||
de configuration qui calculent dynamiquement les paramètres en fonction
|
||||
de la valeur du profil.
|
||||
-f, --input INPUT
|
||||
Fichier en entrée. Ne pas spécifier cette option ou utiliser '-' pour
|
||||
lire depuis l'entrée standard.
|
||||
-d, --auto-dbtable DB
|
||||
Spécifier la base de données avec laquelle se connecter. De plus, si le
|
||||
nom de la table n'est pas spécifié, prendre par défaut le nom de base du
|
||||
fichier spécifié avec l'option -f
|
||||
-s, --skip-lines NBLINES
|
||||
Nombre de lignes à sauter dans le fichier en entrée
|
||||
-n, --fake
|
||||
Ne pas effectuer l'opération. Afficher simplement la commande SQL.
|
||||
--run
|
||||
Forcer le lancement de l'opération. Utiliser cette option avec -A pour
|
||||
créer la table avec les paramètres analysés.
|
||||
-T, --truncate
|
||||
Vider la table avant d'effectuer le chargement
|
||||
-L, --load-data
|
||||
Charger les données avec la commande 'load data local'. C'est l'option
|
||||
par défaut. Le fichier est transmis tel quel à MySQL.
|
||||
-I, --insert-data
|
||||
Charger les données en générant des commandes 'insert into'. L'effet est
|
||||
en principe le même avec l'option -L (sauf que certains formats de date
|
||||
exotiques seront correctement importés). Cette option peut aussi être
|
||||
utilisée avec l'option -n pour générer une liste de commande à corriger
|
||||
et/ou adapter.
|
||||
-U, -k, --update-data KEY
|
||||
Au lieu de charger de nouvelles données, essayer de mettre à jour la
|
||||
table. KEY est le nom de la colonne qui est utilisée comme clé. Toutes
|
||||
les autres colonnes sont les nouvelles données à mettre à jour. Si
|
||||
aucune ligne ne correspond à une clé donnée, la mise à jour pour cette
|
||||
ligne est ignorée.
|
||||
Note: utiliser les options -T et -U ensemble n'a pas de sens, mais -T
|
||||
est quand même honoré.
|
||||
-Z, --null-value VALUE
|
||||
Avec les options -I et -U, considérer que NULL est représenté par la
|
||||
chaine spécifiée. Par défaut, utiliser \N
|
||||
-z, --null-is-empty
|
||||
Avec les options -I et -U, considérer que NULL est représenté par la
|
||||
chaine vide. Cette option est équivalente à -Z ''
|
||||
-t, --types [DEFAULT_TYPE,]FIELD:TYPE,...
|
||||
Spécifier pour chaque champ mentionné le type de donnée à forcer. Le
|
||||
type 'auto' signifie que le type est autodétecté. C'est la valeur par
|
||||
défaut. Les autres types valides sont 'str', 'int' et 'date'
|
||||
Cette option est ignorée avec l'option -L
|
||||
-A, --analyse
|
||||
Analyser les données et afficher une requête pour créer une table qui
|
||||
pourrait contenir ces données.
|
||||
Cette option implique --fake et affiche simplement la commande SQL.
|
||||
Pour lancer la commande SQL générée, il faut ajouter l'option --run
|
||||
APRES cette option
|
||||
}}}
|
||||
|
|
@ -1,11 +0,0 @@
|
|||
# -*- coding: utf-8 mode: markdown -*- vim:sw=4:sts=4:et:ai:si:sta:fenc=utf-8
|
||||
##@creator: jclain
|
||||
##@created: 27/04/2016 03:18
|
||||
##@modifier: jclain
|
||||
##@changecount: 1
|
||||
##@tags:
|
||||
##@title: noerr
|
||||
|
||||
{{{
|
||||
noerr: lancer une commande en supprimant la sortie d'erreur
|
||||
}}}
|
||||
|
|
@ -1,11 +0,0 @@
|
|||
# -*- coding: utf-8 mode: markdown -*- vim:sw=4:sts=4:et:ai:si:sta:fenc=utf-8
|
||||
##@creator: jclain
|
||||
##@created: 27/04/2016 03:18
|
||||
##@modifier: jclain
|
||||
##@changecount: 1
|
||||
##@tags:
|
||||
##@title: noerror
|
||||
|
||||
{{{
|
||||
noerror: lancer une commande en masquant son code de retour. le code de retour est toujours 0
|
||||
}}}
|
||||
|
|
@ -1,11 +0,0 @@
|
|||
# -*- coding: utf-8 mode: markdown -*- vim:sw=4:sts=4:et:ai:si:sta:fenc=utf-8
|
||||
##@creator: jclain
|
||||
##@created: 27/04/2016 03:18
|
||||
##@modifier: jclain
|
||||
##@changecount: 1
|
||||
##@tags:
|
||||
##@title: noout
|
||||
|
||||
{{{
|
||||
noout: lancer une commande en supprimant la sortie standard
|
||||
}}}
|
||||
|
|
@ -1,38 +0,0 @@
|
|||
# -*- coding: utf-8 mode: markdown -*- vim:sw=4:sts=4:et:ai:si:sta:fenc=utf-8
|
||||
##@creator: jclain
|
||||
##@created: 27/04/2016 03:18
|
||||
##@modifier: jclain
|
||||
##@changecount: 1
|
||||
##@tags:
|
||||
##@title: nutools
|
||||
|
||||
{{{
|
||||
nutools: configurer ou afficher des informations sur nutools
|
||||
|
||||
USAGE
|
||||
nutools [VERSION]
|
||||
|
||||
OPTIONS
|
||||
-C, --configure
|
||||
Faire la configuration pour l'utilisateur courant en appelant uenv -u
|
||||
Avec cette option, l'option -l (ou --local-profiles) est aussi reconnue
|
||||
et est passée directement à uenv
|
||||
-v, --version
|
||||
Afficher la version de nutools installée. C'est l'option par défaut
|
||||
-c, --check
|
||||
Calculer si la version installée correspond à la version spécifiée
|
||||
-o, --oper OPERATOR
|
||||
Spécifier l'opérateur à utiliser avec l'option --check (par défaut,
|
||||
utiliser l'opérateur ge, qui permet de vérifier si la version minimum
|
||||
spécifiée est installée)
|
||||
--eq
|
||||
--ne
|
||||
--lt
|
||||
--le
|
||||
--gt
|
||||
--ge
|
||||
--same
|
||||
--diff
|
||||
Ces options sont des raccourcis. L'option '--OP' est équivalente à
|
||||
'--check --op OP'
|
||||
}}}
|
||||
|
|
@ -1,14 +0,0 @@
|
|||
# -*- coding: utf-8 mode: markdown -*- vim:sw=4:sts=4:et:ai:si:sta:fenc=utf-8
|
||||
##@creator: jclain
|
||||
##@created: 15/03/2012 22:20
|
||||
##@modifier: jclain
|
||||
##@changecount: 1
|
||||
##@tags:
|
||||
##@title: openurl
|
||||
|
||||
{{{
|
||||
openurl: Ouvrir une URL dans un navigateur
|
||||
|
||||
USAGE
|
||||
openurl <file.url|file.desktop|URL>
|
||||
}}}
|
||||
90
doc/pdev.twp
90
doc/pdev.twp
|
|
@ -1,90 +0,0 @@
|
|||
# -*- coding: utf-8 mode: markdown -*- vim:sw=4:sts=4:et:ai:si:sta:fenc=utf-8
|
||||
##@creator: jclain
|
||||
##@created: 27/04/2016 03:18
|
||||
##@modifier: jclain
|
||||
##@changecount: 1
|
||||
##@tags:
|
||||
##@title: pdev
|
||||
|
||||
{{{
|
||||
pdev: basculer sur une branche de développement
|
||||
|
||||
USAGE
|
||||
pdev [FEATURE [SOURCE]]
|
||||
pdev -m|-l|-d [FEATURE]
|
||||
|
||||
- Vérifier l'existence de la branche develop. La créer si nécessaire en la
|
||||
basant sur [origin/]master.
|
||||
- Vérifier s'il n'y a pas de modifications locales. Sinon, proposer de faire un
|
||||
commit ou un stash.
|
||||
- Si FEATURE est spécifié, et si on n'est pas déjà sur cette branche, basculer
|
||||
vers cette nouvelle branche. S'il s'agit d'une nouvelle branche, la baser sur
|
||||
la branche SOURCE, qui vaut par défaut develop
|
||||
- Si FEATURE n'est pas spécifié, basculer sur develop s'il s'agit de la seule
|
||||
solution, sinon afficher un menu pour choisir la branche de destination.
|
||||
|
||||
OPTIONS
|
||||
-C, --projdir PROJDIR
|
||||
Spécifier le répertoire de base du projet qui est dans git. Par défaut,
|
||||
on travaille dans le répertoire courant et on laisse git trouver le
|
||||
répertoire de base du projet. Avec cette option, le répertoire courant
|
||||
est modifié avant de lancer les commandes git.
|
||||
-O, --origin ORIGIN
|
||||
Spécifier le nom de l'origine. Par défaut, utiliser 'origin'
|
||||
-o, --offline
|
||||
En cas de création d'une branche, ne pas pousser vers l'origine; ne pas
|
||||
tenter le cas échéant de traquer la branche dans l'origine; ne pas
|
||||
supprimer une branche dans l'origine. Cette option est automatiquement
|
||||
activée si la variable UTOOLS_VCS_OFFLINE est définie.
|
||||
--online
|
||||
Annuler l'effet de la variable UTOOLS_VCS_OFFLINE: forcer le mode online
|
||||
--sync
|
||||
Faire un certain nombre d'opération pour 'corriger' le dépôt local: pour
|
||||
chacune des branches distantes, vérifier qu'il existe une branche locale
|
||||
qui la traque, et pour chaque feature branche locale, vérifier qu'il
|
||||
existe une branche distante associée. Cette option nécessite --online
|
||||
|
||||
-s, --squash COMMIT_MSG
|
||||
Si la branche actuelle est une feature branch, la merger comme un seul
|
||||
commit avec le message COMMIT_MSG dans develop puis la supprimer. Puis
|
||||
basculer sur la branche develop.
|
||||
Cette option ne devrait pas être utilisée avec -k, puisque bien que les
|
||||
modifications soient mergées, la branche elle-même n'est pas considérée
|
||||
comme mergée. Les résultats sont donc indéfinis si la branche est mergée
|
||||
à plusieurs reprises.
|
||||
-b, --rebase
|
||||
Si la branche actuelle est une feature branch, lancer 'git rebase -i'
|
||||
sur la feature branch. Cela permet de réordonner les commits pour
|
||||
nettoyer l'historique avant de fusionner la branche avec -m
|
||||
Cette option devrait le cas échéant être utilisée immédiatement avant -m
|
||||
ou alors il faut forcer le push et communiquer avec l'équipe sur le fait
|
||||
que la branche de feature a été rebasée.
|
||||
-m, --merge
|
||||
Si la branche actuelle est une feature branch, la merger dans develop
|
||||
puis la supprimer. Puis basculer sur la branche develop.
|
||||
--merge-log
|
||||
Ajouter un résumé des modifications sur la feature branch en ajoutant le
|
||||
log en une ligne de chaque commit dans le message du merge. Cette option
|
||||
n'est en principe pas nécessaire puisque 'prel -um' intègre la liste des
|
||||
commits dans CHANGES.txt
|
||||
-k, --keep
|
||||
Avec l'option -m, ne pas supprimer une feature branch après l'avoir
|
||||
fusionnée dans develop. Cela permet d'intégrer les modifications petit à
|
||||
petit.
|
||||
--delete
|
||||
Supprimer une feature branch, à condition qu'elle aie déjà été
|
||||
entièrement fusionnée dans la branch develop
|
||||
--force-delete
|
||||
Supprimer une feature branch, même si elle n'a pas encore été fusionnée
|
||||
dans la branche develop
|
||||
|
||||
-l, --log
|
||||
-d, --diff
|
||||
Afficher les modifications entre deux branches. L'option --log affiche
|
||||
les modifications dans l'ordre alors que --diff affiche les différences
|
||||
sous forme de diff. Les deux options peuvent être combinées et ont
|
||||
l'effet de 'git log -p'
|
||||
La branche comparée, s'il elle n'est pas spécifiée, est par défaut la
|
||||
branche courante. S'il s'agit d'une feature branch, elle est comparée à
|
||||
develop. S'il s'agit de la branche develop, elle est comparée à master.
|
||||
}}}
|
||||
105
doc/prel.twp
105
doc/prel.twp
|
|
@ -1,105 +0,0 @@
|
|||
# -*- coding: utf-8 mode: markdown -*- vim:sw=4:sts=4:et:ai:si:sta:fenc=utf-8
|
||||
##@creator: jclain
|
||||
##@created: 27/04/2016 03:18
|
||||
##@modifier: jclain
|
||||
##@changecount: 1
|
||||
##@tags:
|
||||
##@title: prel
|
||||
|
||||
{{{
|
||||
prel: basculer sur une branche de release
|
||||
|
||||
USAGE
|
||||
prel -u [SOURCE]
|
||||
prel -c [RELEASE [SOURCE]]
|
||||
prel -m|-l|-d [RELEASE]
|
||||
|
||||
- Vérifier s'il n'y a pas de modifications locales. Sinon, proposer de faire un
|
||||
commit ou un stash.
|
||||
- Avec l'option -c, s'il existe une branche de release, proposer de basculer
|
||||
vers elle ou sur la branche master. Sinon, basculer sur la branche master.
|
||||
- Avec l'option -u, proposer ou fixer une branche de release à créer. Si elle
|
||||
existe déjà, basculer vers elle. Sinon, la créer en la basant sur SOURCE, qui
|
||||
vaut par défaut develop
|
||||
|
||||
OPTIONS
|
||||
-C, --projdir PROJDIR
|
||||
Spécifier le répertoire de base du projet qui est dans git. Par défaut,
|
||||
on travaille dans le répertoire courant et on laisse git trouver le
|
||||
répertoire de base du projet. Avec cette option, le répertoire courant
|
||||
est modifié avant de lancer les commandes git.
|
||||
-O, --origin ORIGIN
|
||||
Spécifier le nom de l'origine. Par défaut, utiliser 'origin'
|
||||
-o, --offline
|
||||
En cas de création d'une branche, ne pas pousser vers l'origine; ne pas
|
||||
tenter le cas échéant de traquer la branche dans l'origine; ne pas
|
||||
supprimer une branche dans l'origine. Cette option est automatiquement
|
||||
activée si la variable UTOOLS_VCS_OFFLINE est définie.
|
||||
--online
|
||||
Annuler l'effet de la variable UTOOLS_VCS_OFFLINE: forcer le mode online
|
||||
|
||||
-c, --checkout
|
||||
Basculer vers une branche de release existante. C'est l'option par
|
||||
défaut. Si aucune branche de release n'existe, basculer vers master
|
||||
-u, --update
|
||||
Préparer une nouvelle release. Utiliser une des options -x, -z ou -p
|
||||
pour spécifier le type de release à préparer. Si la branche qui serait
|
||||
créée pour le type de release existe déjà, basculer vers cette branche.
|
||||
S'il faut la créer, la baser sur la branche SOURCE, qui vaut par défaut
|
||||
develop
|
||||
--menu
|
||||
-x, --major
|
||||
-z, --minor
|
||||
-p, --patchlevel
|
||||
Utilisé avec l'option -u, soit afficher un menu pour choisir la version
|
||||
de la nouvelle release (par défaut), soit préparer respectivement une
|
||||
release majeure, mineure, ou pour correction de bug.
|
||||
-v-OPT
|
||||
Avec l'option -u, spécifier une option de pver permettant de choisir la
|
||||
version de la nouvelle release. Les options supportées sont -v, -l, -a,
|
||||
-b, -r et -R. Par exemple, si la version actuelle sur la branche master
|
||||
est 0.2.3, les options '-uz -v-lbeta' permettent de préparer la release
|
||||
0.3.0-beta
|
||||
En principe, cette option n'a pas à être utilisée, puisque dans une
|
||||
branche de release, on peut faire vivre les versions de pré-release
|
||||
jusqu'à la release finale. Ainsi, la branche de release est nommée
|
||||
d'après la version finale, mais le projet peut recevoir une version de
|
||||
pré-release incrémentale.
|
||||
-w, --write
|
||||
Si une nouvelle branche est créée avec -u, mettre à jour le fichier
|
||||
VERSION.txt avec pver. C'est l'option par défaut.
|
||||
-n, --no-write
|
||||
Si une nouvelle branche est créée avec -u, NE PAS mettre à jour le
|
||||
fichier VERSION.txt avec pver. Utiliser cette option si la mise à jour
|
||||
du numéro de version doit être faite d'une manière particulière.
|
||||
-e, --edit
|
||||
Editer le fichier CHANGES.txt autogénéré par -u -w
|
||||
Cette option est surtout utile si -m est utilisé avec -u, pour donner la
|
||||
possibilité de corriger la liste des modifications avant leur
|
||||
enregistrement définitif.
|
||||
|
||||
-m, --merge
|
||||
Si la branche actuelle est une branche de release, ou s'il existe une
|
||||
branche de release, la merger dans master, puis dans develop, puis la
|
||||
supprimer. Puis basculer sur la branche master.
|
||||
S'il n'existe pas de branche de release, proposer de fusionner les
|
||||
modifications de la branche develop dans la branche master, sans
|
||||
préparer de branche de release au préalable.
|
||||
--delete
|
||||
Supprimer une branche de release, à condition qu'elle aie déjà été
|
||||
entièrement fusionnée dans la branch master
|
||||
--force-delete
|
||||
Supprimer une branche de release, même si elle n'a pas encore été
|
||||
fusionnée dans la branche master
|
||||
|
||||
-s, --summary
|
||||
Afficher la liste des différences entre la branche develop et la branche
|
||||
master, comme elle serait générée par les options -u -w pour le fichier
|
||||
CHANGES.txt
|
||||
-l, --log
|
||||
Afficher les modifications actuellement effectuée dans la branche de
|
||||
release par rapport à develop.
|
||||
-d, --diff
|
||||
Afficher les modifications actuellement effectuée dans la branche de
|
||||
release par rapport à develop, sous forme de diff.
|
||||
}}}
|
||||
98
doc/pver.md
98
doc/pver.md
|
|
@ -1,98 +0,0 @@
|
|||
# pver
|
||||
|
||||
~~~
|
||||
pver: gérer des numéros de version selon les règles du versionage sémantique v2.0.0 (http://semver.org/)
|
||||
|
||||
USAGE
|
||||
pver [options]
|
||||
|
||||
OPTIONS
|
||||
-f, --file VERSIONFILE
|
||||
Gérer le numéro de version se trouvant dans le fichier spécifié. Le
|
||||
fichier est créé si nécessaire. C'est l'option par défaut si un fichier
|
||||
nommé VERSION.txt se trouve dans le répertoire courant.
|
||||
-e, --maven POMFILE
|
||||
Gérer le numéro de version se trouvant dans le fichier pom.xml spécifié.
|
||||
Le fichier DOIT exister. C'est l'option par défaut si un fichier nommé
|
||||
pom.xml se trouve dans le répertoire courant.
|
||||
-F, --file-string VERSIONFILE
|
||||
Prendre pour valeur de départ le contenu du fichier VERSIONFILE (qui
|
||||
vaut par défaut VERSION.txt)
|
||||
-g, --git-string [branch:]VERSIONFILE
|
||||
Prendre pour valeur de départ le contenu du fichier VERSIONFILE (qui
|
||||
vaut par défaut VERSION.txt) dans la branche BRANCH (qui vaut par défaut
|
||||
master) du dépôt git situé dans le répertoire courant.
|
||||
-s, --string VERSION
|
||||
Prendre pour valeur de départ le numéro de version spécifié
|
||||
|
||||
--show
|
||||
Afficher le numéro de version. C'est l'action par défaut
|
||||
--allow-empty
|
||||
Supporter que la version puisse ne pas être spécifiée ni trouvée. Dans
|
||||
ce cas, ne pas assumer que la version effective est 0.0.0
|
||||
Avec --show et --update, ne rien afficher si la version est vide.
|
||||
--check
|
||||
Vérifier que le numéro de version est conforme aux règles du versionage
|
||||
sémantique
|
||||
--convert
|
||||
--no-convert
|
||||
Activer (resp. désactiver) la conversion automatique. Par défaut, si la
|
||||
version est au format classique 'x.z[.p]-rDD/MM/YYYY', elle est
|
||||
convertie automatiquement au format sémantique x.z.p+rYYYYMMDD
|
||||
--eq VERSION
|
||||
--ne VERSION
|
||||
--lt VERSION
|
||||
--le VERSION
|
||||
--gt VERSION
|
||||
--ge VERSION
|
||||
--same VERSION
|
||||
--diff VERSION
|
||||
Comparer avec la version spécifiée. Les opérateurs --eq, --ne, --lt,
|
||||
--le, --gt, et --ge ignorent l'identifiant de build (comme le demande la
|
||||
règle du versionage sémantique). Les opérateurs --same et --diff
|
||||
comparent aussi les identifiants de build.
|
||||
-v, --set-version VERSION
|
||||
Spécifier un nouveau numéro de version qui écrase la valeur actuelle.
|
||||
Cette option ne devrait pas être utilisée en temps normal parce que cela
|
||||
va contre les règles du versionage sémantique.
|
||||
--prel
|
||||
Spécifier un nouveau numéro de version qui écrase la valeur actuelle. Le
|
||||
numéro de version est obtenu à partir du nom de la branche git courante,
|
||||
qui doit être de la forme release-VERSION
|
||||
-u, --update
|
||||
Mettre à jour le numéro de version.
|
||||
|
||||
--menu
|
||||
Afficher un menu permettant de choisir le composant de la version à
|
||||
incrémenter
|
||||
-x, --major
|
||||
Augmenter le numéro de version majeure
|
||||
-z, --minor
|
||||
Augmenter le numéro de version mineure. C'est la valeur par défaut.
|
||||
-p, --patchlevel
|
||||
Augmenter le numéro de patch
|
||||
|
||||
-l, --prelease ID
|
||||
Spécifier un identifiant de pré-release, à ajouter au numéro de version.
|
||||
-a, --alpha
|
||||
-b, --beta
|
||||
-r, --rc
|
||||
Spécifier une pré-release de type alpha, beta, ou rc. Si la version est
|
||||
déjà dans ce type, augmenter la dernière valeur numérique des composants
|
||||
de l'identifiant, e.g. alpha deviant alpha.1, beta-1.2 devient beta-1.3,
|
||||
rc1 devient rc2
|
||||
XXX ces fonctions ne sont pas encore implémentées
|
||||
-R, --final, --release
|
||||
Supprimer l'identifiant de prérelease
|
||||
|
||||
-m, --metadata ID
|
||||
Spécifier un identifiant de build, à ajouter au numéro de version.
|
||||
-M, --vcs-metadata
|
||||
Spécifier l'identifiant à partir de la révision actuelle dans le
|
||||
gestionnaire de version. Note: pour le moment, seul git est supporté.
|
||||
--add-metadata ID
|
||||
Ajouter l'identifiant spécifié à la valeur actuelle, au lieu de la
|
||||
remplacer. Séparer l'identifiant de la valeur précédente avec un '.'
|
||||
~~~
|
||||
|
||||
-*- coding: utf-8 mode: markdown -*- vim:sw=4:sts=4:et:ai:si:sta:fenc=utf-8:noeol:binary
|
||||
102
doc/pver.twp
102
doc/pver.twp
|
|
@ -1,102 +0,0 @@
|
|||
# -*- coding: utf-8 mode: markdown -*- vim:sw=4:sts=4:et:ai:si:sta:fenc=utf-8
|
||||
##@creator: jclain
|
||||
##@created: 27/04/2016 03:18
|
||||
##@modifier: jclain
|
||||
##@changecount: 1
|
||||
##@tags:
|
||||
##@title: pver
|
||||
|
||||
{{{
|
||||
pver: gérer des numéros de version selon les règles du versionage sémantique v2.0.0 (http://semver.org/)
|
||||
|
||||
USAGE
|
||||
pver [options]
|
||||
|
||||
OPTIONS
|
||||
-f, --file VERSIONFILE
|
||||
Gérer le numéro de version se trouvant dans le fichier spécifié. Le
|
||||
fichier est créé si nécessaire. C'est l'option par défaut si un fichier
|
||||
nommé VERSION.txt se trouve dans le répertoire courant.
|
||||
-e, --maven POMFILE
|
||||
Gérer le numéro de version se trouvant dans le fichier pom.xml spécifié.
|
||||
Le fichier DOIT exister. C'est l'option par défaut si un fichier nommé
|
||||
pom.xml se trouve dans le répertoire courant.
|
||||
-F, --file-string VERSIONFILE
|
||||
Prendre pour valeur de départ le contenu du fichier VERSIONFILE (qui
|
||||
vaut par défaut VERSION.txt)
|
||||
-g, --git-string [branch:]VERSIONFILE
|
||||
Prendre pour valeur de départ le contenu du fichier VERSIONFILE (qui
|
||||
vaut par défaut VERSION.txt) dans la branche BRANCH (qui vaut par défaut
|
||||
master) du dépôt git situé dans le répertoire courant.
|
||||
-s, --string VERSION
|
||||
Prendre pour valeur de départ le numéro de version spécifié
|
||||
|
||||
--show
|
||||
Afficher le numéro de version. C'est l'action par défaut
|
||||
--allow-empty
|
||||
Supporter que la version puisse ne pas être spécifiée ni trouvée. Dans
|
||||
ce cas, ne pas assumer que la version effective est 0.0.0
|
||||
Avec --show et --update, ne rien afficher si la version est vide.
|
||||
--check
|
||||
Vérifier que le numéro de version est conforme aux règles du versionage
|
||||
sémantique
|
||||
--convert
|
||||
--no-convert
|
||||
Activer (resp. désactiver) la conversion automatique. Par défaut, si la
|
||||
version est au format classique 'x.z[.p]-rDD/MM/YYYY', elle est
|
||||
convertie automatiquement au format sémantique x.z.p+rYYYYMMDD
|
||||
--eq VERSION
|
||||
--ne VERSION
|
||||
--lt VERSION
|
||||
--le VERSION
|
||||
--gt VERSION
|
||||
--ge VERSION
|
||||
--same VERSION
|
||||
--diff VERSION
|
||||
Comparer avec la version spécifiée. Les opérateurs --eq, --ne, --lt,
|
||||
--le, --gt, et --ge ignorent l'identifiant de build (comme le demande la
|
||||
règle du versionage sémantique). Les opérateurs --same et --diff
|
||||
comparent aussi les identifiants de build.
|
||||
-v, --set-version VERSION
|
||||
Spécifier un nouveau numéro de version qui écrase la valeur actuelle.
|
||||
Cette option ne devrait pas être utilisée en temps normal parce que cela
|
||||
va contre les règles du versionage sémantique.
|
||||
--prel
|
||||
Spécifier un nouveau numéro de version qui écrase la valeur actuelle. Le
|
||||
numéro de version est obtenu à partir du nom de la branche git courante,
|
||||
qui doit être de la forme release-VERSION
|
||||
-u, --update
|
||||
Mettre à jour le numéro de version.
|
||||
|
||||
--menu
|
||||
Afficher un menu permettant de choisir le composant de la version à
|
||||
incrémenter
|
||||
-x, --major
|
||||
Augmenter le numéro de version majeure
|
||||
-z, --minor
|
||||
Augmenter le numéro de version mineure. C'est la valeur par défaut.
|
||||
-p, --patchlevel
|
||||
Augmenter le numéro de patch
|
||||
|
||||
-l, --prelease ID
|
||||
Spécifier un identifiant de pré-release, à ajouter au numéro de version.
|
||||
-a, --alpha
|
||||
-b, --beta
|
||||
-r, --rc
|
||||
Spécifier une pré-release de type alpha, beta, ou rc. Si la version est
|
||||
déjà dans ce type, augmenter la dernière valeur numérique des composants
|
||||
de l'identifiant, e.g. alpha deviant alpha.1, beta-1.2 devient beta-1.3,
|
||||
rc1 devient rc2
|
||||
XXX ces fonctions ne sont pas encore implémentées
|
||||
-R, --final, --release
|
||||
Supprimer l'identifiant de prérelease
|
||||
|
||||
-m, --metadata ID
|
||||
Spécifier un identifiant de build, à ajouter au numéro de version.
|
||||
-M, --vcs-metadata
|
||||
Spécifier l'identifiant à partir de la révision actuelle dans le
|
||||
gestionnaire de version. Note: pour le moment, seul git est supporté.
|
||||
--add-metadata ID
|
||||
Ajouter l'identifiant spécifié à la valeur actuelle, au lieu de la
|
||||
remplacer. Séparer l'identifiant de la valeur précédente avec un '.'
|
||||
}}}
|
||||
24
doc/pz.twp
24
doc/pz.twp
|
|
@ -1,24 +0,0 @@
|
|||
# -*- coding: utf-8 mode: markdown -*- vim:sw=4:sts=4:et:ai:si:sta:fenc=utf-8
|
||||
##@creator: jclain
|
||||
##@created: 27/04/2016 03:18
|
||||
##@modifier: jclain
|
||||
##@changecount: 1
|
||||
##@tags:
|
||||
##@title: pz
|
||||
|
||||
{{{
|
||||
pz: faire une archive du projet
|
||||
|
||||
USAGE
|
||||
pz
|
||||
|
||||
OPTIONS
|
||||
-C, --projdir PROJDIR
|
||||
Spécifier le répertoire de base du projet qui est dans git. Par défaut,
|
||||
on travaille dans le répertoire courant et on laisse git trouver le
|
||||
répertoire de base du projet. Avec cette option, le répertoire courant
|
||||
est modifié avant de lancer les commandes git.
|
||||
-d, --destdir DESTDIR
|
||||
Spécifier le répertoire dans lequel générer l'archive. Par défaut,
|
||||
prendre le répertoire parent du répertoire de base du dépôt.
|
||||
}}}
|
||||
|
|
@ -1,20 +0,0 @@
|
|||
# -*- coding: utf-8 mode: markdown -*- vim:sw=4:sts=4:et:ai:si:sta:fenc=utf-8
|
||||
##@creator: jclain
|
||||
##@created: 27/04/2016 03:18
|
||||
##@modifier: jclain
|
||||
##@changecount: 1
|
||||
##@tags:
|
||||
##@title: reptyr.cgo
|
||||
|
||||
{{{
|
||||
Usage: reptyr [-s] PID
|
||||
reptyr -l|-L [COMMAND [ARGS]]
|
||||
-l Create a new pty pair and print the name of the slave.
|
||||
if there are command-line arguments after -l
|
||||
they are executed with REPTYR_PTY set to path of pty.
|
||||
-L Like '-l', but also redirect the child's stdio to the slave.
|
||||
-s Attach fds 0-2 on the target, even if it is not attached to a tty.
|
||||
-h Print this help message and exit.
|
||||
-v Print the version number and exit.
|
||||
-V Print verbose debug output.
|
||||
}}}
|
||||
|
|
@ -1,16 +0,0 @@
|
|||
# -*- coding: utf-8 mode: markdown -*- vim:sw=4:sts=4:et:ai:si:sta:fenc=utf-8
|
||||
##@creator: jclain
|
||||
##@created: 15/03/2012 22:20
|
||||
##@modifier: jclain
|
||||
##@changecount: 1
|
||||
##@tags:
|
||||
##@title: rmtildes
|
||||
|
||||
{{{
|
||||
rmtildes: supprimer les fichiers *~ dans le répertoire courant
|
||||
|
||||
USAGE
|
||||
rmtildes [dir [glob]]
|
||||
|
||||
Par défaut, dir==. et glob==*~
|
||||
}}}
|
||||
|
|
@ -1,78 +0,0 @@
|
|||
# -*- coding: utf-8 mode: markdown -*- vim:sw=4:sts=4:et:ai:si:sta:fenc=utf-8
|
||||
##@creator: jclain
|
||||
##@created: 27/04/2016 03:18
|
||||
##@modifier: jclain
|
||||
##@changecount: 1
|
||||
##@tags:
|
||||
##@title: rruns
|
||||
|
||||
{{{
|
||||
rruns: Déploiement distant avec runs
|
||||
|
||||
USAGE
|
||||
rruns [-h hosts] [-T tmproot] rscriptname name=value...
|
||||
rruns [-h hosts] [-T tmproot] @recipe name=value...
|
||||
rruns [-h hosts] [-T tmproot] -f rscript name=value...
|
||||
rruns [-h hosts] [-T tmproot] -r recipe name=value...
|
||||
|
||||
Lancer ce script sans argument (hors options) est équivalent à le lancer avec
|
||||
l'argument @default
|
||||
|
||||
OPTIONS
|
||||
-C Ne pas faire le déploiement. Configurer uniquement la connexion par clé
|
||||
sur les hôtes distants spécifiés pour le user spécifié. Il faut pouvoir
|
||||
se connecter par mot de passe pour configurer la connexion par clé.
|
||||
Si l'on veut configurer la connexion par clé pour le user root, mais que
|
||||
ce n'est pas possible de se connecter par mot de passe avec le user root
|
||||
sur l'hôte distant, et qu'il existe un user sudoer sur l'hôte distant,
|
||||
il est possible de faire la configuration avec '--configure root'. La
|
||||
commande serait alors
|
||||
rruns -h user@host --configure root
|
||||
-T tmproot
|
||||
Spécifier le répertoire temporaire sur l'hôte distant, comme par exemple
|
||||
/var/tmp. Cette option est utile pour les vservers, qui ont par défaut
|
||||
un /tmp minuscule de 16 Mo.
|
||||
-S ssh
|
||||
Spécifier le programme à utiliser pour la connection par ssh.
|
||||
-h host
|
||||
-h @hostsfile
|
||||
Spécifier un ou plusieurs hôtes sur lequels faire le déploiement. Pour
|
||||
spécifier plusieurs hôtes, il est possible d'utiliser plusieurs fois
|
||||
l'option -h, ou spécifier en une seule fois plusieurs hôtes en les
|
||||
séparant par un espace ou le caractère ':', e.g. 'host1 host2' ou
|
||||
'host1:host2'. Si la spécification contient les caractères { et },
|
||||
l'expansion est effectuée, e.g
|
||||
-h 'root@{host1,host2}.univ.run'
|
||||
Par défaut, la connexion sur l'hôte distant se fait avec l'utilisateur
|
||||
root. Il est possible de spécifier un autre utilisateur avec la syntaxe
|
||||
user@host, e.g -h user@host
|
||||
La forme @hostsfile permet de lire la liste des hôtes depuis le fichier
|
||||
hostsfile, à raison d'un hôte par ligne.
|
||||
Si cette option n'est pas spécifiée, et que le répertoire courant est
|
||||
dans un des répertoires de $RUNSHOSTSPATH, sélectionner l'hôte
|
||||
correspondant. Sinon, l'utilisateur doit saisir l'hôte distant de façon
|
||||
interactive.
|
||||
-f RSCRIPT
|
||||
Lancer le script individuel spécifié au lieu de chercher dans les
|
||||
répertoires $RUNS{SCRIPTS,HOSTS}PATH
|
||||
-r RECIPE
|
||||
Lancer les scripts spécifiés dans le fichier de recettes individuel
|
||||
spécifié.
|
||||
-z Forcer la réinstallation des scripts qui se basent sur shouldrun/setdone
|
||||
-o OUTPUT
|
||||
Générer l'archive à lancer sur l'hôte distant au lieu de faire le
|
||||
déploiement. Si plusieurs hôtes sont spécifiés, OUTPUT est considéré
|
||||
comme un nom de base auquel est ajouté le nom de l'hôte sur lequel
|
||||
l'archive doit être déployée.
|
||||
--init
|
||||
--no-init
|
||||
Forcer (resp. empêcher) la création des répertoires d'hôte correspondant
|
||||
aux hôtes spécifiés. Par défaut, la création des répertoires d'hôte est
|
||||
effectuée uniquement si ce script est lancé sans argument.
|
||||
--sysinfos
|
||||
Après un déploiement réussi sur l'hôte distant, inscrire si ce n'est
|
||||
déjà fait le résultat de la commande usysinfos dans le fichier
|
||||
sysinfos.conf du répertoire d'hôte.
|
||||
Cette option est automatiquement activée si ce script est lancé sans
|
||||
argument (hors options).
|
||||
}}}
|
||||
|
|
@ -1,52 +0,0 @@
|
|||
# -*- coding: utf-8 mode: markdown -*- vim:sw=4:sts=4:et:ai:si:sta:fenc=utf-8
|
||||
##@creator: jclain
|
||||
##@created: 27/04/2016 03:18
|
||||
##@modifier: jclain
|
||||
##@changecount: 1
|
||||
##@tags:
|
||||
##@title: ruinst
|
||||
|
||||
{{{
|
||||
ruinst: Déploiement distant avec uinst
|
||||
|
||||
USAGE
|
||||
ruinst [-h host] [-T tmproot] <file|archive|dir> [-- options de uinst]
|
||||
|
||||
note: à cause d'une limitation de makeself, les options de uinst ne devraient
|
||||
pas contenir d'espaces ni de caractères spéciaux. L'échappement de ces
|
||||
caractères n'est pas garanti.
|
||||
|
||||
OPTIONS
|
||||
-C Ne pas faire le déploiement. Configurer uniquement la connexion par clé
|
||||
sur les hôtes distants spécifiés pour le user spécifié. Il faut pouvoir
|
||||
se connecter par mot de passe pour configurer la connexion par clé.
|
||||
Si l'on veut configurer la connexion par clé pour le user root, mais que
|
||||
ce n'est pas possible de se connecter par mot de passe avec le user root
|
||||
sur l'hôte distant, et qu'il existe un user sudoer sur l'hôte distant,
|
||||
il est possible de faire la configuration avec '--configure root'. La
|
||||
commande serait alors
|
||||
ruinst -h user@host --configure root
|
||||
Si l'hôte distant n'a pas sudo ou si sudo n'est pas configuré, il faut
|
||||
rajouter l'option --uses-su, e.g:
|
||||
ruinst -h user@host --configure root --uses-su
|
||||
-T tmproot
|
||||
Spécifier le répertoire temporaire sur l'hôte distant, comme par exemple
|
||||
/var/tmp. Cette option est utile pour les vservers, qui ont par défaut
|
||||
un /tmp minuscule de 16 Mo.
|
||||
-S, --ssh ssh
|
||||
Spécifier le programme à utiliser pour la connection par ssh.
|
||||
-h hosts
|
||||
-h @hostsfile
|
||||
Spécifier un ou plusieurs hôtes sur lequels faire le déploiement. Pour
|
||||
spécifier plusieurs hôtes, il est possible d'utiliser plusieurs fois
|
||||
l'option -h, ou spécifier en une seule fois plusieurs hôtes en les
|
||||
séparant par un espace ou le caractère ':', e.g. 'host1 host2' ou
|
||||
'host1:host2'. Si la spécification contient les caractères { et },
|
||||
l'expansion est effectuée, e.g
|
||||
-h 'root@{host1,host2}.univ.run'
|
||||
Par défaut, la connexion sur l'hôte distant se fait avec l'utilisateur
|
||||
root. Il est possible de spécifier un autre utilisateur avec la syntaxe
|
||||
user@host, e.g -h user@host
|
||||
La forme @hostsfile permet de lire la liste des hôtes depuis le fichier
|
||||
hostsfile, à raison d'un hôte par ligne.
|
||||
}}}
|
||||
|
|
@ -1,18 +0,0 @@
|
|||
# -*- coding: utf-8 mode: markdown -*- vim:sw=4:sts=4:et:ai:si:sta:fenc=utf-8
|
||||
##@creator: jclain
|
||||
##@created: 27/04/2016 03:18
|
||||
##@modifier: jclain
|
||||
##@changecount: 1
|
||||
##@tags:
|
||||
##@title: rumount
|
||||
|
||||
{{{
|
||||
rumount: démonter un système de fichier récursivement
|
||||
|
||||
USAGE
|
||||
rumount mountpoint
|
||||
|
||||
Démonter tous les systèmes de fichiers qui sont montés en-dessous de mountpoint
|
||||
puis démonter mountpoint. Démonter aussi tous les systèmes de fichiers
|
||||
bind-montés à partir d'un sous-répertoire de mountpoint.
|
||||
}}}
|
||||
62
doc/runs.twp
62
doc/runs.twp
|
|
@ -1,62 +0,0 @@
|
|||
# -*- coding: utf-8 mode: markdown -*- vim:sw=4:sts=4:et:ai:si:sta:fenc=utf-8
|
||||
##@creator: jclain
|
||||
##@created: 27/04/2016 03:19
|
||||
##@modifier: jclain
|
||||
##@changecount: 1
|
||||
##@tags:
|
||||
##@title: runs
|
||||
|
||||
{{{
|
||||
runs: Lancer un script avec le protocole runs
|
||||
|
||||
USAGE
|
||||
runs [options] rscriptname name=value...
|
||||
runs [options] @recipe name=value...
|
||||
runs [options] -f rscript name=value...
|
||||
runs [options] -r recipe name=value...
|
||||
|
||||
OPTIONS
|
||||
Configuration
|
||||
--init
|
||||
--verify
|
||||
Vérifier le nom d'hôte et créer si nécessaire le répertoire d'hôte
|
||||
correspondant à l'hôte courant ou à l'hôte spécifié avec l'option -h
|
||||
Avec --verify, la création du répertoire d'hôte n'est pas effectuée.
|
||||
--sysinfos DATA
|
||||
Avec l'option --init, initialiser le fichier sysinfos.conf avec DATA, si
|
||||
le fichier n'a pas déjà été provisionné. Sans cette option, un fichier
|
||||
vide avec des commentaires est créé à la place.
|
||||
--create RSCRIPT
|
||||
Créer un modèle de script avec le nom donné.
|
||||
Avec l'option -h, le script est créé dans le répertoire d'hôte
|
||||
correspondant à l'hôte spécifié
|
||||
|
||||
Gestion des scripts
|
||||
-s Forcer l'exécution du script avec l'utilisateur root si ce n'est pas
|
||||
déjà le cas
|
||||
-f RSCRIPT
|
||||
Lancer le script individuel spécifié au lieu de chercher dans les
|
||||
répertoires de $RUNSSCRIPTSPATH
|
||||
-r RECIPE
|
||||
Lancer les scripts spécifiés dans le fichier de recettes individuel
|
||||
spécifié.
|
||||
-h HOSTNAME[.DOMAIN]
|
||||
Spécifier que les scripts sont destinés à être lancés sur l'hôte
|
||||
spécifié. Les scripts sont alors aussi cherchés dans les répertoires
|
||||
{$RUNSHOSTSPATH}/$hostname.$domain (par défaut) et
|
||||
{$RUNSHOSTSPATH}/$domain/$hostname (le cas échéant)
|
||||
L'option --host est équivalente, sauf que son argument est facultatif et
|
||||
que sa valeur par défaut est l'hôte courant, soit sulfure
|
||||
--list
|
||||
Afficher la liste des scripts qui sont disponibles. Avec l'option -h,
|
||||
inclure aussi les scripts spécifiques à cet hôte.
|
||||
Avec cette option, les arguments supplémentaires agissent comme des
|
||||
filtres (regexp utilisée avec l'opérateur == de la commande [[). Les
|
||||
noms des scripts doivent valider au moins un filtre.
|
||||
--info
|
||||
Afficher la la description du script et la valeur de chaque variable
|
||||
définies
|
||||
--desc-only
|
||||
Afficher seulement la description du script
|
||||
-z Forcer la réinstallation des scripts qui se basent sur shouldrun/setdone
|
||||
}}}
|
||||
|
|
@ -1,37 +0,0 @@
|
|||
# -*- coding: utf-8 mode: markdown -*- vim:sw=4:sts=4:et:ai:si:sta:fenc=utf-8
|
||||
##@creator: jclain
|
||||
##@created: 27/04/2016 03:19
|
||||
##@modifier: jclain
|
||||
##@changecount: 1
|
||||
##@tags:
|
||||
##@title: runsconfig
|
||||
|
||||
{{{
|
||||
runsconfig: Gérer un répertoire d'hôte de runs
|
||||
|
||||
USAGE
|
||||
runsconfig -c [host [destdir]]
|
||||
runsconfig -t -- args...
|
||||
|
||||
OPTIONS
|
||||
-c, --create
|
||||
Créer un nouveau répertoire de configuration pour un hôte
|
||||
-d, --destdir DESTDIR[=runs]
|
||||
Nom du répertoire local de configuration.
|
||||
|
||||
-t, --template [OPT]
|
||||
Gérer les fichiers du répertoire local avec templatectl. La valeur de
|
||||
cette option est utilisée comme argument court pour l'invocation de
|
||||
templatectl, e.g
|
||||
runsconfig -tm args
|
||||
est équivalent à
|
||||
templatectl -m args
|
||||
Les arguments qui restent sont passés tels quels à templatectl
|
||||
Les options courantes de templatectl -l, -v, -m, -L sont disponibles
|
||||
directement
|
||||
--help-template
|
||||
Afficher l'aide concernent la gestion des templates.
|
||||
Equivalent à -t -- --help
|
||||
-h, --host HOST
|
||||
Spécifier l'hôte. Equivalent à -v host=HOST
|
||||
}}}
|
||||
|
|
@ -1,70 +0,0 @@
|
|||
# -*- coding: utf-8 mode: markdown -*- vim:sw=4:sts=4:et:ai:si:sta:fenc=utf-8
|
||||
##@creator: jclain
|
||||
##@created: 27/04/2016 03:19
|
||||
##@modifier: jclain
|
||||
##@changecount: 1
|
||||
##@tags:
|
||||
##@title: runsmod
|
||||
|
||||
{{{
|
||||
runsmod: récupérer des dépôts git à usage de runs
|
||||
|
||||
USAGE
|
||||
runsmod [options] [-h host] [modules...]
|
||||
|
||||
Tous les dépôts spécifiés dans la configuration sont récupérés. Si des modules
|
||||
sont spécifiés, les dépôts correspondants sont récupérés aussi. Avec l'option
|
||||
-h, des dépôts spécifiques à l'hôte peuvent éventuellement être récupérés en
|
||||
plus.
|
||||
|
||||
OPTIONS
|
||||
-c, --config CONFIG
|
||||
Spécifier un fichier de configuration à charger au lieu de la valeur par
|
||||
défaut ~/etc/default/runs
|
||||
--prod
|
||||
--devel
|
||||
Forcer un mode de sélection des urls. En mode production, préférer pour
|
||||
le clonage les urls de production, qui sont en principe accessibles sans
|
||||
authentification et en lecture seule. En mode développement, préférer
|
||||
pour le clonage les urls de développement, qui sont en principe
|
||||
accessibles par clé ssh et en lecture/écriture
|
||||
--no-fetch
|
||||
Ne rien récupérer. Utile avec --update-repolist
|
||||
-N, --no-host
|
||||
-A, --all-hosts
|
||||
-H, -h, --host HOST
|
||||
-T, --this-host
|
||||
Options permettant de spécifier l'hôte pour la récupération de dépôts
|
||||
spécifiques.
|
||||
--no-host demande explicitement à ce qu'aucun hôte ne soit spécifié
|
||||
--all-hosts sélectionne tous les dépôts spécifiques
|
||||
--host récupère uniquement les dépôts pour l'hôte spécifié
|
||||
--this-host équivaut à --host sulfure
|
||||
L'option par défaut est --this-host en mode production et --all-hosts en
|
||||
mode développement
|
||||
--update-repolist
|
||||
Forcer la mise à jour de la liste des dépôts. En principe, cette mise à
|
||||
jour n'est pas faite plus d'une fois par période de 24 heures.
|
||||
-0, --offline
|
||||
-n, --no-pull
|
||||
-u, --pull
|
||||
Spécifier le mode opératoire pour la récupération des dépôts.
|
||||
En mode --offline, ni clone ni pull ne sont autorisés. Le module doit
|
||||
avoir déjà été cloné.
|
||||
En mode --no-pull, seul le clonage est autorisé, e.g. le dépôt est
|
||||
cloné si ce n'est pas déjà le cas.
|
||||
En mode --pull, cloner le dépôt si ce n'est pas déjà le cas, ou le
|
||||
mettre à jour le dépôt avant de l'utiliser s'il avait déjà été cloné.
|
||||
Par défaut, utiliser --pull en mode production et --no-pull en mode
|
||||
développement.
|
||||
-i, --identity IDENTITY_FILE
|
||||
Spécifier le fichier depuis lequel lire la clé privée pour les
|
||||
connexions par ssh.
|
||||
-o, --output OUTPUT
|
||||
Spécifier un fichier dans lequel écrire des définitions de variables,
|
||||
notamment REPODIRS qui reçoit la liste des chemins des dépôts qui ont
|
||||
été récupérés. De plus, les variables RUNSSCRIPTSPATH, RUNSMODULESPATH
|
||||
et RUNSHOSTSPATH sont définies.
|
||||
-a, --append-output
|
||||
Ajouter au fichier OUTPUT au lieu de l'écraser
|
||||
}}}
|
||||
|
|
@ -1,38 +0,0 @@
|
|||
# -*- coding: utf-8 mode: markdown -*- vim:sw=4:sts=4:et:ai:si:sta:fenc=utf-8
|
||||
##@creator: jclain
|
||||
##@created: 15/03/2012 22:20
|
||||
##@modifier: jclain
|
||||
##@changecount: 1
|
||||
##@tags:
|
||||
##@title: rwoinst
|
||||
|
||||
{{{
|
||||
rwoinst: Déploiement distant avec woinst
|
||||
|
||||
USAGE
|
||||
rwoinst [-H host] [-T tmproot] <file|archive|dir>... [-- options de woinst]
|
||||
|
||||
OPTIONS
|
||||
-C Ne pas faire le déploiement. Configurer uniquement la connexion par clé
|
||||
sur les hôtes distants spécifiés pour le user spécifié. Il faut pouvoir
|
||||
se connecter par mot de passe pour configurer la connexion par clé.
|
||||
Si l'on veut configurer la connexion par clé pour le user root, mais que
|
||||
ce n'est pas possible de se connecter par mot de passe avec le user root
|
||||
sur l'hôte distant, et qu'il existe un user sudoer sur l'hôte distant,
|
||||
il est possible de faire la configuration avec '--configure root'. La
|
||||
commande serait alors
|
||||
rwoinst -H user@host --configure root
|
||||
-T tmproot
|
||||
Spécifier le répertoire temporaire sur l'hôte distant, comme par exemple
|
||||
/var/tmp. Cette option est utile pour les vservers, qui ont par défaut
|
||||
un /tmp minuscule de 16 Mo.
|
||||
-S ssh
|
||||
Spécifier le programme à utiliser pour la connection par ssh.
|
||||
-H host
|
||||
Spécifier un hôte distant sur lequel faire le déploiement. Plusieurs
|
||||
options -H peuvent être spécifiées, ou alors on peut séparer plusieurs
|
||||
hôtes par ':', e.g. -H host1:host2
|
||||
Par défaut, la connexion sur l'hôte distant se fait avec l'utilisateur
|
||||
root. Il est possible de spécifier un autre utilisateur avec la syntaxe
|
||||
user@host, e.g -H user@host
|
||||
}}}
|
||||
|
|
@ -1,98 +0,0 @@
|
|||
# -*- coding: utf-8 mode: markdown -*- vim:sw=4:sts=4:et:ai:si:sta:fenc=utf-8
|
||||
##@creator: jclain
|
||||
##@created: 27/04/2016 03:19
|
||||
##@modifier: jclain
|
||||
##@changecount: 1
|
||||
##@tags:
|
||||
##@title: sqlcsv
|
||||
|
||||
{{{
|
||||
USAGE:
|
||||
sqlcsv [query]
|
||||
|
||||
query est la requête SQL à exécuter. Si query n'est pas spécifiée ou si elle
|
||||
vaut '-', la requête SQL est lue sur l'entrée standard, ou depuis un
|
||||
fichier si l'option -f est spécifiée.
|
||||
|
||||
DEMARRAGE
|
||||
|
||||
Au démarrage, les répertoires de configuration (utilisateur ~/.sqlcsv et système
|
||||
/etc/sqlcsv) sont analysés. Les fichiers *.jar situés dans ces répertoires sont
|
||||
ajoutés au CLASSPATH. La présence de certains fichiers est testée pour activer
|
||||
éventuellement les logs détaillés.
|
||||
|
||||
OPTIONS
|
||||
-C, --config CONFIG
|
||||
Prendre les informations de connexion depuis le fichier de propriété
|
||||
spécifié. Pour l'identifiant CONN, la propriété 'CONN.url' doit exister
|
||||
dans ce fichier avec la valeur de l'url jdbc de connexion. De plus, les
|
||||
propriétés 'CONN.user' et 'CONN.password' contiennent respectivement si
|
||||
nécessaire le nom et le mot de passe de connexion. La propriété
|
||||
'loglevel', si elle existe, est utilisée pour configurer le niveau
|
||||
d'affichage des logs, comme avec l'option --loglevel
|
||||
Si cette option n'est pas spécifiée, un fichier nommé sqlcsv.properties
|
||||
est recherché dans l'ordre: dans le répertoire courant, dans le
|
||||
répertoire de configuration utilisateur, puis dans le répertoire de
|
||||
configuration système. Si le fichier est trouvé, il est chargé
|
||||
automatiquement.
|
||||
-l, --conn CONN
|
||||
Spécifier l'identifiant (ou l'url) de connexion. Cette information est
|
||||
obligatoire. Si cette option n'est pas fournie, il faut spécifier un
|
||||
fichier de configuration avec l'option -C dans lequel *une seule*
|
||||
propriété 'CONN.url' est définie.
|
||||
-u, --user USER
|
||||
-p, --password PASSWORD
|
||||
Spécifier un nom de connexion et un mot de passe si l'url ne le fournit
|
||||
pas. Ces valeurs ont la priorité sur les valeurs éventuellement déjà
|
||||
présentes dans le fichier de propriété.
|
||||
-f, --input INPUT
|
||||
Lire la requête depuis le fichier INPUT au lieu de la lire depuis la
|
||||
ligne de commande ou l'entrée standard. Ne pas spécifier cette option ou
|
||||
utiliser '-' pour lire depuis l'entrée standard. Cette option est
|
||||
ignorée si la requête est fournie sur la ligne de commande.
|
||||
-o, --output OUTPUT
|
||||
Ecrire le résultat dans le fichier OUTPUT. Utiliser '-' pour spécifier
|
||||
la sortie standard (c'est la valeur par défaut). S'il y a plusieurs
|
||||
requêtes et que le fichier de sortie n'est pas la sortie standard,
|
||||
ajouter un numéro incrémental au nom du fichier en sortie pour chaque
|
||||
requête. Sinon, il est possible de spécifier plusieurs fois cette option
|
||||
pour nommer les fichiers correspondant à chaque requête.
|
||||
-t, --autocommit
|
||||
Activer le mode autocommit
|
||||
-c, --ignore-io-error
|
||||
Continuer le traitement même en cas d'erreur du système de fichiers.
|
||||
Cependant le traitement s'arrête et la transaction est annulée si une
|
||||
autre erreur se produit.
|
||||
-y, --ignore-any-error
|
||||
Continuer le traitement même en cas d'erreur quelconque.
|
||||
-n, --no-headers
|
||||
Ne JAMAIS inclure les en-têtes dans la sortie, même avec l'option -h
|
||||
-a, --append
|
||||
Ajouter le résultat au fichier OUTPUT au lieu de l'écraser.
|
||||
-A, --auto-na
|
||||
Activer les option -n -a si le fichier OUTPUT existe et qu'il est non
|
||||
vide. Le test n'est effectué que pour le premier fichier spécifié.
|
||||
-s, --same-output
|
||||
Utiliser le même fichier pour écrire le résultat de toutes les requêtes.
|
||||
Normalement, un numéro incrémental est ajouté au fichier en sortie si
|
||||
plusieurs requêtes sont spécifiées. Si les en-têtes sont les mêmes,
|
||||
ajouter le résultat au fichier directement à la suite. Sinon, sauter une
|
||||
ligne blanche et afficher les nouveaux en-têtes.
|
||||
-h, --force-headers
|
||||
En cas d'écriture du résultat de plusieurs requêtes dans un même
|
||||
fichier, ne pas tenter de concaténer les résultats même si les en-têtes
|
||||
sont les mêmes.
|
||||
--uc-output
|
||||
Ajouter dans la sortie les résultat de toutes les requêtes, pas
|
||||
seulement celles de type DQML
|
||||
--loglevel LOGLEVEL
|
||||
Spécifier le niveau de logs à afficher. Les valeurs valides sont à
|
||||
choisir parmi ALL, FINEST, FINER, FINE, CONFIG, INFO, WARNING, ERROR
|
||||
La présence de certains fichiers dans les répertoires de configuration
|
||||
utilisateur ou système configure les logs avant que les options de la
|
||||
ligne de commande ne soient analysés: un fichier DEBUG fait démarrer
|
||||
l'application avec le niveau de log ALL ce qui permet de voir les logs
|
||||
concernant le chargement des jar. Un fichier SQL_DEBUG permet d'activer
|
||||
la trace de DriverManager. Exemple:
|
||||
mkdir -p ~/.sqlcsv && touch ~/.sqlcsv/{DEBUG,SQL_DEBUG}
|
||||
}}}
|
||||
|
|
@ -0,0 +1,28 @@
|
|||
# chrono.py
|
||||
|
||||
~~~
|
||||
usage: chrono.py [options] [TIMEOUT]
|
||||
|
||||
Afficher un chronomètre
|
||||
|
||||
positional arguments:
|
||||
TIMEOUT (valeur vide)
|
||||
chronomètre qui démarre à 0:00 et ne s'arrête pas
|
||||
H:M:S (heures:minutes:secondes)
|
||||
ou M:S (minutes:secondes)
|
||||
ou M (minutes)
|
||||
minuteur qui démarre à H:M:S et fait un décompte jusqu'à 0:00. A la fin
|
||||
du décompte, une sonnerie retentit.
|
||||
@H[:M[:S]]
|
||||
minuteur qui fonctionne comme précédemment, sauf qu'on spécifie l'heure
|
||||
d'arrivée, et que la durée est calculée automatiquement
|
||||
|
||||
optional arguments:
|
||||
-h, --help show this help message and exit
|
||||
-n, --no-autostart Ne pas démarrer automatiquement le décompte même si TIMEOUT est spécifié.
|
||||
-s, --autostart Forcer le démarrage automatique du décompte, même si TIMEOUT n'est pas spécifié.
|
||||
|
||||
Si TIMEOUT est spécifié, par défaut le décompte démarre automatiquement.
|
||||
~~~
|
||||
|
||||
-*- coding: utf-8 mode: markdown -*- vim:sw=4:sts=4:et:ai:si:sta:fenc=utf-8:noeol:binary
|
||||
|
|
@ -13,6 +13,7 @@ read the main documentation for these command-line arguments.
|
|||
Initialization options:
|
||||
|
||||
--batch do not do interactive display; implies -q
|
||||
--chdir DIR change to directory DIR
|
||||
--daemon start a server in the background
|
||||
--debug-init enable Emacs Lisp debugger for init file
|
||||
--display, -d DISPLAY use X server DISPLAY
|
||||
|
|
@ -20,9 +21,11 @@ Initialization options:
|
|||
--no-init-file, -q load neither ~/.emacs nor default.el
|
||||
--no-shared-memory, -nl do not use shared memory
|
||||
--no-site-file do not load site-start.el
|
||||
--no-site-lisp, -nsl do not add site-lisp directories to load-path
|
||||
--no-splash do not display a splash screen on startup
|
||||
--no-window-system, -nw do not communicate with X, ignoring $DISPLAY
|
||||
--quick, -Q equivalent to -q --no-site-file --no-splash
|
||||
--quick, -Q equivalent to:
|
||||
-q --no-site-file --no-site-lisp --no-splash
|
||||
--script FILE run FILE as an Emacs Lisp script
|
||||
--terminal, -t DEVICE use DEVICE for terminal I/O
|
||||
--user, -u USER load ~USER/.emacs instead of your own
|
||||
|
|
@ -32,7 +35,7 @@ Action options:
|
|||
FILE visit FILE using find-file
|
||||
+LINE go to line LINE in next FILE
|
||||
+LINE:COLUMN go to line LINE, column COLUMN, in next FILE
|
||||
--directory, -L DIR add DIR to variable load-path
|
||||
--directory, -L DIR prepend DIR to load-path (with :DIR, append DIR)
|
||||
--eval EXPR evaluate Emacs Lisp expression EXPR
|
||||
--execute EXPR evaluate Emacs Lisp expression EXPR
|
||||
--file FILE visit FILE using find-file
|
||||
|
|
@ -51,14 +54,14 @@ Display options:
|
|||
--border-color, -bd COLOR main border color
|
||||
--border-width, -bw WIDTH width of main border
|
||||
--color, --color=MODE override color mode for character terminals;
|
||||
MODE defaults to `auto', and can also
|
||||
be `never', `auto', `always',
|
||||
MODE defaults to `auto', and
|
||||
can also be `never', `always',
|
||||
or a mode name like `ansi8'
|
||||
--cursor-color, -cr COLOR color of the Emacs cursor indicating point
|
||||
--font, -fn FONT default font; must be fixed-width
|
||||
--foreground-color, -fg COLOR window foreground color
|
||||
--fullheight, -fh make the first frame high as the screen
|
||||
--fullscreen, -fs make first frame fullscreen
|
||||
--fullscreen, -fs make the first frame fullscreen
|
||||
--fullwidth, -fw make the first frame wide as the screen
|
||||
--maximized, -mm make the first frame maximized
|
||||
--geometry, -g GEOMETRY window geometry
|
||||
|
|
@ -82,7 +85,7 @@ example, -batch as well as --batch. You can use any unambiguous
|
|||
abbreviation for a --option.
|
||||
|
||||
Various environment variables and window system resources also affect
|
||||
Emacs' operation. See the main documentation.
|
||||
the operation of Emacs. See the main documentation.
|
||||
|
||||
Report bugs to bug-gnu-emacs@gnu.org. First, please see the Bugs
|
||||
section of the Emacs manual or the file BUGS.
|
||||
|
|
@ -0,0 +1,69 @@
|
|||
# fndate
|
||||
|
||||
~~~
|
||||
fndate: manipuler des noms de fichier pour les dater
|
||||
|
||||
USAGE
|
||||
fndate (FILE|DIR)s...
|
||||
fndate -k SRCs... [DESTDIR]
|
||||
fndate -m SRCs... [DESTDIR]
|
||||
fndate -c COMMAND [ARGs...]
|
||||
|
||||
OPTIONS
|
||||
--create-or-rename
|
||||
Créer un nouveau fichier (option -f) ou créer un nouveau répertoire
|
||||
(option -d), ou renommer un fichier existant sans le changer de
|
||||
répertoire. C'est l'option par défaut.
|
||||
-f, --create-file
|
||||
Créer un nouveau fichier. Cette option est ignorée si le fichier ou le
|
||||
répertoire spécifié existe. C'est la valeur par défaut
|
||||
-d, --create-dir
|
||||
Créer un nouveau répertoire. Cette option est ignorée si le fichier ou
|
||||
le répertoire spécifié existe.
|
||||
-k, --copy
|
||||
Copier le fichier SRC vers la destination DESTDIR qui vaut par défaut le
|
||||
répertoire courant si un seul fichier source est spécifié. Si plusieurs
|
||||
fichiers sources sont spécifiés, il faut absolument spécifier un
|
||||
répertoire destination. Dans la destination, les fichiers sont nommés
|
||||
avec la date en préfixe.
|
||||
-m, --move
|
||||
Déplacer le fichier SRC vers la destination DESTDIR qui vaut par défaut
|
||||
le répertoire courant si un seul fichier source est spécifié. Si
|
||||
plusieurs fichiers sources sont spécifiés, il faut absolument spécifier
|
||||
un répertoire destination. Dans la destination, les fichiers sont nommés
|
||||
avec la date en préfixe.
|
||||
-c, --cmd
|
||||
Les arguments sont une commande à lancer. Dans les argument, PLACEHOLDER
|
||||
est remplacé par la date. Si le PLACEHOLDER n'est trouvé dans aucun des
|
||||
arguments, alors ajouter la date à la fin de la commande. Par exemple,
|
||||
voici comment émuler l'option -k
|
||||
fndate -c cp src dest/~~
|
||||
--string
|
||||
Remplacer dans chaque argument le placeholder par la date et afficher le
|
||||
résultat.
|
||||
-P, --placeholder PLACEHOLDER
|
||||
Dans le nom spécifié, remplacer PLACEHOLDER par la date. Par défaut,
|
||||
PLACEHOLDER vaut ~~. Si le nom spécifié ne contient pas le PLACEHOLDER,
|
||||
il est placé au début.
|
||||
-@, --force-date DATE
|
||||
Dans le nom spécifié, si la date est déjà présente, forcer son
|
||||
remplacement par la valeur spécifiée. Par défaut, le fichier n'est pas
|
||||
modifié si la date est déjà présente.
|
||||
-F, --format FORMAT
|
||||
Spécifier le format de la date à insérer dans le nom du fichier. Par
|
||||
défaut, FORMAT vaut 'YYMMDD-'
|
||||
Les formats valides sont:
|
||||
YYYY année sur 4 chiffres
|
||||
YY année sur 2 chiffres
|
||||
MM mois sur 2 chiffres
|
||||
DD jour sur 2 chiffres
|
||||
Tous les autres caractères sont pris tels-quels
|
||||
-s, --short
|
||||
Equivalent à -F YYMMDD --autof
|
||||
-l, --long
|
||||
Equivalent à -F YYYMMDD --autof
|
||||
--autof
|
||||
Option non (pas encore) documentée
|
||||
~~~
|
||||
|
||||
-*- coding: utf-8 mode: markdown -*- vim:sw=4:sts=4:et:ai:si:sta:fenc=utf-8:noeol:binary
|
||||
|
|
@ -0,0 +1,67 @@
|
|||
# foreach
|
||||
|
||||
~~~
|
||||
foreach: lancer une commande pour un ensemble d'arguments
|
||||
|
||||
USAGE
|
||||
foreach [options] [VAR=]expr cmd...
|
||||
|
||||
La commande est lancée avec la variable 'VAR', qui vaut par défaut 'item',
|
||||
définie à la valeur courante de l'énumération. De plus, la variable 'index'
|
||||
reçoit une valeur incrémentale commençant à 0.
|
||||
|
||||
En plus de VAR, les variables file, dir, name, basename, ext et dotext sont
|
||||
définies. Elle valent respectivement le chemin absolu du fichier, le répertoire
|
||||
absolu du fichier, le nom du fichier, le nom de base sans extension, l'extension
|
||||
sans le point et l'extension avec le point, e.g pour item=dir/file.ext on a
|
||||
file=/path/to/dir/file.ext, dir=/path/to/dir, name=file.ext, basename=file,
|
||||
ext=ext, dotext=.ext
|
||||
|
||||
Exemple:
|
||||
foreach '*.c' cp %item dest/dir
|
||||
Equivalent à:
|
||||
foreach item='*.c' cp %item dest/dir
|
||||
|
||||
OPTIONS
|
||||
-b, --basedir BASEDIR
|
||||
Chercher les expressions -d, -f, -a à partir de BASEDIR au lieu du
|
||||
répertoire courant.
|
||||
-d, --dir
|
||||
Faire la correspondance de l'expression sur les répertoires uniquement
|
||||
-f, --file
|
||||
Faire la correspondance de l'expression sur les fichier uniquement
|
||||
-a, --all
|
||||
Faire la correspondance de l'expression sur les répertoires et les
|
||||
fichiers
|
||||
-p, --parent
|
||||
Pour chaque fichier/répertoire, se placer dans le répertoire parent
|
||||
avant de lancer la commande. item est aussi modifié pour ne plus
|
||||
contenir que le nom de la cible (qui est désormais dans le répertoire
|
||||
courant)
|
||||
Cette option a la priorité sur --go
|
||||
-g, --go
|
||||
Si la cible est un répertoire, en faire le répertoire courant avant de
|
||||
lancer la commande. Si la cible est un fichier, faire comme --parent et
|
||||
se placer dans le répertoire du fichier avant de lancer la commande.
|
||||
Dans les deux cas, item est modifié pour ne plus contenir que le nom de
|
||||
la cible, soit '.' pour le répertoire courant, soit le nom du fichier
|
||||
dans le répertoire courant.
|
||||
Si cette option est mentionnée seule, elle implique --dir
|
||||
-s, --string
|
||||
Evaluer l'expression avec la fonction 'eval' du shell.
|
||||
-x, --expand
|
||||
-n, --no-expand
|
||||
Reconnaitre et traiter (resp. ne pas reconnaitre) la syntaxe %var dans
|
||||
les arguments. C'est le cas par défaut, ce qui permet de simplifier
|
||||
l'écriture d'une ligne de commande. Pour écrire le caractère '%', il
|
||||
suffit de le double e.g %%item
|
||||
Si l'expansion est désactivée, il faut protéger le caractère $ pour
|
||||
qu'il soit traité, e.g, avec les examples ci-dessus:
|
||||
foreach -n '*.c' 'cp "$item" dest/dir'
|
||||
-t, --title
|
||||
--no-title
|
||||
Afficher (resp. ne pas afficher) chaque correspondance avant de lancer
|
||||
la commande. Par défaut, l'affichage est effectué.
|
||||
~~~
|
||||
|
||||
-*- coding: utf-8 mode: markdown -*- vim:sw=4:sts=4:et:ai:si:sta:fenc=utf-8:noeol:binary
|
||||
|
|
@ -67,15 +67,15 @@ OPTIONS
|
|||
fichier VERSION.txt avec pver. Utiliser cette option si la mise à jour
|
||||
du numéro de version doit être faite d'une manière particulière.
|
||||
-e, --edit
|
||||
Editer le fichier CHANGES.txt autogénéré par -u -w
|
||||
Cette option est surtout utile si -m est utilisé avec -u, pour donner la
|
||||
possibilité de corriger la liste des modifications avant leur
|
||||
enregistrement définitif.
|
||||
Editer le fichier CHANGES.md autogénéré par les options -u -w ou un
|
||||
fichier CHANGES.txt existant. Cette option est surtout utile si -m est
|
||||
utilisé avec -u, pour donner la possibilité de corriger la liste des
|
||||
modifications avant leur enregistrement définitif.
|
||||
|
||||
-m, --merge
|
||||
Si la branche actuelle est une branche de release, ou s'il existe une
|
||||
branche de release, la merger dans master, puis dans develop, puis la
|
||||
supprimer. Puis basculer sur la branche master.
|
||||
supprimer. A l'issu de cette opération, rester sur la branche develop.
|
||||
S'il n'existe pas de branche de release, proposer de fusionner les
|
||||
modifications de la branche develop dans la branche master, sans
|
||||
préparer de branche de release au préalable.
|
||||
|
|
@ -89,13 +89,17 @@ OPTIONS
|
|||
-s, --summary
|
||||
Afficher la liste des différences entre la branche develop et la branche
|
||||
master, comme elle serait générée par les options -u -w pour le fichier
|
||||
CHANGES.txt
|
||||
CHANGES.txt (la syntaxe pour CHANGES.md est légèrement différente)
|
||||
-l, --log
|
||||
Afficher les modifications actuellement effectuée dans la branche de
|
||||
release par rapport à develop.
|
||||
-d, --diff
|
||||
Afficher les modifications actuellement effectuée dans la branche de
|
||||
release par rapport à develop, sous forme de diff.
|
||||
|
||||
OPTIONS AVANCEES
|
||||
--uc, --upgrade-changes
|
||||
Convertir un fichier CHANGES.txt en CHANGES.md
|
||||
~~~
|
||||
|
||||
-*- coding: utf-8 mode: markdown -*- vim:sw=4:sts=4:et:ai:si:sta:fenc=utf-8:noeol:binary
|
||||
|
|
@ -0,0 +1,201 @@
|
|||
# pver
|
||||
|
||||
~~~
|
||||
pver: gérer des numéros de version selon les règles du versionage sémantique v2.0.0 (http://semver.org/)
|
||||
|
||||
USAGE
|
||||
pver [options]
|
||||
|
||||
OPTIONS
|
||||
-w, --auto-file DIR
|
||||
Gérer le numéro de version du répertoire spécifié. Si un fichier pom.xml
|
||||
existe dans ce répertoire, alors c'est l'option '-e DIR/pom.xml' qui est
|
||||
activé. Si un fichier VERSION.txt existe dans ce répertoire, alors c'est
|
||||
l'option '-f DIR/VERSION.txt' qui est activée. Sinon, un nouveau fichier
|
||||
VERSION.txt est créé dans ce répertoire. C'est l'option par défaut.
|
||||
--sw, --auto-string DIR
|
||||
Prendre pour valeur de départ la version du répertoire spécifié. Si un
|
||||
fichier pom.xml existe dans ce répertoire, alors c'est l'option -E qui
|
||||
est activé. Si un fichier VERSION.txt existe dans ce répertoire, alors
|
||||
c'est l'option -F qui est activée.
|
||||
--gw, --auto-git-string [BRANCH:]DIR
|
||||
Prendre pour valeur de départ la version du répertoire spécifié dans la
|
||||
branche BRANCH (qui vaut par défaut master) du dépôt git. Si un fichier
|
||||
pom.xml existe dans ce répertoire, alors c'est l'option -g qui est
|
||||
activé. Si un fichier VERSION.txt existe dans ce répertoire, alors c'est
|
||||
l'option -G qui est activée.
|
||||
-e, --pom POMFILE
|
||||
Gérer le numéro de version se trouvant dans le fichier pom.xml spécifié.
|
||||
Le fichier DOIT exister. Implique --maven-update
|
||||
-E, --pom-string POMFILE
|
||||
Prendre pour valeur de départ la version contenue dans le fichier
|
||||
pom.xml spécifié. Le fichier DOIT exister. Implique --maven-update
|
||||
-f, --file VERSIONFILE
|
||||
Gérer le numéro de version se trouvant dans le fichier spécifié. Le
|
||||
fichier est créé si nécessaire.
|
||||
-F, --file-string VERSIONFILE
|
||||
Prendre pour valeur de départ le contenu du fichier VERSIONFILE.
|
||||
-g, --git-file-string [BRANCH:]VERSIONFILE
|
||||
Prendre pour valeur de départ le contenu du fichier VERSIONFILE (qui
|
||||
vaut par défaut VERSION.txt) dans la branche BRANCH (qui vaut par défaut
|
||||
master) du dépôt git. Retourner 2 si on n'est pas situé dans un dépôt
|
||||
git.
|
||||
-G, --git-pom-string [BRANCH:]POMFILE
|
||||
Prendre pour valeur de départ la version du fichier POMFILE (qui vaut
|
||||
par défaut pom.xml) dans la branche BRANCH (qui vaut par défaut master)
|
||||
du dépôt git. Retourner 2 si on n'est pas situé dans un dépôt git.
|
||||
--git-prel-string
|
||||
Prendre pour valeur de départ le numéro de version correspondant à la
|
||||
branche de release courante. Retourner 1 si la branche courante n'est
|
||||
pas une branche de release, 2 si on n'est pas situé dans un dépôt git.
|
||||
-s, --string VERSION
|
||||
Prendre pour valeur de départ le numéro de version spécifié
|
||||
|
||||
--show
|
||||
Afficher le numéro de version. C'est l'action par défaut
|
||||
--check
|
||||
Vérifier que le numéro de version est conforme aux règles du versionage
|
||||
sémantique
|
||||
--eq VERSION
|
||||
--ne VERSION
|
||||
--lt VERSION
|
||||
--le VERSION
|
||||
--gt VERSION
|
||||
--ge VERSION
|
||||
--same VERSION
|
||||
--diff VERSION
|
||||
Comparer avec la version spécifiée. Les opérateurs --eq, --ne, --lt,
|
||||
--le, --gt, et --ge ignorent l'identifiant de build (comme le demande la
|
||||
règle du versionage sémantique). Les opérateurs --same et --diff
|
||||
comparent aussi les identifiants de build.
|
||||
-u, --update
|
||||
Mettre à jour le numéro de version.
|
||||
|
||||
Les options suivantes impliquent --update:
|
||||
-v, --set-version VERSION
|
||||
Spécifier un nouveau numéro de version qui écrase la valeur actuelle.
|
||||
Cette option ne devrait pas être utilisée en temps normal parce que cela
|
||||
va contre les règles du versionage sémantique.
|
||||
--prel
|
||||
Spécifier un nouveau numéro de version qui écrase la valeur actuelle. Le
|
||||
numéro de version est obtenu à partir du nom de la branche git courante,
|
||||
qui doit être de la forme release-VERSION
|
||||
--menu
|
||||
Afficher un menu permettant de choisir le composant de la version à
|
||||
incrémenter.
|
||||
-x, --major
|
||||
Augmenter le numéro de version majeure.
|
||||
-z, --minor
|
||||
Augmenter le numéro de version mineure. C'est la valeur par défaut, sauf
|
||||
avec --maven-update où c'est l'option -p qui est sélectionnée par
|
||||
défaut.
|
||||
-p, --patchlevel
|
||||
Augmenter le numéro de patch.
|
||||
-k, --keep
|
||||
Ne pas augmenter le numéro de version. Cette option est surtout utile
|
||||
pour *convertir* un numéro de version existant et mettre à jour le
|
||||
fichier correspondant. Elle est assumée si aucune option -[xzp] n'est
|
||||
spécifiée et qu'une des options -[labrSRmM] est utilisée.
|
||||
|
||||
-l, --prelease ID
|
||||
Spécifier un identifiant de pré-release, à ajouter au numéro de version.
|
||||
-a, --alpha
|
||||
-b, --beta
|
||||
-r, --rc
|
||||
Spécifier une pré-release de type alpha, beta, ou rc. Si la version est
|
||||
déjà dans ce type, augmenter la dernière valeur numérique des composants
|
||||
de l'identifiant, e.g. alpha deviant alpha.1, beta-1.2 devient beta-1.3,
|
||||
rc1 devient rc2
|
||||
XXX ces fonctions ne sont pas encore implémentées
|
||||
-S, --snapshot
|
||||
Ajouter l'identifiant SNAPSHOT, utilisé par Maven
|
||||
-R, --final, --release
|
||||
Supprimer l'identifiant de prérelease, utilisé par Maven
|
||||
|
||||
-m, --metadata ID
|
||||
Spécifier un identifiant de build, à ajouter au numéro de version.
|
||||
-M, --vcs-metadata
|
||||
Calculer l'identifiant de build à partir de la révision actuelle dans le
|
||||
gestionnaire de version. Note: pour le moment, seul git est supporté.
|
||||
--add-metadata ID
|
||||
Ajouter l'identifiant spécifié à la valeur actuelle, au lieu de la
|
||||
remplacer. Séparer l'identifiant de la valeur précédente avec un '.'
|
||||
|
||||
OPTIONS AVANCEES
|
||||
--show-source
|
||||
Afficher le type de source qui sera traité, i.e. pom, file, pom-string,
|
||||
file-string, git-pom-string, git-file-string
|
||||
--vpath VPATH
|
||||
Pour les options -e et -E, spécifier le chemin XPATH du tag qui contient
|
||||
le numéro de version.
|
||||
--map MAPFILE
|
||||
Cette option permet de spécifier un fichier de règles qui indique les
|
||||
fichiers pom.xml et VERSION.txt qui doivent être mis à jour dans un
|
||||
projet multi-modules pour lequel les versions doivent être mises à jour
|
||||
en même temps.
|
||||
Par défaut, si un fichier nommé .pver-map existe dans le répertoire de
|
||||
{POM,VERSION}FILE, cette option est automatiquement activée. Ainsi, on
|
||||
n'aura besoin d'utiliser cette option que si l'on désire charger un
|
||||
fichier alternatif ou ignorer le fichier par défaut.
|
||||
Si une valeur vide est fournie, seul le fichier {POM,VERSION}FILE est
|
||||
traité. Sinon, {POM,VERSION}FILE est utilisé uniquement pour chercher le
|
||||
fichier .pver-map et seuls les fichiers mentionnés dans MAPFILE sont
|
||||
traités.
|
||||
Le fichier MAPFILE est constitué d'un ensemble de lignes de la forme
|
||||
FILESPEC:VPATH
|
||||
FILESPEC est requis et prend la forme d'une spécification de chemin
|
||||
relatif au répertoire de MAPFILE et identifiant un ensemble de fichiers
|
||||
de version. Si FILESPEC contient des wildcards, alors les fichiers
|
||||
identifiés par ce chemin sont ignorés s'ils ont déjà été traités par une
|
||||
règle précédente. Si FILESPEC ne contient pas de wildcards, alors le
|
||||
fichier est systématiquement traité.
|
||||
VPATH désigne le chemin XPATH vers le numéro de version qu'il faut
|
||||
mettre à jour dans les fichiers pom.xml. Certaines valeurs spéciales
|
||||
pour VPATH sont supportées:
|
||||
(vide) le chemin par défaut est utilisé pour ce fichier, c'est à
|
||||
dire /project/version ou /project/parent/version en fonction
|
||||
du contenu du fichier
|
||||
- le fichier pom.xml n'est pas modifié (il est ignoré)
|
||||
D alias pour le chemin XPATH /project/version
|
||||
P alias pour le chemin XPATH /project/parent/version
|
||||
Pour les fichiers VERSION.txt, VPATH doit être vide
|
||||
Le fichier de version correspondant au premier fichier de la première
|
||||
ligne de MAPFILE contient la version de référence, qui est dupliquée
|
||||
dans tous les autres fichiers.
|
||||
--allow-empty
|
||||
Supporter que la version puisse ne pas être spécifiée ni trouvée. Sans
|
||||
cette option, on assume que la version effective est 0.0.0 si elle n'est
|
||||
pas spécifiée ni trouvée.
|
||||
Avec --show et --update, ne rien afficher si la version est vide.
|
||||
--convert
|
||||
--no-convert
|
||||
Activer (resp. désactiver) la conversion automatique. Par défaut, si la
|
||||
version est au format classique 'x.z[.p]-rDD/MM/YYYY', elle est
|
||||
convertie automatiquement au format sémantique x.z.p+rYYYYMMDD
|
||||
-t, --maven-update
|
||||
Mettre à jour le numéro de version selons les règles de Maven. Cette
|
||||
option est automatiquement activée si -e est sélectionné. Elle n'est
|
||||
prise en compte qu'avec l'option -u
|
||||
Si les options -R et -S ne sont pas spécifiée, alors une release est
|
||||
transformée en snapshot et une snapshot en release. Avec -R, une
|
||||
snapshot est transformée en release, et une release est traitée /
|
||||
incrémentée normalement. Avec -S une release est transformée en
|
||||
snapshot, et un snapshot est traité / incrémentée normalement.
|
||||
Si l'une des options -x, -z, -p est utilisée, alors la partie spécifiée
|
||||
est incrémentée selon les règles suivantes. Dans les exemples suivants,
|
||||
A est un nombre quelconque, B = A + 1, et x, y et z sont des nombres
|
||||
quelconques.
|
||||
Avec l'option -x:
|
||||
A.0.0-SNAPSHOT --> A.0.0
|
||||
A.x.y-SNAPSHOT --> B.0.0
|
||||
x.A.y --> x.B.0-SNAPSHOT
|
||||
Avec l'option -z:
|
||||
x.A.0-SNAPSHOT --> x.A.0
|
||||
x.A.y-SNAPSHOT --> x.B.0
|
||||
x.A.y --> x.B.0-SNAPSHOT
|
||||
Avec l'option -p, qui est celle sélectionnée par défaut:
|
||||
x.y.z-SNAPSHOT --> x.y.z
|
||||
x.y.A --> x.y.B-SNAPSHOT
|
||||
~~~
|
||||
|
||||
-*- coding: utf-8 mode: markdown -*- vim:sw=4:sts=4:et:ai:si:sta:fenc=utf-8:noeol:binary
|
||||
|
|
@ -40,7 +40,7 @@ Gestion des scripts
|
|||
{$RUNSHOSTSPATH}/$hostname.$domain (par défaut) et
|
||||
{$RUNSHOSTSPATH}/$domain/$hostname (le cas échéant)
|
||||
L'option --host est équivalente, sauf que son argument est facultatif et
|
||||
que sa valeur par défaut est l'hôte courant, soit sulfure
|
||||
que sa valeur par défaut est l'hôte courant, soit natrix
|
||||
--list
|
||||
Afficher la liste des scripts qui sont disponibles. Avec l'option -h,
|
||||
inclure aussi les scripts spécifiques à cet hôte.
|
||||
|
|
@ -11,6 +11,9 @@ sont spécifiés, les dépôts correspondants sont récupérés aussi. Avec l'op
|
|||
-h, des dépôts spécifiques à l'hôte peuvent éventuellement être récupérés en
|
||||
plus.
|
||||
|
||||
Il est possible de spécifier le module '*' pour récupérer tous les modules
|
||||
disponibles. C'est utile sur un poste de développement.
|
||||
|
||||
OPTIONS
|
||||
-c, --config CONFIG
|
||||
Spécifier un fichier de configuration à charger au lieu de la valeur par
|
||||
|
|
@ -33,12 +36,15 @@ OPTIONS
|
|||
--no-host demande explicitement à ce qu'aucun hôte ne soit spécifié
|
||||
--all-hosts sélectionne tous les dépôts spécifiques
|
||||
--host récupère uniquement les dépôts pour l'hôte spécifié
|
||||
--this-host équivaut à --host sulfure
|
||||
--this-host équivaut à --host natrix
|
||||
L'option par défaut est --this-host en mode production et --all-hosts en
|
||||
mode développement
|
||||
--update-repolist
|
||||
Forcer la mise à jour de la liste des dépôts. En principe, cette mise à
|
||||
jour n'est pas faite plus d'une fois par période de 24 heures.
|
||||
--shallow-clone
|
||||
Faire un clone avec une profondeur de 1. C'est la valeur par défaut pour
|
||||
le mode production.
|
||||
-0, --offline
|
||||
-n, --no-pull
|
||||
-u, --pull
|
||||
Some files were not shown because too many files have changed in this diff Show More
Loading…
Reference in New Issue