\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]{dim. janv. 18 22:19:33 CET 2015}
\lfoot{\Large \textit{Uubu.fr}}
\hypersetup{pdfinfo={
Title={nbd-server},
Author={Sylvain Girod},
Creator={Bash script from uubu.fr's format version 1},
Producer={Bash script and PDFLaTeX},
Subject={Dessert un fichier comme périphérique block à d'autre machine.},
CreationDate={D:20150118221933},
ModDate={D:20150118221933},
Keywords={FileSystems;storages;nbd}
}}
\begin{document}
 
\begin{center}
{\Huge nbd-server }
\end{center}
\vspace{1cm}
 
\begin{flushleft}
 
{\large Dessert un fichier comme périphérique block à d'autre machine.}
 
\vspace{10mm}
 
\vspace{1cm}{\huge Description }
 
\
 
\hspace{1mm}  Avec NBD, un client peut utiliser un fichier, exporté sur le réseaux depuis un serveur, comme périphérique block. NBD peut être utile pour les clients léger sans disques qui ont besoin d'espace swap, mais on peut également y créer un système de fichier et l'utiliser comme système de fichier local.
\vspace{5mm} \\
 
 
\hspace{1mm}  nbd-server implémente un peut de sécurité via un fichier appelé \textbf{/etc/nbd-server/allow}. Ce fichier doit lister les adresse IP ou les masques réseaux des client qui sont autorisés à se connecter. S'il n'existe pas, tous les clients sont capable de se connecter. Si le fichier est vide, aucun client ne peut se connecter.
\vspace{5mm} \\
 
 
\hspace{1mm}  Noter que bien que la ligne de commande permet de spécifier un export, l'utilisation de cette option est dépréciée. Il est préférable d'utiliser le fichier de configuration.
\vspace{5mm} \\
 
 
\hspace{1mm}  Bien que nbd-server fonctionne, les nouveaux exports peuvent être ajoutés en ré-écrivant le fichier de configuration puis en envoyant un SIGHUP au serveur, ce qui le force à relire sa configuration.
\vspace{5mm} \\
 
 
\vspace{1cm}{\huge OPTIONS }
 
\
 
\begin{description} \normalsize
\item[\hspace{1mm} ip]{L'addresse ip d'écoute du service. Peut être une IPv4 ou une IPv6 ou un nom d'hôte. Dans le dernier cas, nbd-serveur fait une recherche de nom et écoute sur la première adresse qui lui est retournée. Non spécifié, nbd-server écoute sur toutes les interfaces.}
\item[\hspace{1mm} port]{Le port d'écoute du service. Si 0 est spécifié, nbd-server va écouter sur stdin.}
\item[\hspace{1mm} filename]{Le nom du fichier qui devrait être exporté. Cela peut être tout fichier, incluant des périphériques block réel (ex: depuis /dev). Si le nom du fichier inclus la chaîne \textbf{\%s}, elle sera substituée avec l'adresse IP du client.}
\item[\hspace{1mm} size]{La taille du périphérique block côté client. Utile en conjonction avec l'option -m}
\item[\hspace{1mm} -r]{Export le fichier en lecture seule. Si un client tente d'y écrire, il recevra une erreur mais restera connecté.}
\item[\hspace{1mm} -m]{Travail avec plusieurs fichiers. Cela peut être utilisé pour exporter des périphériques block plus grand que la taille de fichier maximum permise dans le système de fichier. Pour utiliser cette options, il faut créer des fichiers avec les noms au format \textbf{name.X} où name est donné en argument filename, et X est un nombre commençant à 0.}
\item[\hspace{1mm} -c]{Copy on write. Les opérations d'écritures ne sont pas faite sur le fichier exporté, mais dans un fichier séparé. Ce fichier est supprimé quand la connexion est terminée. Cela ralentis le service.}
\item[\hspace{1mm} -C]{Spécifier le fichier de configuration. Défaut: \textbf{/etc/nbd-server/config}.}
\item[\hspace{1mm} -M]{Spécifie le nombre maximum de connexions ouverte. Non spécifié, aucune limite n'est définie.}
\item[\hspace{1mm} -d]{Ne fork pas.}
\item[\hspace{1mm} host list filename]{Cet argument devrait contenir un liste d'IP pour les hôtes qui peuvent se connecter au serveur. les wildcards ne sont pas permis. Si le fichier n'existe pas, il est ignoré ( et tous les hôte peuvent se connecter ); si le fichier existe, mais est vide, aucun hôte ne peut se connecter. Par défaut, le nom \textbf{nbd\_server.allow} est utilisé, et recherché dans le répertoire courant, sauf si nbd-server est compilé en service, auquel cas il le recherche dans "/".}
\item[\hspace{1mm} section name]{Si -o est donné, nbd-server affiche la section du fichier de configuration avec cet argument en en-tête qui est fonctionnellement équivalent à d'autres options spécifiés sur la ligne de commande, et quitte.}
\end{description}
 
\vspace{1cm}{\huge Exemples }
 
\
 
\hspace{1mm} Exporter un fichier /export/nbd/exp-bl-dev sur le port 2000: \\
\hspace{1mm} \textbf{nbd-server 2000 /export/nbd/exp-bl-dev} \\
\hspace{1mm} Exporter le même fichier en lecture seule: \\
\hspace{1mm} \textbf{nbd-server 2000 /export/nbd/exp-bl-dev -r} \\
\hspace{1mm} Exporter le même fichier en r/w, mais en s'assurant que les changements seront perdu au redémarrage: \\
\hspace{1mm} \textbf{nbd-server 2000 /export/nbd/exp-bl-dev -c} \\
\end{flushleft}
\end{document}
