\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. sept. 16 11:09:15 CEST 2016}
\lfoot{\Large \textit{Uubu.fr}}
\hypersetup{pdfinfo={
Title={cupsd-logs},
Author={Sylvain Girod},
Creator={Bash script from uubu.fr's format version 1},
Producer={Bash script and PDFLaTeX},
Subject={Fichiers de log pour cupsd (acces\_log, error\_log, page\_log)},
CreationDate={D:20160916110915},
ModDate={D:20160916110915},
Keywords={cups;printer}
}}
\begin{document}
 
\begin{center}
{\Huge cupsd-logs }
\end{center}
\vspace{1cm}
 
\begin{flushleft}
 
{\large Fichiers de log pour cupsd (acces\_log, error\_log, page\_log)}
 
\vspace{10mm}
 
\hspace{1mm} cupsd maintient normalement 3 fichiers de log: access\_log suit les requêtes envoyées au scheduler, error\_log suit les progressions et erreurs, et page\_log suit les pages imprimées. Les directives de configuration dans cupsd.conf et cups-files.conf contrôlent quelles informations sont loggées et où ils sont stockés
 
 
\vspace{1cm}{\huge Format de access\_log }
 
\
 
\hspace{1mm} access\_log liste chaque ressource HTTP accedée par un navigateur web ou un client. Chaque ligne est en version étendue du format "Common Log Format" utilisé par de nombreux serveurs Web:
 
{\ttfamily
host group user date-time "method resource version" status bytes\\ \hspace{2mm}ipp-operation ipp-status\\
}
\vspace{8mm}
 
\hspace{1mm} Par exemple:
 
{\ttfamily
10.0.1.2 - - \texttt{[}01/Dec/2005:21:50:28 +0000\texttt{]} "POST / HTTP/1.1" 200 317\\ \hspace{2mm}CUPS-Get-Printers successful-ok-ignored-or-substituted-attributes\\ localhost - - \texttt{[}01/Dec/2005:21:50:32 +0000\texttt{]} "GET /admin HTTP/1.1"\\ \hspace{2mm}200 0 - -\\ localhost - - \texttt{[}01/Dec/2005:21:50:32 +0000\texttt{]} "POST / HTTP/1.1"\\ \hspace{2mm}200 157 CUPS-Get-Printers\\ \hspace{2mm}successful-ok-ignored-or-substituted-attributes\\ localhost - - \texttt{[}01/Dec/2005:21:50:32 +0000\texttt{]} "POST / HTTP/1.1"\\ \hspace{2mm}200 1411 CUPS-Get-Devices -\\ localhost - - \texttt{[}01/Dec/2005:21:50:32 +0000\texttt{]} "GET /admin HTTP/1.1"\\ \hspace{2mm}200 6667 - -\\
}
\vspace{8mm}
 
\vspace{1cm}{\huge Champs }
 
\
 
\begin{description} \normalsize
\item[\hspace{1mm} host]{est normalement une adresse IP, sauf si HostNameLookups est activé.}
\item[\hspace{1mm} group]{Contient toujours -}
\item[\hspace{1mm} user]{Contient le username authentifié}
\item[\hspace{1mm} date-time]{date de la demande au format "[DD/MON/YYYY:HH:MM:SS +ZZZZ]"}
\item[\hspace{1mm} method]{Méthode HTTP utilisée}
\item[\hspace{1mm} resource]{Nom du fichier de la ressource demandée}
\item[\hspace{1mm} version]{Version de la spécification HTTP utilisée par le client}
\item[\hspace{1mm} status]{Résultat HTTP de la requêtes}
\end{description}
 
\begin{description} \normalsize
\item[\hspace{6mm} 200]{Opération réussie}
\item[\hspace{6mm} 201]{Fichier créé/modifié avec succès}
\item[\hspace{6mm} 304]{Le fichier demandé n'a pas changé}
\item[\hspace{6mm} 400]{mauvaise requête HTTP}
\item[\hspace{6mm} 401]{non autorisé, un authentification est requise}
\item[\hspace{6mm} 403]{Accès refusé}
\item[\hspace{6mm} 404]{Fichier ou ressource inexistante}
\item[\hspace{6mm} 405]{Méthode d'accès non permise}
\item[\hspace{6mm} 413]{Requête trop grande}
\item[\hspace{6mm} 426]{Upgrade vers une connexion TLS}
\item[\hspace{6mm} 500]{Erreur serveur}
\item[\hspace{6mm} 501]{Chiffrement demandé, mais non disponible}
\item[\hspace{6mm} 505]{Numéro de version HTTP non supporté}
\end{description}
 
\begin{description} \normalsize
\item[\hspace{1mm} bytes]{Contient le nombre d'octets dans le requête}
\item[\hspace{1mm} ipp-operation]{Contient soit '-' pour les requêtes non-IPP, ou le nom de l'opération IPP}
\item[\hspace{1mm} ipp-dstatus]{Contient soit '-' pour les requêtes non-IPP ou le code de status IPP}
\end{description}
 
\begin{description} \normalsize
\item[\hspace{1mm} bytes]{contient le nombre d'octets dans la requête. Pour les requêtes POST ce champ contient le nombre d'octets de données non-IPP qui sont reçus du client}
\item[\hspace{1mm} ipp-operation]{Contient soit '-' pour les requêtes non-IPP ou l'opération IPP}
\item[\hspace{1mm} ipp-status]{contient soit '-' pour les requêtes non-IPP ou le code de status IPP}
\end{description}
 
\vspace{1cm}{\huge Format de error\_log }
 
\
 
\hspace{1mm} Le fichier error\_log liste les messages du scheduler - erreurs, alertes, etc. La directive LogLevel contrôle les messages loggés:
 
{\ttfamily
I \texttt{[}20/May/1999:19:18:28 +0000\texttt{]} \texttt{[}Job 1\texttt{]} Queued on 'DeskJet' by 'mike'.\\ D \texttt{[}20/May/1999:19:18:28 +0000\texttt{]} \texttt{[}Job 1\texttt{]} argv\texttt{[}0\texttt{]}="DeskJet"\\ D \texttt{[}20/May/1999:19:18:28 +0000\texttt{]} \texttt{[}Job 1\texttt{]} argv\texttt{[}1\texttt{]}="1"\\ D \texttt{[}20/May/1999:19:18:28 +0000\texttt{]} \texttt{[}Job 1\texttt{]} argv\texttt{[}2\texttt{]}="mike"\\ D \texttt{[}20/May/1999:19:18:28 +0000\texttt{]} \texttt{[}Job 1\texttt{]} argv\texttt{[}3\texttt{]}="myjob"\\ D \texttt{[}20/May/1999:19:18:28 +0000\texttt{]} \texttt{[}Job 1\texttt{]} argv\texttt{[}4\texttt{]}="1"\\ D \texttt{[}20/May/1999:19:18:28 +0000\texttt{]} \texttt{[}Job 1\texttt{]} argv\texttt{[}5\texttt{]}="media=\\ na\_letter\_8.5x11in sides=one-sided"\\ D \texttt{[}20/May/1999:19:18:28 +0000\texttt{]} \texttt{[}Job 1\texttt{]} argv\texttt{[}6\texttt{]}="/var/spool/cups/\\ d000001-001"\\ I \texttt{[}20/May/1999:19:21:02 +0000\texttt{]} \texttt{[}Job 2\texttt{]} Queued on 'DeskJet' by 'mike'.\\ I \texttt{[}20/May/1999:19:22:24 +0000\texttt{]} \texttt{[}Job 2\texttt{]} Canceled by 'mike'.\\
}
\vspace{8mm}
 
\vspace{1cm}{\huge Champs }
 
\
 
\begin{description} \normalsize
\item[\hspace{1mm} level]{Contient le type de message:}
\end{description}
 
\begin{description} \normalsize
\item[\hspace{6mm} A]{alert}
\item[\hspace{6mm} C]{crit}
\item[\hspace{6mm} D]{debug}
\item[\hspace{6mm} d]{debug2}
\item[\hspace{6mm} E]{error}
\item[\hspace{6mm} I]{info}
\item[\hspace{6mm} N]{notice}
\item[\hspace{6mm} W]{warn}
\item[\hspace{6mm} X]{emerg}
\end{description}
 
\begin{description} \normalsize
\item[\hspace{1mm} date-time]{contient la date et heure de l'impression de la page.}
\item[\hspace{1mm} message]{contient un message textuel.}
\end{description}
 
\vspace{1cm}{\huge Format de page\_log }
 
\
 
\hspace{1mm} Le fichier page\_log liste chaque page ou groupe de pages envoyés à une imprimante. Par défaut, chaque ligne contient les informations suivantes (peut être changé avec la directive PageLogFormat):
 
{\ttfamily
printer user job-id date-time page-number num-copies job-billing\\ \hspace{2mm}job-originating-host-name job-name media sides\\ \hspace{2mm}\\ printer user job-id date-time total num-impressions job-billing\\ \hspace{2mm}job-originating-host-name job-name media sides\\
}
\vspace{8mm}
 
\hspace{1mm} Exemple:
 
{\ttfamily
DeskJet root 1 \texttt{[}20/May/1999:19:21:05 +0000\texttt{]} 1 1 acme-123\\ \hspace{2mm}localhost myjob na\_letter\_8.5x11in one-sided\\ DeskJet root 1 \texttt{[}20/May/1999:19:21:05 +0000\texttt{]} 2 1 acme-123\\ \hspace{2mm}localhost myjob na\_letter\_8.5x11in one-sided\\ \hspace{2mm}\\ DeskJet root 1 \texttt{[}20/May/1999:19:21:06 +0000\texttt{]} total 2 acme-123\\ \hspace{2mm}localhost myjob na\_letter\_8.5x11in one-sided\\
}
\vspace{8mm}
 
\begin{description} \normalsize
\item[\hspace{1mm} printer]{Contient le nom de l'imprimante}
\item[\hspace{1mm} user]{username (IPP requesting-user-name)}
\item[\hspace{1mm} job-id]{Numéro de job de la page imprimée}
\item[\hspace{1mm} date-time]{Date et heure du démarrage de l'impression}
\item[\hspace{1mm} page-number et num-copies]{contiennent le numéro de page et le nombre de copies imprimées}
\item[\hspace{1mm} ]{Les lignes contenant le mot clé "total" ont un champs num-impressions à la place qui fournis le nombre total d'impressions qui ont été imprimés pour ce job.}
\item[\hspace{1mm} job-billing]{Contient une copie des attributs job-billing ou job-account-id fournis avec les requêtes IPP Create-Job ou Print-Job, ou '-'}
\item[\hspace{1mm} job-originating-host-name]{Contient le hostname ou l'adresse IP du client}
\item[\hspace{1mm} job-name]{Contient une copie de l'attribut job-name fournis avec Create-job ou Print-Job ou '-'}
\item[\hspace{1mm} media]{Contient une copie du media ou media-col/media-size fournis avec Create-Job ou Print-Job ou '-'}
\item[\hspace{1mm} sides]{Contient une copie de l'attribut sides fournis par Create-Job ou Print-Job ou '-'}
\end{description}
\end{flushleft}
\end{document}
