\documentclass{report}
\usepackage[utf8]{inputenc}
\usepackage[T1]{fontenc}
\usepackage{textcomp}
\usepackage{geometry}
\geometry{top=15mm, bottom=15mm, left=1cm, right=1cm}
\usepackage[french]{babel}
\usepackage{pslatex}
\usepackage[colorlinks=true,urlcolor=black]{hyperref}
\usepackage{graphicx}
\usepackage{fancyhdr}
\pagestyle{fancy}
\renewcommand{\footrulewidth}{0.4pt}
\fancyfoot[L]{Uubu.fr}
\fancyfoot[R]{ven. janv. 30 09:26:27 CET 2015}
\lfoot{\Large \textit{Uubu.fr}}
\hypersetup{pdfinfo={
Title={libvirt-pools},
Author={Sylvain Girod},
Creator={Bash script from uubu.fr's format version 1},
Producer={Bash script and PDFLaTeX},
Subject={Définitions des pools de stockage},
CreationDate={D:20150130092627},
ModDate={D:20150130092627},
Keywords={Virtualisation;storages}
}}
\begin{document}
 
\begin{center}
{\Huge libvirt-pools }
\end{center}
\vspace{1cm}
 
\begin{flushleft}
 
{\large Définitions des pools de stockage}
 
\vspace{10mm}
 
\begin{description} \normalsize
\item[\hspace{1mm} <pool type="iscsi">]{type peut être dir, fs, netfs, disk, iscsi, scsi, mpath, rbd, sheepdog, gluster, zfs ou logical.}
\end{description}
 
\begin{description} \normalsize
\item[\hspace{6mm} <name>myname</name]{fournis un nom pour le pool, qui doit être unique à l'hôte.}
\item[\hspace{6mm} <uuid> 3e3fce45-4f53-4fa7-bb32-11f34168b82b </uuid>]{Fournis un identifiant pour le pool, qui doit être globalement unique.}
\item[\hspace{6mm} <allocation> 10000000 </allocation>]{Fournis l'allocation du stockage total pour le pool, en octets. N'est pas applicable en créant un pool.}
\item[\hspace{6mm} <capacity> 50000000 </capacity>]{Fournis la capacité de stockage totale pour le pool, en octets. N'est pas applicable en créant un pool.}
\item[\hspace{6mm} <available> 40000000 </available>]{Fournis l'espace disponible pour allouer de nouveaux volumes, en octets. N'est pas applicable en créant un pool.}
\item[\hspace{6mm} <source>]{Utilisé pour décrire la source du pool de stockage}
\end{description}
 
\begin{description} \normalsize
\item[\hspace{12mm} <device path="demo-target"/>]{fournis la sources des pools stockés par des périphériques physiques ( fs, logical, disk, iscsi, zfs). Peut être répété plusieurs fois en fonction du pilote de backend. Contient un seul attribut \textbf{path} qui est le chemin vers le nœud du périphérique block.}
\item[\hspace{12mm} <dir path="/my/path"/>]{Fournis la source pour les pools de type dir.}
\item[\hspace{12mm} <adapter type='scsi\_host' name='scsi\_host1'/>]{Fournis la source pour les pools de type scsi:}
\end{description}
 
\begin{description} \normalsize
\item[\hspace{18mm} name]{Nom de l'adapter scsi}
\item[\hspace{18mm} type]{Spécifie le type d'adapter ( scsi\_host ou fc\_host ). Si omit et que name est spécifié, scsi\_host est utilisé.}
\item[\hspace{18mm} wwnn]{}
\item[\hspace{18mm} wwpn]{World Wide Node Name et World Wide Port Name sont utilisé par l'adapter fs\_host pour identifier de manière unique le périphérique.}
\item[\hspace{18mm} parent]{Utilisé avec le type fc\_host pour spécifier le périphérique scsi\_host parent.}
\item[\hspace{18mm} managed]{Attribut optionnel pour instruire le backend scsi de gérer la destruction du vHBA quand le pool est détruit. (yes ou no)}
\item[\hspace{18mm} <parentaddr>]{Utilisé par le type scsi\_host au lieu de l'attribut name pour identifier de manière unique l'hôte scsi:}
\end{description}
 
\begin{description} \normalsize
\item[\hspace{24mm} unique\_id]{Nécessite que parentaddr soit utilisé pour déterminer les adapters scsi\_host pour l'adresse PCI fournis.}
\item[\hspace{24mm} <address>]{Adresse PCI pour le périphérique scsi\_host à utiliser:}
\end{description}
 
\begin{description} \normalsize
\item[\hspace{30mm} domain]{Entier 2 octets héxa}
\item[\hspace{30mm} bus]{valeur entre 0 et 0xff}
\item[\hspace{30mm} slot]{valeur entre 0x0 et 0x1f}
\item[\hspace{30mm} function]{Valeur entre 0 et 7.}
\end{description}
 
\begin{description} \normalsize
\item[\hspace{18mm} </parentaddr>]{}
\end{description}
 
\begin{description} \normalsize
\item[\hspace{12mm} </adapter>]{}
\item[\hspace{12mm} <host>]{Fournis la source pour les pools stockés sur les stockages distant (netfs, iscsi, rbd, sheepdog, gluster). Utilisé en combinaison avec un élément directory ou device. Contient un attribut name qui est le nom d'hôte ou l'adresse IP du serveur port pour un numéro de port spécifique.}
\item[\hspace{12mm} <auth>]{Si présent, fournis les accréditifs nécessaires pour accéder à la source.}
\end{description}
 
\begin{description} \normalsize
\item[\hspace{18mm} type]{doit être "chap" pour iscsi ou "ceph" pour rbd.}
\item[\hspace{18mm} username]{spécifie le nom d'utilisateur pour l'authentification}
\item[\hspace{18mm} <secret>]{l'attribut type est mandatoire et attache un objet secret qui maintient les accréditifs, uuid contient l'uuid de l'objet secret et usage match la clé spécifiée dans l'objet secret.}
\end{description}
 
\begin{description} \normalsize
\item[\hspace{12mm} name]{Spécifie la source pour les pools nommés (logical, rbd, sheepdog, gluster).}
\item[\hspace{12mm} format]{Fournis des informations sur le format du pool (pour les pools fs, netfs, disk, logical). Contient un simple attribut type dont la valeur est spécifique au backend). Utilisé pour indiquer le type de système de fichier, de réseau, le type de table de partition, ou le type de meta-donnée LVM.}
\item[\hspace{12mm} vendor]{Fournis des informations sur le vendeur du périphérique de stockage. Contient un attribut name dont la valeur est spécifique au backend.}
\item[\hspace{12mm} product]{Fournis un nom de produit pour le périphérique de stockage. Contient un attribut name dont la valeur est spécifique au backend.}
\item[\hspace{12mm} <target>]{Utilisé pour décrire le mappage du pool de stockage ans le système de fichier hôte. Il peut contenir 5 éléments:}
\end{description}
 
\begin{description} \normalsize
\item[\hspace{18mm} path]{Fournis l'emplacement auquel le pool sera mappé dans l'espace de nom du système de fichier local.}
\item[\hspace{18mm} <permissions>]{Actuellement utile uniquement pour les pools dir et fs-based, qui sont mappés comme répertoire dans le système de fichier local. Il fournis des informations sur les permissions à utiliser pour le répertoire final quand le pool est construit.}
\end{description}
 
\begin{description} \normalsize
\item[\hspace{24mm} <owner> 107 </owner>]{Spécifie le propriétaire du répertoire final}
\item[\hspace{24mm} <group> 107 </group>]{Spécifie le groupe propriétaire du répertoire final}
\item[\hspace{24mm} <mode> 0744 </mode>]{Spécifie les permissions à définir sur le répertoire final}
\item[\hspace{24mm} <label> virt\_image\_t </label>]{Contient le label MAC pour selinux.}
\end{description}
 
\begin{description} \normalsize
\item[\hspace{18mm} </permission>]{}
\item[\hspace{18mm} <timestamps>]{Actuellement utile uniquement pour les pools dir et fs-based, qui sont mappés comme répertoire dans le système de fichier local.}
\end{description}
 
\begin{description} \normalsize
\item[\hspace{24mm} <atime> 1341933637.273190990 </atime>]{Date de dernier accès}
\item[\hspace{24mm} <mtime> 1341930622.047245868 </mtime>]{Date de dernière modification}
\item[\hspace{24mm} <ctime> 1341930622.047245868 </ctime>]{Date de création}
\end{description}
 
\begin{description} \normalsize
\item[\hspace{18mm} </timestamps>]{}
\item[\hspace{18mm} <encryption type='...'>]{Spécifie comment le volume est chiffré}
\end{description}
 
\begin{description} \normalsize
\item[\hspace{12mm} </target>]{}
\end{description}
 
\begin{description} \normalsize
\item[\hspace{6mm} </source>]{}
\end{description}
 
\begin{description} \normalsize
\item[\hspace{1mm} </pool>]{}
\end{description}
\end{flushleft}
\end{document}
