Groupe de travail R�seau |
R. Herriot |
Request for Comments : 3996 |
Global Workflow Solutions |
Cat�gorie : Standards Track |
T. Hastings |
Mise � jour de : 2911, 2910 |
Xerox Corporation |
Mars 2005���������������������������������������������������������� H. Lewis
��������������������������������������������������������������������������� IBM Corp.
Protocole d�impression Internet (IPP) : M�thode de livraison 'ippget' pour les notifications d��v�nement
Statut du pr�sent M�mo
Le pr�sent
document sp�cifie un protocole de normalisation Internet pour la communaut�
Internet, et appelle � discussion et suggestions en vue de son am�lioration.
Pri�re de se rapporter � l��dition en cours des "Internet Official
Protocol Standards" (normes
officielles du protocole Internet) (STD 1) pour conna�tre l��tat de la
normalisation et le statut du pr�sent protocole. La distribution du pr�sent
m�mo n�est pas soumise � restrictions.
D�claration de copyright
Copyright (C) The Internet Society (2005).
R�sum�
Le pr�sent document d�crit une extension au Protocole 1.1 d�impression sur Internet : Mod�le et s�mantique (RFC 2911, RFC 2910). Le pr�sent document sp�cifie la m�thode de livraison tir�e 'ippget' � utiliser avec la sp�cification "Protocole d�impression Internet (IPP) : Notifications d��v�nement et abonnements" (RFC 3995). Cette m�thode de livraison IPPGET est EXIG�E pour tous les clients et imprimantes qui prennent en charge la RFC 3995. Le r�cepteur de notification, agissant comme client, atteint (tire) les notifications d��v�nement en utilisant l�op�ration Obtenir les notifications d�finie dans le pr�sent document.
Table des mati�res
1.����� Introduction................................................................................................................................................................................ 3
2.����� Terminologie.............................................................................................................................................................................. 3
2.1.������ Terminologie
de conformit�.......................................................................................................................................... 3
2.2.������ Autres
termes................................................................................................................................................................... 3
3.����� Mod�le
et fonctionnement........................................................................................................................................................ 4
4.����� Informations
g�n�rales............................................................................................................................................................ 4
5.����� Op�ration
Get-Notifications.................................................................................................................................................... 5
5.1.������ Demande
Get-Notifications.......................................................................................................................................... 6
5.1.1����� notify-subscription-ids (1setOf integer(1:MAX))................................................................................................. 7
5.1.2����� notify-sequence-numbers (1setOf integer(1:MAX))............................................................................................ 7
5.1.3����� notify-wait (bool�en)................................................................................................................................................. 8
5.2������� R�ponse
� Get-Notifications......................................................................................................................................... 8
5.2.1����� notify-get-interval (entier de 0 � MAX)................................................................................................................ 10
5.2.2����� printer-up-time (entier de 1 � MAX)...................................................................................................................... 11
6.����� Informations
suppl�mentaires sur les attributs de gabarit d�abonnement.................................................................. 13
6.1������� notify-pull-method
(mot cl� de type2)...................................................................................................................... 13
7.����� Attributs
de description d�abonnement............................................................................................................................... 13
8.����� Attributs
de description d�imprimante suppl�mentaires................................................................................................. 14
8.1������� ippget-event-life
(entier(15:MAX)).......................................................................................................................... 14
9.����� Nouvelles
valeurs pour les attributs de description d�imprimante existants............................................................... 15
9.1������� notify-pull-method-supported
(1setOf type2 keyword)......................................................................................... 15
9.2������� operations-supported
(1setOf �num�ration de type2).......................................................................................... 15
10.������� Nouveaux
codes d��tat....................................................................................................................................................... 15
10.1����� successful-ok-events-complete
(0x0007)................................................................................................................. 15
11.������� Codage
et transport........................................................................................................................................................... 15
12.������� Exigences
de conformit�................................................................................................................................................... 17
12.1����� Conformit�
des imprimantes IPP............................................................................................................................... 17
12.2����� Conformit�
des clients IPP......................................................................................................................................... 17
13.������� R�f�rences
normatives..................................................................................................................................................... 18
14.������� R�f�rences
informatives.................................................................................................................................................. 18
15.������� Consid�rations
relatives � l�IANA................................................................................................................................. 19
15.1����� Enregistrements
d�attributs........................................................................................................................................ 19
15.2����� Enregistrements
des valeurs d�attribut de m�thode de livraison et de mot cl� suppl�mentaire
pour les attributs existants��������������� 19
15.3����� Valeurs
d�attribut d��num�ration suppl�mentaires.............................................................................................. 19
15.4����� Enregistrements
d�op�rations.................................................................................................................................... 20
15.5����� Enregistrement
de code d��tat................................................................................................................................... 20
16.������� Consid�rations
d�internationalisation........................................................................................................................... 20
17.������� Consid�rations
sur la s�curit�....................................................................................................................................... 20
17.1����� Droits
d�acc�s du client r�cepteur de notification................................................................................................ 21
17.2����� Menaces
sur la s�curit� des imprimantes................................................................................................................ 21
17.3����� Menaces
sur la s�curit� du r�cepteur de notification........................................................................................... 21
17.4����� Exigences
de s�curit� pour les imprimantes........................................................................................................... 22
17.5����� Exigences
de s�curit� pour les clients...................................................................................................................... 22
18���� Description
des documents de base IPP (pour information)............................................................................................ 22
19���� Contributeurs.......................................................................................................................................................................... 23
Le pr�sent document d�crit une extension au protocole 1.1 d�impression sur Internet : Mod�le et s�mantique [RFC 2911], [RFC 2910]. Le pr�sent document sp�cifie la m�thode de livraison tir�e 'ippget' � utiliser avec la sp�cification " Protocole d�impression sur Internet (IPP) : Notifications d��v�nement et abonnements" [RFC3995]. Cette m�thode de livraison IPPGET est EXIGEE pour tous les clients et imprimantes qui prennent en charge la [RFC3995]. Le r�cepteur de notification, agissant comme un client, atteint (tire) les notifications d��v�nement en utilisant l�op�ration Obtenir les notifications d�finie dans le pr�sent document. Voir � la section 21 du pr�sent document la description des documents IPP de base. La description du mod�le de notification d��v�nement IPP figure dans la [RFC3995].
Avec cette m�thode de livraison tir�e, lorsque survient un �v�nement, l�imprimante sauvegarde la Notification d��v�nement durant une p�riode de temps appel�e Dur�e de vie d��v�nement. Le r�cepteur de notification atteint (tire) les notifications d��v�nement en utilisant l�op�ration Obtenir les notifications. Cette op�ration am�ne l�imprimante � retourner toutes les notifications d��v�nement d�tenues pour le ou les objets d�abonnement sp�cifi�s. Si le r�cepteur de notification a choisi l�option Mode d�attente d��v�nement pour attendre des notifications d��v�nement suppl�mentaires, l�imprimante PEUT continuer � retourner des notifications d��v�nement au r�cepteur de notification comme r�ponses asynchrones � Obtenir les notifications alors que les �v�nements surviennent en utilisant la transaction g�n�r�e par le r�cepteur de notification.
Le r�cepteur de notification peut terminer le Mode d�attente d��v�nement (sans fermer la connexion) en fournissant l�attribut "notify-wait" (notifier l�attente) (bool�en) avec la valeur 'faux' dans une demande Obtenir les notifications ult�rieure. De m�me, l�imprimante peut terminer le� Mode d�attente d��v�nement (sans fermer la connexion) en retournant l�attribut d�op�ration "notify-get-interval" (notifier d�obtenir les intervalles) (entier) dans une r�ponse � Obtenir les notifications qui dit au r�cepteur de notification combien de temps attendre avant de r�essayer.
La pr�sente section d�finit les termes suivants qui sont utilis�s tout au long du document :
Les termes en majuscules, tels que DOIT, NE DOIT PAS, EXIGE, DEVRAIT, NE DEVRAIT PAS, PEUT, PEUT NE PAS, et FACULTATIF, ont une signification particuli�re qui se rapporte � la conformit� telle que d�finie dans la RFC 2119 et au paragraphe 12.1 de la [RFC2911]. Si une mise en �uvre prend en charge l�extension d�finie dans le pr�sent document, ces termes s�appliquent alors ; autrement, ils ne s�appliquent pas. Ces termes d�finissent seulement la conformit� au pr�sent document ; ils n�affectent pas la conformit� aux autres documents, sauf d�clar� explicitement par ailleurs.
Le pr�sent document utilise la m�me terminologie que la [RFC2911], comme "client", "imprimante", "attribut", "valeur d�attribut", "mot cl�", "op�ration", "demande", "r�ponse", "administrateur", "op�rateur", et "prise en charge", avec la m�me signification. Le pr�sent document utilise aussi la terminologie d�finie dans la [RFC3995], � savoir "abonnement (objet)", "r�cepteur de notification", "�v�nement", "notification d��v�nement", "notification d��v�nement compos�", "dur�e de vie d��v�nement", et "groupe d�attribut de notification d��v�nement", avec la m�me signification. De plus, le pr�sent document d�finit les termes suivants pour ses propres besoins :
Mode attente d��v�nement : mode demand� par un client r�cepteur de notification dans sa demande Obtenir les notifications et accord� par une imprimante pour garder la connexion �tablie pendant que l�imprimante envoie les r�ponses ult�rieures � l�op�ration Obtenir les notifications au r�cepteur de notification sous la forme de notifications d��v�nement au fur et � mesure qu�elles surviennent.
Dans une op�ration de cr�ation d�abonnement, lorsque l�attribut "notifier la m�thode tir�e" est pr�sent et a la valeur de mot cl� "ippget", le client demande que l�imprimante utilise la m�thode de livraison tir�e "ippget" pour les notifications d��v�nement associ�es au nouvel objet d�abonnement.
Lorsqu�un �v�nement survient, l�imprimante DOIT g�n�rer une notification d��v�nement et DOIT lui allouer sa dur�e de vie d��v�nement. L�imprimante DOIT conserver une notification d��v�nement pendant la dur�e de vie d��v�nement qui lui est allou�e.
Lorsqu�un r�cepteur de r�cepteur de notification veut recevoir des notifications d��v�nement pour un objet d�abonnement, il effectue l�op�ration Obtenir les notifications en fournissant l�identifiant d�abonnement de l�objet d�abonnement, ce qui am�ne l�imprimante � retourner toutes les notifications d��v�nement conserv�es non expir�es pour cet objet d�abonnement. Si le r�cepteur de notification a choisi l�option Mode d�attente d��v�nement pour attendre des notifications d��v�nement suppl�mentaires, la r�ponse � la demande Obtenir les notifications continue ind�finiment tant que l�imprimante continue � envoyer des notifications d��v�nement dans la r�ponse alors que surviennent des �v�nements pour cet objet d�abonnement.
Lorsque le r�cepteur de notification demande des notifications d��v�nement pour des objets d�abonnement par t�che, le r�cepteur de notification effectue normalement l�op�ration Obtenir les notifications dans la seconde ou il effectue l�op�ration de cr�ation d�abonnement. Parce que l�imprimante DOIT sauvegarder les notifications d��v�nement pendant au moins 15 secondes (voir le paragraphe 8.1), le r�cepteur de notification ne manquera vraisemblablement aucune notification d��v�nement survenant entre la cr�ation d�abonnement et l�op�ration Obtenir les notifications.
La m�thode de livraison �ippget� est principalement con�ue pour (1) un client qui veut obtenir les �v�nements (de l�objet d�abonnement par t�che de la t�che) pour une t�che qu�il a soumise et (2) un client privil�gi� qui veut obtenir tous les �v�nements par t�che ou par imprimante d�un objet d�abonnement par imprimante.
Si une imprimante prend en charge cette m�thode de livraison, ses caract�ristiques sont les suivantes :
Tableau 1.� Informations sur la m�thode de livraison
R�alisation
des exigences de conformit� de la m�thode |
M�thode de
livraison |
1. Quel est le nom de sch�ma d�URL pour la
m�thode de livraison pouss�e, ou le nom de m�thode de mot cl� pour la m�thode
de livraison tir�e ? |
Nom de m�thode de mot cl� 'ippget' |
2. La prise en charge de la m�thode de
livraison pour une imprimante IPP est elle EXIG�E, RECOMMAND�E, ou
FACULTATIVE ? |
EXIG�E |
3. Quels protocoles de transport et de
livraison l�imprimante utilise-t-elle pour d�livrer le contenu de
notification d��v�nement ; c�est-�-dire, quelle est la pile de r�seau
compl�te ? |
IPP avec une nouvelle op�ration. |
4. Peut-on combiner plusieurs notifications
d��v�nement en une notification d��v�nement compos�e ? |
Oui. |
5. La m�thode de livraison est elle initi�e
par le r�cepteur de notification (tir�e), ou par l�imprimante (pouss�e) ? |
Cette m�thode de livraison est une m�thode
tir�e avec des aspects de m�thode pouss�e, bien que l�imprimante n�initie pas
l�op�ration. |
6. Le contenu de la notification
d��v�nement est-il � destination machine ou � destination humaine ? |
A destination machine. |
7. Quelle section de ce document r�pond aux
questions suivantes ? Pour une notification d��v�nement � destination
machine, quelle est la repr�sentation et quel est le
codages des valeurs d�finies au paragraphe 9.1 de [RFC3995], et quels en sont
les exigences de conformit� ? Pour une notification d��v�nement � destination
humaine, quels sont la repr�sentation et le codage des �l�ments d�information
d�finis au paragraphe 9.2 de [RFC3995], et quels en
sont les exigences de conformit� ? |
Section 5. |
8.
Quels sont le d�lai de latence et la fiabilit� du protocole de transport et
de livraison ? |
Les
m�mes que pour IPP et que pour le transport HTTP sous jacent. |
9.
Quels sont les aspects de s�curit� du protocole de transport et de livraison
; par exemple, comment est-il trait� dans les pare-feu ? |
Comme
pour IPP et le transport HTTP sous jacent et dans la m�me direction, donc pas
de nouvelles consid�rations sur les pare feu. |
10.
Quelles sont les restrictions sur la longueur du contenu ? |
Aucune. |
11.
Quelles sont les valeurs suppl�mentaires ou �l�ments d�information qu�une
imprimante envoie dans un contenu de notification d��v�nement et ses
exigences de conformit� ? |
Aucune. |
12.
Quels sont les attributs suppl�mentaires de gabarit d�abonnement et/ou de
description d�abonnement et leurs exigences de conformit� ? |
Aucune. |
13.
Quels sont les attributs suppl�mentaires de description d�imprimante et leurs
exigences de conformit� ? |
"ipp-event-life"
(entier (15: MAX)) |
Cette op�ration est produite par un client agissant comme r�cepteur de notification qui demande � l�imprimante de retourner toutes les notifications d��v�nement conserv�es pour le ou les objets d�abonnement identifi�s.
Une imprimante DOIT prendre en charge cette op�ration, DOIT accepter la demande dans tout �tat (voir la [RFC2911] attributs "�tat d�imprimante" et "cause d��tat d�imprimante"), et DOIT rester dans le m�me �tat avec les m�mes valeurs de "cause d��tat d�imprimante".
Lorsqu�une imprimante effectue cette op�ration, elle DOIT retourner toutes, et seulement elles, les notifications d��v�nement
1.����� dont l�attribut de description d�abonnement d�objet d�abonnement associ� "notifier l�identifiant d�abonnement" est �gal � une des valeurs de l�attribut d�op�ration "notifier les identifiants d�abonnement" (1setOf entier de 1 � MAX) ET
2.����� dont l�objet d�abonnement associ� contient l�attribut "notifier la m�thode tir�e" et a la valeur de mot cl� 'ippget', ET
3.����� dont "notifier le num�ro de s�quence" est �gal ou sup�rieur � la valeur correspondante de l�attribut d�op�ration "notifier les num�ros de s�quence" (1setOf entier de 1 � MAX) s�il est fourni ET
4.����� dont la dur�e de vie d��v�nement n�a pas encore expir� ET
5.����� o� le client r�cepteur de notification a les droits d�acc�s en lecture sur l�objet d�abonnement identifi� (voir ci-dessous le paragraphe sur les droits d�acc�s).
Le client r�cepteur de notification DOIT soit (a) demander le mode d�attente d��v�nement en fournissant l�attribut d�op�ration "notifier l�attente" avec la valeur 'vrai', soit (b) supprimer Mode d�attente d��v�nement en omettant l�attribut d�op�ration "notifier l�attente" ou en le fournissant avec une valeur de 'faux'. Pour terminer ensuite le Mode d�attente d��v�nement, le client r�cepteur de notification DOIT clore la connexion. Pour terminer le mode d�attente d��v�nement, l�imprimante DOIT soit (a) retourner l�attribut d�op�ration "notifier d�obtenir l�intervalle" dans une r�ponse � Obtenir les notifications (comportement RECOMMAND�) soit (b) clore la connexion. Les attributs d�op�ration "notifier d�obtenir l�intervalle" dit au r�cepteur de notification combien de temps il doit attendre avant d�essayer la demande Obtenir les notifications suivante.
Droits d�acc�s : L�utilisateur authentifi� (voir le paragraphe 8.3 de la [RFC2911]) qui effectue cette op�ration DOIT �tre (1) le propri�taire de chaque objet d�abonnement identifi� par l�attribut d�op�ration "notifier les identifiants d�abonnement" (voir au paragraphe 5.1.1), (2) un op�rateur ou administrateur de l�imprimante (voir la section 1 et le paragraphe 8.5 de la [RFC2911]), ou (3) autrement autoris� par la politique de s�curit� configur�e par l�administrateur de l�imprimante � demander les notifications d��v�nement � partir du ou des objets d�abonnement cibles. Autrement, l�imprimante IPP DOIT rejeter l�op�ration et retourner le code d��tat 'erreur client, interdit', 'erreur client, non authentifi�', ou 'erreur client, non autoris�', selon le cas appropri�. De plus, la politique de s�curit� de l�imprimante PEUT limiter les attributs retourn�s par l�op�ration Obtenir les notifications, d�une fa�on similaire � celle de l�op�ration Obtenir les attributs de t�che (voir la fin du paragraphe 3.3.4.2 de la [RFC2911]).
Les groupes d�attributs suivants font partie de la demande Obtenir les notifications :
Groupe 1 : Attributs d�op�ration
Langage naturel et ensemble de caract�res :
Les attributs "attributes-charset" et "attributes-natural-language", comme d�crit au paragraphe 3.1.4.1 de la [RFC2911].
Cible :
L�attribut d�op�ration "printer-uri" (uri) qui est la cible de cette op�ration comme d�crit au paragraphe 3.1.5 de la [RFC2911].
Nom de l�utilisateur demandeur :
L�attribut "requesting-user-name" (name(MAX)) DEVRAIT �tre fourni par le client comme d�crit au paragraphe 8.3 de la [RFC2911].
Cet attribut identifie un ou plusieurs objets d�abonnement pour lesquels des �v�nements sont demand�s. Le client DOIT fournir cet attribut avec au moins une valeur. L�objet imprimante DOIT prendre en charge cet attribut avec plusieurs valeurs.
Si aucun objet d�abonnement n�existe avec l�identifiant fourni, ou si l�objet d�abonnement identifi� ne contient pas l�attribut "notifier la m�thode tir�e" avec la valeur de mot cl� 'ippget', l�imprimante DOIT retourner le code d��tat 'erreur client, introuvable'.
Note : Les noms de "notifier les identifiants d�abonnement" et de "notifier les num�ros de s�quence" se terminent tous deux au pluriel, car ils sont multi valeurs. Cependant, il y a d�autres occurrences de ces noms d�attribut au singulier qui sont mono valeur.
Cet attribut sp�cifie une ou plusieurs des plus faibles valeurs de num�ro de s�quence de notification d��v�nement pour les objets d�abonnement identifi�s par les valeurs correspondantes de l�attribut d�op�ration "notifier les identifiants d�abonnement". Le r�cepteur de notification DEVRAIT fournir cet attribut, et le nombre de valeurs DEVRAIT �tre le m�me que celui de l�attribut "notifier les identifiants d�abonnement". L�imprimante DOIT prendre en charge cet attribut avec plusieurs valeurs.
L�imprimante NE DOIT PAS retourner des �v�nements Notification avec des num�ros de s�quence plus faibles pour l�objet d�abonnement correspondant. Donc, en fournissant les valeurs appropri�es pour cet attribut, le r�cepteur de notification peut emp�cher d�obtenir les m�mes Notifications d��v�nement qu�� partir d�un objet d�abonnement qui avait �t� retourn� sur une pr�c�dente demande Obtenir les notifications. Le r�cepteur de notification DEVRAIT se souvenir de la plus forte valeur de "notifier le num�ro de s�quence" retourn�e pour chaque objet d�abonnement demand� et DEVRAIT passer cette valeur pour chaque objet d�abonnement demand� � la demande Obtenir les notifications suivante.
Si le r�cepteur de notification fournit moins de valeurs pour cet attribut (y compris l�omission de cet attribut) qu�il ne le fait pour l�attribut d�op�ration "notifier les identifiants d�abonnement", l�imprimante suppose une valeur de '1' pour chaque valeur manquante. Une valeur de '1' am�ne l�imprimante � retourner toute notification d��v�nement non expir�e pour cet objet d�abonnement, car '1' est le num�ro de s�quence le plus faible possible. Si le r�cepteur de notification fournit plus de valeurs pour cet attribut que le nombre de valeurs pour l�attribut d�op�ration "notifier les identifiants d�abonnement", l�imprimante ignore les valeurs exc�dentaires.
Note : Si un r�cepteur de notification effectue deux op�rations Obtenir les notifications cons�cutives avec la m�me valeur pour "notifier le num�ro de s�quence" (ou omet l�attribut), la valeur d�horodatage de la premi�re notification d��v�nement dans la seconde r�ponse � Obtenir les notifications peut �tre inf�rieure � celle de l�horodatage de la derni�re notification d��v�nement dans la premi�re r�ponse � Obtenir les notifications. Cela arrive parce que l�imprimante envoie toutes les notifications d��v�nement non expir�es qui ont un num�ro de s�quence �gal ou sup�rieur conform�ment � l�ordre sp�cifi� dans la [RFC3995], et certaines notifications d��v�nement provenant de la premi�re op�ration Obtenir les notifications peuvent n��tre pas arriv�es � expiration au moment o� survient la seconde op�ration Obtenir les notifications.
Cette valeur indique si le r�cepteur de notification veut le mode d�attente d��v�nement. Le client PEUT fournir cet attribut. L�objet imprimante DOIT prendre en charge les deux valeurs de cet attribut.
Si le client fournit la valeur 'faux' ou omet cet attribut, le client ne demande pas le mode d�attente d��v�nement. Si la valeur est 'vrai', le client demande le mode d�attente d��v�nement. Voir les r�gles de Mode d�attente d��v�nement au d�but du paragraphe 5.2.
L�imprimante a les options suivantes pour r�pondre � une demande Obtenir les notifications :
1.����� L�imprimante peut rejeter la demande et retourner le code d��tat 'erreur serveur, occup�' si l�imprimante est trop occup�e pour accepter cette op�ration � ce moment. Dans ce cas, l�imprimante DOIT retourner l�attribut d�op�ration "obtenir l�intervalle de notification" pour indiquer quand le client DEVRAIT r�essayer.
2.����� Si le r�cepteur de notification n�a pas demand� le mode d�attente d��v�nement ("notifier mode d�attente" = 'faux' ou omis), l�imprimante DOIT imm�diatement retourner toutes les notifications d��v�nement qu�elle garde � ce moment dans le ou les objets d�abonnement demand�s et DOIT retourner l�attribut d�op�ration "notifier obtenir l�intervalle" avec le nombre de secondes � partir du pr�sent, auquel le r�cepteur de notification DEVRAIT r�p�ter la demande Obtenir les notifications pour obtenir les futures notifications d��v�nement.
3.����� Si le r�cepteur de notification a demand� le mode d�attente d��v�nement ("notifier mode d�attente" = 'vrai'), l�imprimante DOIT imm�diatement retourner toutes les Notifications d��v�nement qu�elle d�tient � ce moment dans le ou les objets d�abonnement demand�s et DOIT continuer � retourner les notifications d��v�nement comme elles surviennent jusqu�� ce que tous les objets d�abonnement demand�s soient annul�s. Un objet d�abonnement est annul� soit via l�op�ration Annuler l�abonnement soit par l�imprimante (par exemple, l�objet d�abonnement est annul� lorsque la t�che associ�e se termine et n�est plus dans la phase R�tention de t�che ou Historique de t�ches ; voir au paragraphe 8.1 la discussion sur l�attribut "ippget-event-life (entier de 15 � MAX)").
Cependant, l�imprimante PEUT d�cider � tout moment de terminer Mode d�attente d��v�nement, y compris dans la premi�re r�ponse. Dans ce cas, l�imprimante DOIT retourner l�attribut d�op�ration "notifier l�intervalle d�obtention". Cet attribut indique que l�imprimante souhaite quitter le Mode d�attente d��v�nement et le nombre de secondes dans le futur auquel le r�cepteur de notification DEVRAIT r�essayer l�op�ration Obtenir les notifications. Le r�cepteur de notification DOIT accepter cette r�ponse et DOIT se d�connecter. Si le r�cepteur de notification ne se d�connecte pas, l�imprimante DEVRAIT le faire.
Du point de vue du r�cepteur de notification, la r�ponse appara�t dans une salve initiale de donn�es, qui inclut le groupe d�attributs d�op�ration et un groupe d�attributs de notification d��v�nement par notification d��v�nement que conserve l�imprimante. Apr�s la salve initiale de donn�es, si le r�cepteur de notification a choisi l�option Mode d�attente d��v�nement pour attendre des notifications d��v�nement suppl�mentaires, le r�cepteur de notification re�oit des groupes d�attributs de notification d��v�nement occasionnels. Les serveurs mandataires peuvent diff�rer certaines notifications d��v�nement ou provoquer la survenance de fins de temporisations. Le client DOIT �tre pr�par� � effectuer � nouveau l�op�ration Obtenir les notifications lorsque surviennent des fins de temporisation.
Chaque attribut est cod� en utilisant les r�gles IPP pour les attributs de codage [RFC2910] et PEUT �tre cod� dans n�importe quel ordre. Note : la r�ponse Obtenir les t�ches dans la [RFC2911] agit comme mod�le pour coder plusieurs groupes d�attributs. Voir � la section 11 les r�gles de codage et de transport.
Les groupes d�attributs suivants font partie de la r�ponse � Obtenir les notifications :
Groupe 1 : Attributs de fonctionnement
Message d��tat : En plus du code d��tat EXIG� retourn� dans chaque r�ponse, la r�ponse inclut FACULTATIVEMENT un attribut d�op�ration "message d��tat" (texte(255)) et/ou "message d��tat d�taill�" (texte(MAX)), comme d�crit � la section 13 et au paragraphe 3.1.6 de la [RFC2911]. L�imprimante peut retourner tout code d��tat d�fini dans la [RFC2911]. Si le code d��tat n�est pas 'r�ussite-xxx', l�imprimante NE DOIT PAS retourner de groupe d�attribut de notification d��v�nement. Ci apr�s figurent les descriptions des codes d��tat importants :
r�ussite-ok : La r�ponse contient toute les notifications d��v�nement associ�es aux identifiants d�abonnement sp�cifi�s qui ont �t� fournis dans l�attribut d�op�ration "notifier les identifiants d�abonnement" de la demande. Si les objets d�abonnement demand�s n�avaient pas de notification d��v�nement associ�e, la r�ponse DOIT contenir z�ro notification d��v�nement.
r�ussite-ok-�v�nements-termin�s : Indique que ce retour est le dernier pour tous les objets d�abonnement qui correspondent � la demande, que des notifications d��v�nement soient retourn�es ou non. Cette condition survient pour Mode d�attente d��v�nement avec des r�cepteurs de notification qui attendent des r�ponses lorsque (1) l�objet d�abonnement est annul� par une op�ration Annuler l�abonnement, (2) l�objet d�abonnement est supprim�, lorsque arrive � expiration la dur�e de location de l�abonnement par imprimante, ou (3) l��v�nement 'fin de t�che' survient pour un abonnement par t�che. Cette condition survient aussi pour une demande Obtenir les notifications que fait un r�cepteur de notification apr�s l�ach�vement de la t�che, mais avant l�expiration de la dur�e de vie d��v�nement. Voir au paragraphe 10.1.
erreur client, introuvable : L�imprimante n�a pas d�objets d�abonnement dont l�attribut "notifier l�identifiant d�abonnement" �gale une des valeurs de l�attribut d�op�ration "notifier les identifiants d�abonnement" fournies, ou l�objet d�abonnement identifi� ne contient pas l�attribut "notifier la m�thode tir�e" avec la valeur de mot cl� 'ippget'.
erreur serveur, occup� : L�imprimante est trop occup�e pour accepter cette op�ration. L�imprimante DEVRAIT retourner l�attribut d�op�ration "notifier l�intervalle d�obtention" dans les attributs d�op�ration de la r�ponse ; puis le r�cepteur de notification DEVRAIT attendre pendant le nombre de secondes sp�cifi� par l�attribut d�op�ration "notifier l�intervalle d�obtention" avant de recommencer � effectuer cette op�ration. Si l�attribut d�op�ration "notifier l�intervalle d�obtention" n�est pas pr�sent, le r�cepteur de notification DEVRAIT utiliser les algorithmes normaux de r�duction de puissance du r�seau pour d�terminer quand effectuer cette op�ration � nouveau.
Langage naturel et ensemble de caract�res :
Les attributs "attributes-charset" et "attributes-natural-language", comme d�crit au paragraphe 3.1.4.2 de la [RFC2911]. L�imprimante DOIT utiliser, respectivement, les valeurs de "notifier le charset" et "notifier le langage naturel", d�un objet d�abonnement associ� aux notifications d��v�nement dans la r�ponse. Normalement, il y a seulement un objet d�abonnement correspondant, ou la valeur des attributs "notifier le charset" et "notifier le langage naturel" est la m�me dans tous les objets d�abonnement. Si non, l�imprimante DOIT prendre un objet d�abonnement � partir duquel obtenir la valeur de ces attributs. L�algorithme de prise de l�objet d�abonnement d�pend de la mise en oeuvre. Le choix du langage naturel ne pose pas de probl�me car les valeurs 'texte' et 'nom' peuvent outrepasser l�attribut d�op�ration "attributs de langage naturel". Le choix du charset par l�imprimante est critique parce qu�un mauvais choix peut la rendre incapable d�envoyer des valeurs de 'texte' et de 'nom' appropri�es.
La valeur de cet attribut d�op�ration est le nombre de secondes pendant lequel le r�cepteur de notification DEVRAIT attendre avant de r�essayer l�op�ration Obtenir les notifications. L�imprimante DOIT retourner cet attribut d�op�ration si (1) elle est trop occup�e pour retourner des �v�nements, (2) le client r�cepteur de notification n�a pas demand� le mode d�attente d��v�nement, ou si (3) l�imprimante termine le mode d�attente d��v�nement. Le client DOIT accepter cet attribut et DEVRAIT recommencer l�op�ration Obtenir les notifications (avec ou sans "notifier l�attente" = 'vrai') au nombre de secondes indiqu� dans le futur afin d�obtenir plus de notifications d��v�nement. Cette valeur est destin�e � aider le client � �tre un bon citoyen du r�seau.
La valeur de cet attribut DOIT �tre au moins aussi grande que celle de l�attribut de description d�imprimante "dur�e de vie de l��v�nement ippget" de l�imprimante (voir au paragraphe 8.1). L�imprimante PEUT retourner une valeur plus grande que celle de l�attribut de description d�imprimante "dur�e de vie de l��v�nement ippget" pourvu que l�imprimante augmente la dur�e de vie de l��v�nement pour cet objet d�abonnement de sorte que les r�cepteurs de notification prennent en compte la plus grande valeur et que l�interrogation � intervalles plus grands ne manque pas d��v�nements. Note : La mise en �uvre d�un tel algorithme exige des attributs cach�s dans l�objet d�abonnement qui D�PENDENT DE LA MISE EN �UVRE.
Si l�imprimante veut rester en mode d�attente d��v�nement, l�imprimante NE DOIT PAS alors retourner cet attribut dans la r�ponse.
Un tableau complet des combinaisons de "notifier l�attente", "code d��tat", "notifier l�intervalle d�obtention", et des groupes d�attributs de notification d��v�nement pour les r�ponses � Obtenir la notification initiale (attente et pas d�attente) et des r�ponses suivantes � Mode d�attente d��v�nement (qui peuvent rester en Mode d�attente d��v�nement ou peuvent demander au r�cepteur de notification de quitter le mode d�attente d��v�nement) :
Tableau 2. Combinaisons de "notifier l�attente", "code d��tat", et "notifier l�intervalle d�obtention"
Le client
envoie "notifier
l�attente" |
L�imprimante
retourne : "code
d��tat" |
L�imprimante
retourne : "notifier
l�intervalle d�obtention" |
Groupes
d�attributs de
notification d��v�nement |
1.�
'faux'* |
'r�ussite-ok' |
DOIT retourner N |
peut �tre |
2.�
'faux'* |
'introuvable' |
NE DOIT PAS |
NE DOIT PAS |
3.�
'faux'* |
'occup�' |
DOIT retourner N |
NE DOIT PAS |
4.�
'faux'* |
'�v�nements-termin�s' |
NE DOIT PAS |
'fin de t�che' |
5.�
'vrai' |
'r�ussite-ok' |
NE DOIT PAS |
DOIT |
6.�
'vrai' |
'r�ussite-ok' |
DOIT retourner N |
peut �tre |
7.�
'vrai' |
'introuvable' |
NE DOIT PAS |
NE DOIT PAS |
8.�
'vrai' |
'occup�' |
DOIT retourner N |
NE DOIT PAS |
9.�
'vrai' |
'�v�nements-termin�s' |
NE DOIT PAS |
'fin de t�che' ou
peut �tre autre |
* 'faux' ou le client omet l�attribut "notifier l�attente".
Explication :
1-4 :� Le client ne demande pas le mode d�attente d��v�nement.
5-9 :� Le client demande le mode d�attente d��v�nement.
2,7 :� objet d�abonnement introuvable, ou annul� pr�c�demment ; le client NE DEVRAIT PAS r�essayer.
3,8 :� Serveur occup�, dit au client d�essayer plus tard ; le client devrait r�essayer dans N secondes.
4 :���� Le client interroge apr�s la fin de t�che, mais avant l�expiration de la dur�e de vie d��v�nement, et obtient l��v�nement 't�che termin�e', de sorte que le client ne devrait pas se soucier de r�essayer ; le client NE DEVRAIT PAS r�essayer plus tard.
5 :���� L�imprimante retourne une ou plusieurs notifications d��v�nement et est d�accord pour rester en Mode d�attente d��v�nement ; le client attend plus de notifications d��v�nement en retour.
6 :���� L�imprimante veut quitter le mode d�attente d��v�nement. Peut arriver sur la premi�re r�ponse (avec ou sans notifications d��v�nement) ou sur une r�ponse suivante avec ou sans notifications d��v�nement ; le client DEVRAIT r�essayer dans N secondes.
9 :���� Soit (1) l�imprimante retourne l��v�nement 't�che termin�e', soit (2) l�objet d�abonnement a �t� annul� par un Annuler la t�che ou l�abonnement par imprimante est arriv� � expiration sans �tre renouvel�. Pour le cas (1), au moins une notification d��v�nement DOIT �tre retourn�e ; pour le cas (2), il est peu vraisemblable qu�aucune notification d��v�nement soit retourn�e, et le client NE DEVRAIT PAS r�essayer.
La valeur de cet attribut est l�attribut "printer-up-time" de l�imprimante au moment o� l�imprimante envoie cette r�ponse. L�imprimante DOIT retourner cet attribut. Parce que chaque notification d��v�nement contient aussi la valeur de cet attribut lorsque l��v�nement est survenu, la valeur de cet attribut permet � un r�cepteur de notification de savoir quand chaque notification d��v�nement est survenue par rapport au moment de cette r�ponse.
Groupe 2 : Attributs non pris en charge
Voir la [RFC2911], paragraphe 3.1.7, pour des pr�cisions sur le retour des attributs non pris en charge.
Groupes 3 � N : Attributs de notification d��v�nement
L�imprimante r�pond par un groupe d�attributs de notification d��v�nement par notification d��v�nement correspondante. La r�ponse enti�re est consid�r�e comme une seule notification d��v�nement compos�e (voir la [RFC3995]). Les notifications d��v�nement correspondantes sont toutes des notifications d��v�nement non arriv�es � expiration associ�es aux objets d�abonnement correspondants et DOIVENT suivre les exigences "d�ordre de notification d��v�nement" pour les notifications d��v�nement au sein d�une notification d��v�nement compos�e sp�cifi�e � la section 9 de la [RFC3995]. En d�autres termes, l�imprimante DOIT ordonner ces groupes de notification d��v�nement en ordre d�horodatage ascendant (et de num�ro de s�quence) pour un objet d�abonnement. Si des notifications d��v�nement pour plusieurs objets d�abonnement sont retourn�es, les �v�nements Notification pour le prochain objet d�abonnement suivent dans l�ordre ascendant d�horodatage, etc.
Chaque groupe de notification d��v�nement DOIT contenir tous les attributs sp�cifi�s au paragraphe9.1 ("Contenu des notifications d��v�nement � destination machine") de la [RFC3995], avec les exceptions not�es par des ast�risques dans les tableaux ci-dessous.
Les tableaux ci-dessous sont identiques � ceux du paragraphe 9.1 ("Contenu des notifications d��v�nement � destination machine") de la [RFC3995], except� que chaque cellule de la colonne "Envoi" est "DOIT".
Si plus d�une notification d��v�nement est retourn�e et que leur �tat n�est pas le m�me, l�imprimante DOIT alors retourner un attribut "notifier le code d��tat" dans chaque groupe d�attribut de notification d��v�nement pour indiquer les diff�rentes valeurs d��tat.
Pour une notification d��v�nement pour tous �v�nements, l�imprimante inclut les attributs indiqu�s au Tableau 3.
Tableau 3. Attributs dans le contenu de notification d��v�nement
Valeur de source |
Envoi |
Objet de source |
notifier l�identifiant d�abonnement (entier(1:MAX)) |
DOIT |
abonnement |
notifier l�uri d�imprimante (uri) |
DOIT |
abonnement |
notifier les �v�nements abonn�s (mot cl� type2) |
DOIT |
notification d��v�nement |
printer-up-time (entier(1:MAX)) * |
DOIT |
imprimante |
heure en cours � l�imprimante (date et heure) |
DOIT ** |
imprimante |
Notifier num�ro de s�quence (entier (0:MAX)) |
DOIT |
abonnement |
Notifier charset (charset) |
DOIT |
abonnement |
Notifier langage naturel (langage naturel) |
DOIT |
abonnement |
Notifier donn�es d�utilisateur (cha�ne d�octet(63)) |
DOIT *** |
abonnement |
Notifier le texte (texte) |
DOIT |
notification d��v�nement |
attributs des "notifier les attributs" |
DOIT **** |
attribut d�imprimante |
attributs des "notifier les attributs" |
DOIT **** |
attribut de t�che |
attributs des "notifier les attributs" |
DOIT **** |
attribut d�abonnement |
* Comme sp�cifi� � la section 9 de la [RFC3995], la valeur de l�attribut "printer-up-time" envoy� dans chaque notification d��v�nement DOIT �tre l�heure � laquelle est survenu l��v�nement, et non l�heure d�envoi de la notification d��v�nement.
** L�imprimante DOIT envoyer l�attribut "heure en cours � l�imprimante" si et seulement si elle prend en charge l�attribut "heure en cours � l�imprimante" � l�objet imprimante.
*** Si l�objet d�abonnement associ� ne contient pas d�attribut "notifier les donn�es d�utilisateur", l�imprimante DOIT envoyer une cha�ne d�octets de longueur 0.
**** Si l�attribut "notifier les attributs" est pr�sent sur l�objet d�abonnement, l�imprimante DOIT envoyer tous les attributs sp�cifi�s par l�attribut "notifier les attributs". Note : si l�imprimante ne prend pas en charge l�attribut "notifier les attributs", il n�est pas pr�sent sur l�objet d�abonnement associ�.
Pour les notifications d��v�nement d��v�nements de t�che, l�imprimante inclut les attributs suppl�mentaires indiqu�s au Tableau 4.
Tableau 4. Attributs suppl�mentaires dans le contenu de notification d��v�nement pour les �v�nements de t�che
Valeur de source |
Envoi |
Objet de source |
Identifiant de t�che (entier(1:MAX)) |
DOIT |
t�che |
Etat de t�che (�num�ration de type1) |
DOIT |
t�che |
Causes de l��tat de t�che (1setOf mot cl� de type2) |
DOIT |
t�che |
t�ches d�impressions termin�es (entier(0:MAX)) |
DOIT * |
t�che |
* L�imprimante ne DOIT envoyer l�attribut "t�ches d�impressions termin�es" dans une notification d��v�nement que pour les combinaisons d��v�nements et d��v�nements abonn�s indiqu�s au Tableau 5.
Tableau 5. Combinaisons d��v�nements et d��v�nements abonn�s pour "t�ches d�impression termin�es"
Ev�nement de t�che |
Ev�nement de t�che
abonn� |
'avancement de t�che' |
'avancement de t�che' |
't�che termin�e' |
't�che termin�e' |
't�che termin�e' |
'changement d��tat de t�che' |
Pour une notification d��v�nement d��v�nements d�imprimante, l�imprimante inclut les attributs suppl�mentaires indiqu�s au Tableau 6.
Tableau 6.� Attributs suppl�mentaires dans le contenu de notification d��v�nement pour les �v�nements d�imprimante
Valeur de source |
Envoi |
Objet de source |
�tat d�imprimante (�num�ration de type1) |
DOIT |
imprimante |
causes d��tat d�imprimante (1setOf mot cl� de type2) |
DOIT |
imprimante |
l�imprimante accepte les t�ches (bool�en) |
DOIT |
imprimante |
La m�thode de livraison �ippget� ne d�finit aucun attribut suppl�mentaire de gabarit d�abonnement et ses exigences de conformit� pour les attributs de gabarit d�abonnement sont d�finis dans la [RFC3995]. La pr�sente section d�finit des informations suppl�mentaires sur les attributs de gabarit d�abonnement d�finis dans la [RFC3995].
Cet attribut de gabarit d�abonnement identifie la m�thode de livraison tir�e � utiliser pour l�objet d�abonnement (voir la [RFC3995]). Pour prendre en charge la m�thode de livraison tir�e 'ippget' d�finie dans le pr�sent document, l�imprimante DOIT prendre en charge cet attribut avec la valeur de mot cl� suivante :
'ippget' : indique que la m�thode de livraison tir�e 'ippget' est � utiliser pour cet objet d�abonnement.
Les exigences de conformit� de la m�thode de livraison �ippget� pour les attributs de description d�abonnement sont d�finies dans la [RFC3995]. La m�thode de livraison �ippget� ne d�finit aucun attribut de description d�abonnement suppl�mentaire.
La pr�sente section d�finit des attributs de description d�imprimante suppl�mentaires � utiliser avec la m�thode de livraison �ippget�.
Cet attribut de description d�imprimante sp�cifie la valeur de dur�e de vie d��v�nement que l�imprimante alloue � chaque �v�nement ; c�est-�-dire, le nombre de secondes apr�s la survenue d�un �v�nement durant lesquelles une imprimante va retourner cet �v�nement dans une notification d��v�nement d�une r�ponse � Obtenir les notifications. Apr�s l�expiration de la dur�e de vie d��v�nement pour cet �v�nement, l�imprimante ne PEUT plus retourner une notification d��v�nement pour cet �v�nement dans une r�ponse � Obtenir les notifications.
L�imprimante DOIT prendre en charge cet attribut si elle prend en charge la m�thode de livraison �ippget�. La valeur DOIT �tre 15 ou plus (au moins 15 secondes), et 60 (secondes) est la valeur RECOMMAND�E pour s�aligner sur les objets jmGeneralJobPersistence et jmGeneralAttributePersistence du MIB de surveillance de t�che PWG de la [RFC2707].
Par exemple, en supposant ce qui suit :
1.����� un client effectue une op�ration Cr�ation de t�che qui cr�e un objet d�abonnement associ� � la m�thode de livraison �ippget� ;
2.����� un �v�nement associ� � la nouvelle t�che survient imm�diatement apr�s la cr�ation de l�objet d�abonnement ;
3.����� le m�me client ou un autre client effectue une op�ration Obtenir les notifications de sorte que le client est connect� N secondes apr�s l�op�ration Cr�ation de t�che.
Alors, si N est inf�rieur � la valeur de cet attribut, le ou les clients effectuant l�op�ration Obtenir les notifications peut s�attendre � ne manquer aucune Notification d��v�nement, interdisant tout manque d�espace m�moire impr�vu de l�imprimante. Note : le client DOIT initialiser les Obtenir les notifications � un temps suffisamment inf�rieur � N secondes pour tenir compte du d�lai de latence du r�seau de sorte qu�il soit connect� � l�imprimante avant que N secondes ne s��coulent.
Si une imprimante prend en charge la m�thode de livraison �ippget�, elle DOIT garder les objets t�che 'termin�', 'annul�', ou 'avort�' dans les phases de R�tention de t�che et/ou Historique de t�che pendant au moins aussi longtemps que la valeur de cet attribut. L�imprimante PEUT conserver des t�ches plus longtemps que cette valeur. Voir au paragraphe 4.3.7.1 de la [RFC2911], et la discussion dans la [RFC3995] (concernant l��v�nement 't�che termin�e'). Cette derni�re explique qu�un r�cepteur de notification peut interroger les t�ches apr�s avoir re�u une notification d��v�nement� 't�che termin�e' afin de trouver d�autres informations sur la t�che qui est 'termin�e', 'avort�e', ou 'annul�e'. Cependant, cet attribut n�a pas d�effet sur l�op�ration Annuler l�abonnement, qui supprime l�objet d�abonnement imm�diatement qu�il contienne ou non l�attribut "notifier la m�thode tir�e" avec la valeur de mot cl� 'ippget'. Imm�diatement apr�s cela, les r�ponses � Obtenir les notifications NE DOIVENT PAS contenir de notifications d��v�nement associ�es � l�objet d�abonnement annul�.
La pr�sente section d�finit des valeurs suppl�mentaires pour les attributs existants de description d�imprimante, comme d�finit dans la [RFC3995].
La valeur de mot cl� suivante pour l�attribut "notifier la m�thode tir�e prise en charge" est ajout�e afin de prendre en charge la nouvelle m�thode de livraison d�finie dans le pr�sent document :
'ippgget' : m�thode de livraison tir�e de notification IPP d�finie dans le pr�sent document.
Le Tableau 7 fait la liste des valeurs de "identifiant d�op�ration" d�finies afin de prendre en charge la nouvelle op�ration Obtenir les notifications d�finie dans le pr�sent document.
Tableau 7. Allocation de l�identifiant d�op�ration
Valeur |
Nom d�op�ration |
0x001C |
Get-Notifications |
Le code d��tat suivant est d�fini comme extension pour cette m�thode de livraison et il est retourn� comme le code d��tat de l�op�ration Obtenir les notifications dans le groupe 1 ou les groupes 3 � N (voir le paragraphe 5.2).
L�imprimante DOIT retourner le code d��tat 'r�ussite-ok, �v�nements termin�s' pour indiquer lorsque cette r�ponse � Obtenir des notifications est la derni�re r�ponse pour un objet d�abonnement, que des notifications d��v�nement soient retourn�es ou non. Cette condition survient pour le mode d�attente d��v�nement avec les r�cepteurs de notification qui attendent des r�ponses lorsque (1) l�objet d�abonnement est annul� par une op�ration Annuler l�abonnement, (2) l�objet d�abonnement est supprim�, quand la location d�abonnement par imprimante arrive � expiration, ou (3) l��v�nement 't�che termin�e' survient pour un abonnement par t�che. Cette condition survient aussi pour une demande Obtenir les notifications que fait un r�cepteur de notification pr�s l�ach�vement de la t�che, mais avant l�expiration de la dur�e de vie de l��v�nement.
La pr�sente section d�finit les questions de codage et de transport pour cette m�thode de livraison sur la base de la [RFC2910].
Le codage d�une r�ponse � Obtenir les notifications est effectu� apr�s la r�ponse � Obtenir les t�ches (voir la [RFC2911]). Dans une r�ponse � Obtenir les notifications, chaque groupe d�attributs de notification d��v�nement DOIT d�buter par une '�tiquette d�attributs de notification d��v�nement' (voir la section "Codage des �tiquettes d�attribut suppl�mentaires" dans la [RFC3995]), et finir par une '�tiquette de fin des attributs'. De plus, pour le mode d�attente d��v�nement, ce qui se rapport au multi partie sert � s�parer chaque r�ponse multiple (dans le temps) en une seule demande Obtenir les notifications.
L�imprimante retourne la r�ponse � Obtenir les notifications comme suit :
1.����� Si le client R�cepteur de notification n�a pas demand� le mode d�attente d��v�nement ("notifier l�attente" = 'faux' ou omis), l�imprimante envoie la r�ponse avec un 'fin d��tiquette d�attributs' (voir le codage de Obtenir les t�ches dans la [RFC2911]), comme dans toute r�ponse d�op�ration.
2.����� Si le client R�cepteur de notification demande le mode d�attente d��v�nement ("notifier l�attente" = 'vrai') et si l�imprimante souhaite satisfaire la demande, l�imprimante DOIT retourner la r�ponse comme une partie application/ipp � l�int�rieur d�un type de support MIME multi partie. Lorsque surviennent un ou plusieurs �v�nements suppl�mentaires, l�imprimante retourne chacun comme un groupe suppl�mentaire de notification d��v�nement en utilisant une partie distincte d�application/ipp sous le type se rapportant � multi part.
3.����� Si le client a demand� le mode d�attente d��v�nement ("notifier l�attente" = 'vrai'), mais que l�imprimante ne souhaite pas satisfaire la demande dans la r�ponse initiale et veut que le client interroge explicitement les notifications d��v�nement, l�imprimante DOIT retourner l�attribut d�op�ration "notifier obtenir l�intervalle" (voir le paragraphe 5.2.1). L�imprimante retourne la r�ponse comme une partie application/ipp qui PEUT �tre � l�int�rieur d�un type se rapportant � multi-partie. Le client DOIT accepter cette r�ponse et reformuler la demande Obtenir les notifications dans un d�lai indiqu� par la valeur de l�attribut "notifier obtenir l�intervalle".
4.����� Si le client a demand� le mode d�attente d��v�nement ("notifier l�attente" = 'vrai'), et si l�imprimante a d�abord satisfait la demande mais souhaite ensuite quitter le mode d�attente d��v�nement, l�imprimante DOIT retourner l�attribut d�op�ration "notifier obtenir l�intervalle" (voir le paragraphe 5.2.1). L�imprimante retourne la r�ponse comme une partie d�application/ipp qui DOIT �tre � l�int�rieur d�un type se rapportant � multi partie.
NOTE : Si un r�cepteur de notification �choue � recevoir une r�ponse, il peut redemander � l�imprimante les m�mes notifications d��v�nement. Le r�cepteur de notification va recevoir les m�mes notifications d��v�nement qu�il aurait d� recevoir la premi�re fois, except� les notifications d��v�nement qui sont arriv�es � expiration dans l�intervalle.
L�imprimante PEUT regrouper les r�ponses, mais cela n�a pas d�incidence sur la s�mantique IPP.
Cette m�thode de livraison de notification utilise le transport et codage IPP de la [RFC2910] pour l�op�ration Obtenir les notifications avec l�extension suivante, allou�e dans la [RFC3995] :
Tableau 8. Valeur de "�tiquette des attributs de notification d��v�nement"
Valeur d��tiquette (Hex) |
Signification |
0x07 |
"event-notification-attributes-tag" |
La pr�sente section fait la liste des exigences de conformit� pour les clients et les imprimantes.
Il est FACULTATIF pour une imprimante de prendre en charge les notifications IPP telles que d�finies dans la [RFC3995]. Cependant, si une imprimante prend en charge les notifications IPP, l�imprimante DOIT prendre en charge la m�thode de livraison �ippget�, comme d�fini dans le pr�sent document, comme une de ses m�thodes de livraison. Les imprimantes IPP qui sont conformes � la pr�sente sp�cification :
1.����� DOIVENT satisfaire aux exigences de conformit� d�finies dans la [RFC3995] pour une m�thode de livraison tir�e ;
2.����� DOIVENT prendre en charge l�op�ration Obtenir les notifications d�finie � la section 5, y compris le mode d�attente d��v�nement ;
3.����� DOIVENT prendre en charge les attributs d�objet Gabarit d�abonnement, comme d�fini � la section 6 ;
4.����� DOIVENT prendre en charge les attributs d�objet Description d�abonnement, comme d�fini � la section 7 ;
5.����� DOIVENT prendre en charge l�attribut de description d�imprimante "dur�e de vie d��v�nement ippget" d�fini au paragraphe 8.1, y compris de conserver les t�ches dans les phase R�tention de t�che et/ou Historique des t�ches pour au moins aussi longtemps que la valeur sp�cifi�e par le "dur�e de vie d��v�nement ippget" de l�imprimante ;
6.����� DOIVENT prendre en charge les valeurs suppl�mentaires des attributs de description d�imprimante IPP/1.1 d�finis dans la section 9 ;
7.����� DOIVENT prendre en charge le code d��tat 'r�ussite-ok, �v�nements termin�s', comme d�crit au paragraphe 10.1 ;
8.����� DOIVENT surveiller les demandes d�op�ration IPP Obtenir les notifications sur le port bien connu 631 allou� par l�IANA, sauf configuration explicite par les administrateurs du syst�me ou les politiques du site ;
9.����� NE DEVRAIT PAS surveiller les demandes d�op�ration IPP Obtenir les notifications sur tout autre port, sauf configuration explicite par les administrateurs du syst�me ou les politiques du site ; et
10.��� DOIVENT satisfaire aux exigences de conformit� � la s�curit� �tablies au paragraphe 18.4.
Il est FACULTATIF pour un client IPP de prendre en charge les notifications IPP telles que d�finies dans la [RFC3995]. Cependant, si un client prend en charge les notifications IPP, le client DOIT prendre en charge la m�thode de livraison �ippget� telle que d�finie dans le pr�sent document comme une de ses m�thodes de livraison. Les clients IPP qui se conforment � la pr�sente sp�cification :
1.����� DOIVENT cr�er des objets d�abonnement en envoyant des demandes d�op�ration de cr�ation d�abonnement contenant l�attribut "notifier la m�thode tir�e" (par opposition � l�attribut "notifier l�uri du r�cepteur") en utilisant la valeur de mot cl� 'ippget' (voir les paragraphes 6.1 et 15.2) ;
2.����� DOIT envoyer les demandes d�op�ration IPP Obtenir les notifications (voir le paragraphe 5.1) via le port sp�cifi� dans l�URL 'ipp' associ� (s�il est pr�sent) ou autrement le port bien connu 631 allou� par l�IANA ;
3.����� DOIT convertir les URL 'ipp' associ�s pour utilisation dans les op�rations IPP Obtenir les notifications en leurs formes correspondantes d�URL 'http' pour utilisation dans la couche http, conform�ment aux r�gles de la section 5, "Sch�ma d�URL IPP", de la [RFC2910] ; et
4.����� DOIT satisfaire aux exigences de conformit� � la s�curit� �tablies au paragraphe� 18.5.
[RFC2119]�� Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels" (Mots cl� � utiliser dans les RFC pour indiquer les niveaux d�exigence), BCP 14, RFC 2119, mars 1997.
[RFC2910]�� Herriot, R., Butler, S., Moore, P., Turner, R., et J. Wenn, "Internet Printing Protocol/1.1: Encoding and Transport" (Protocole /1.1 d�impression sur Internet : codage et transport), RFC 2910, septembre 2000.
[RFC2911]�� Hastings, T., Herriot, R., deBry, R., Isaacson, S., et P. Powell, "Internet Printing Protocol/1.1: Model and Semantics" (Protocole /1.1 d�impression sur Internet : mod�le et s�mantique), RFC 2911, septembre 2000.
[RFC3995]�� Herriot, R. and T. Hastings, "Internet Printing Protocol (IPP): Event Notifications and Subscriptions" (Protocole d�impression sur Internet (IPP) : notifications d��v�nement et abonnement), RFC 3995, mars 2005.
[RFC2565]�� Herriot, R., Butler, S., Moore, P., et R. Turner, "Internet Printing Protocol/1.0: Encoding and Transport" (Protocole /1.0 d�impression sur Internet : codage et transport), RFC 2565, avril 1999.
[RFC2566]�� deBry, R., Hastings, T., Herriot, R., Isaacson, S., and P. Powell, "Internet Printing Protocol/1.0: Model and Semantics" (Protocole /1.0 d�impression sur Internet : mod�le et s�mantique), RFC 2566, avril 1999.
[RFC2567]�� Wright, F., "Design Goals for an Internet Printing Protocol"(Objectifs de conception pour un protocole d�impression sur Internet), RFC 2567, avril 1999.
[RFC2568]�� Zilles, S., "Rationale for the Structure of the Model and Protocol for the Internet Printing Protocol" (Arguments pour la structure, le mod�le et le protocole du Protocole d�impression sur Internet), RFC 2568, avril 1999.
[RFC2569]�� Herriot, R., Hastings, T., Jacobs, N., and J. Martin, "Mapping between LPD and IPP Protocols" (Transposition entre les protocoles LPD et IPP), RFC 2569, avril 1999.
[RFC2616]�� Fielding,� R., Gettys, J., Mogul, J., Frystyk, H., Masinter, L., Leach, P., and T. Berners-Lee, "Hypertext Transfer Protocol -- HTTP/1.1" (Protocole de transfert hypertexte � HTTP/1.1), RFC 2616, juin 1999.
[RFC2707]�� Bergman, R., Hastings, T., Isaacson, S., and H. Lewis, "Job Monitoring MIB - V1.0" (MIB de surveillance de t�che � V1.0), RFC 2707, novembre 1999.
[RFC3196]�� Hastings, T., Manros, C., Zehler, P., Kugler, C., and H. Holst, "Internet Printing Protocol/1.1: Implementor's Guide" (Protocole /1.1 d�impression sur Internet : Guide de mise en oeuvre), RFC 3196, novembre 2001.
[RFC3997]�� Hastings, T., Ed., deBry, R., and H. Lewis, "Internet Printing Protocol (IPP): Requirements for IPP Notifications" (Protocole d�impression sur Internet (IPP)�: Exigences pour les notifications IPP), RFC 3997, mars 2005.
La pr�sente section contient les informations exactes que l�IANA a ajout� aux registres IPP conform�ment aux proc�dures d�finies � la section 6 de la [RFC2911]. Ces enregistrements ont �t� publi�s dans le registre http://www.iana.org/assignments/ipp-registrations.
Le tableau suivant fait la liste des attributs d�finis dans le pr�sent document. Cela a �t� enregistr� conform�ment aux proc�dures du paragraphe 6.2 de la RFC 2911 [RFC2911].
Attributs
de description d�imprimante |
R�f�rence |
Section |
ippget-event-life
(integer(15:MAX)) |
[RFC3996] |
8.1 |
La pr�sente section fait la listes des enregistrements de valeur d�attribut de mot cl� suppl�mentaires � utiliser avec les attributs existants d�finis dans d�autres documents. Ils ont �t� enregistr�s conform�ment aux proc�dures du paragraphe 6.1 de la [RFC2911]. Conform�ment au paragraphe 24.7.3 de la [RFC3995], les enregistrements de m�thode de livraison tir�e sont les enregistrements de valeur d�attribut de mot cl� pour les attributs "notifier la m�thode tir�e" et "notifier la m�thode tir�e prise en charge".
Valeurs
d�attribut (syntaxe d�attribut) |
R�f�rence |
Section |
notifier
la m�thode tir�e (mot cl� de type2) |
[RFC3995] |
5.3.2 |
notifier
la m�thode tir�e prise en charge (1setOf mot cl� de type2) |
[RFC3995] |
5.3.2.1 |
Ippget |
[RFC3996] |
9.1 |
Le tableau suivant fait la liste des valeurs d�attribut enum d�finies dans le pr�sent document. Celles-ci ont �t� enregistr�es conform�ment aux proc�dures du paragraphe 6.1 de la [RFC2911].
Valeur
de l�attribut (syntaxe d�attribut) ���������������������������������������������������
Nom de l�attribut |
R�f�rence |
Section |
op�rations�
prise en charge (1setOf �num�ration de type2) |
[RFC2911] |
4.4.15 |
0x001C�������������������������������������� Obtenir
les notifications |
[RFC3996] |
9.2 |
Le tableau suivant fait la liste des op�rations d�finies dans le pr�sent document. Cela a �t� enregistr� conform�ment aux proc�dures du paragraphe 6.4 de la RFC 2911 [RFC2911].
Op�rations: |
R�f�rence |
Section |
Obtenir
les notifications |
[RFC3996] |
5 |
Le tableau suivant fait la liste des codes d��tat d�finis dans le pr�sent document. Cela a �t� enregistr� conform�ment aux proc�dures du paragraphe 6.6 de la [RFC2911].
Codes
d��tat : |
R�f�rence |
Section |
r�ussite-ok,
�v�nements termin�s (0x0007) |
[RFC3996] |
10.1 |
L�imprimante IPP DOIT localiser l�attribut "notifier le texte" comme sp�cifi� � la section 14 de la [RFC3995].
De plus, lorsque le client re�oit la r�ponse � Obtenir les notifications, il est cens� localiser les attributs qui ont l�attribut 'mot cl�' conforme au charset et au langage naturel requis dans la demande Obtenir les notifications.
Le document Mod�le et s�mantique IPP [RFC2911, section 8] discute des exigences de s�curit� de haut niveau (authentification du client, authentification du serveur et confidentialit� du fonctionnement). Le document Transport et codage IPP [RFC2910, section 8] discute des exigences de s�curit� pour le protocole IPP. L�authentification du client est le m�canisme par lequel le client prouve son identit� au serveur d�une mani�re s�curis�e. L�authentification du serveur est le m�canisme par lequel le serveur prouve son identit� au client d�une mani�re s�curis�e. La confidentialit� du fonctionnement se d�finit comme un m�canisme pour la protection des op�rations contre l�espionnage.
La m�thode de livraison �ippget� avec ses op�rations Obtenir les notifications �l�ve les m�canismes de s�curit� qui sont utilis�s dans IPP/1.1 [RFC2910 et RFC2911] sans ajouter aucun m�canisme de s�curit� suppl�mentaire afin de maintenir la m�me prise en charge de la s�curit� que dans IPP/1.1.
Le mod�le de contr�le d�acc�s pour l�op�ration Obtenir les notifications d�finie dans le pr�sent document est le m�me que le mod�le de contr�le d�acc�s pour l�op�ration Obtenir les attributs de t�che (voir le paragraphe 3.2.6 de la [RFC2911]). La principale diff�rence est que l�op�ration Obtenir les notifications vise les objets d�abonnement plut�t que les objets t�che, et qu�un groupe d�attributs retourn� contient les attributs de notification d��v�nement plut�t que les attributs d�objet t�che.
Le client r�cepteur de notification DOIT avoir les droits d�acc�s suivants � l�objet d�abonnement vis� par la demande d�op�ration Obtenir les notifications :
L�utilisateur authentifi� (voir la paragraphe 8.3 de la [RFC2911]) effectuant cette op�ration DOIT �tre (1) le propri�taire de chaque objet d�abonnement identifi� par l�attribut d�op�ration "notifier les identifiants d�abonnement" (voir le paragraphe 5.1.1), (2) un op�rateur ou administrateur de l�imprimante (voir la section 1 et le paragraphe 8.5 de la [RFC2911]), ou (3) autrement autoris� par alla politique de s�curit� configur�e par l�administrateur de l�imprimante � demander des notifications d��v�nement � partir du ou des objets d�abonnement vis�s. De plus, la politique de s�curit� de l�imprimante PEUT limiter les attributs retourn�s par l�op�ration Obtenir les notifications, de fa�on similaire � celle de l�op�ration Obtenir les attributs de t�che (voir la [RFC2911], fin du paragraphe 3.3.4.2).
Parce que l�op�ration Obtenir les notifications est envoy�e dans la m�me direction que les op�rations Cr�ation de t�che, et g�n�ralement par le m�me client, cette m�thode de livraison de notification d��v�nement ne pose aucune question suppl�mentaire d�authentification, d�autorisation, de confidentialit�, de pare-feu, ou d�allocation de port en plus de celles des op�rations des attributs Obtenir les attributs de t�che et Obtenir les attributs d�imprimante d�IPP (voir les paragraphes 3.2.6 et 3.2.5 de la [RFC2911]).
Notifications d��v�nement non d�sir�es (spam) : � la diff�rence des m�thodes de livraisons pouss�es de notification d��v�nement dans lesquelles l�imprimante IPP prend l�initiative de la notification d��v�nement, avec la m�thode de livraison tir�e d�finie dans le pr�sent document, le r�cepteur de notification est le client qui initie l�op�ration Obtenir les notifications (voir la section 5). Donc, avec cette m�thode il n�y a aucun risque de notifications "spam".
Note : Lorsqu�un client reste connect� � une imprimante en utilisant le mode d�attente d��v�nement (voir le paragraphe section 5.1.3) afin de recevoir les notifications d��v�nement au fur et � mesure qu�elle surviennent, il peut fermer � tout moment la connexion IPP et ainsi �viter de futures notifications d��v�nement non d�sir�es.
Il es vrai que le client a le contr�le sur la demande des notifications d��v�nement. Cependant, si le client s�abonne � un �v�nement et fait une demande Obtenir les notifications, il obtient tous les �v�nements pour l�objet d�abonnement dans la gamme de num�ros de s�quence (voir le paragraphe 5.1.2), et non pas seulement ceux qu�il veut. Si un client s�abonne � un �v�nement de t�che d�abonnement par imprimante, tel que 't�che termin�e', et que quelqu�un commence alors et annule des milliers de t�ches, le client devra alors recevoir ces �v�nements en plus de ceux qui l�int�ressent. Un client peut se prot�ger mieux en s�abonnant � ses propres t�ches en utilisant un abonnement par t�che, plut�t que de cr�er un abonnement par imprimante dont les �v�nements de t�che s�appliquent � toutes les t�ches.
Pour l�op�ration Obtenir les notifications d�finie dans le pr�sent document, s�appliquent les m�mes exigences de s�curit� d�imprimante qui figurent � la section 8 de la [RFC2910] pour la prise en charge et l�utilisation de l�authentification de client, l�authentification du serveur le la confidentialit� du fonctionnement pour toutes les op�rations IPP.
Pour l�op�ration Obtenir les notifications d�finie dans le pr�sent document, s�appliquent les m�mes exigences de s�curit� de client qui figurent � la section 8 de la [RFC2910] pour la prise en charge et l�utilisation de l�authentification de client, l�authentification du serveur le la confidentialit� du fonctionnement pour toutes les op�rations IPP.
L�ensemble de base des documents IPP comporte :
Objectifs de conception pour un protocole d�impression sur Internet [RFC2567]
Fondements de la structure, mod�le et protocole du protocole d�impression sur Internet [RFC2568]
Protocole/1.1 d�impression sur Internet : Mod�le et s�mantique [RFC2911]
Protocole/1.1 d�impression sur Internet : Codage et transport [RFC2910]
Protocole/1.1 d�impression sur Internet : Guide de mise en �uvre [RFC3196]
Transposition entre les protocoles LPD et IPP [RFC2569]
Le document "Objectifs de conception pour un protocole d�impression sur Internet" porte un vaste regard sur la fonction d�impression distribu�e, et �num�re des sc�narios r�els qui aident � clarifier les caract�ristiques qu�il est n�cessaire d�inclure dans un protocole d�impression pour l�Internet. Il identifie les exigences pour trois types d�utilisateurs : utilisateur final, op�rateur, et administrateur. Il fait intervenir un sous ensemble d�exigences d�utilisateur final qui sont satisfaites dans IPP/1.0 [RFC2566, RFC2565]. Quelques op�rations d�op�rateur FACULTATIVES ont �t� ajout�es � IPP/1.1 [RFC2911, RFC2910].
Le document "Fondements de la structure, mod�le et protocole du protocole d�impression sur Internet" d�crit IPP d�un point de vue plus �lev� et d�finit la mission des divers documents qui forment la s�rie des documents de sp�cification d�IPP. Il donne les fondements des d�cisions majeures du groupe de travail IPP de l�ETF.
Le document "Protocole/1.1 d�impression sur Internet : Mod�le et s�mantique" d�crit un mod�le simplifi� avec des objets abstraits, leurs attributs, et leurs op�rations. Le mod�le introduit une imprimante et une t�che. La t�che prend en charge plusieurs documents par t�che. Le document mod�le traite aussi de la fa�on dont les questions de s�curit�, d�internationalisation, et d�annuaire sont trait�es.
Le document "Protocole/1.1 d�impression sur Internet : Codage et transport" est une transposition formelle des op�rations abstraites et des attributs d�finis dans le document mod�le sur HTTP/1.1 [RFC2616]. Il d�finit aussi les r�gles de codage pour un nouveau type de support MIME Internet appel� "application/ipp". Ce document d�finit aussi les r�gles de transport sur HTTP d�un corps de message dont le type de contenu est "application/ipp". Ce document d�finit le sch�ma 'ipp' pour l�identification des imprimantes et des t�ches IPP.
Le document "Protocole/1.1 d�impression sur Internet : Guide de mise en oeuvre" donne des directives et conseils pour la mise en �uvre de clients et objets IPP. Il est destin� � les aider � comprendre IPP/1.1 et � fournir des consid�rations propres � les assister dans la conception de leurs mises en �uvre de client et/ou objet IPP. Par exemple, il donne un ordre de traitement normal d�une demande, avec la v�rification d�erreur. Les motifs de certaines d�cisions de la sp�cification y figurent aussi.
Le document "Transposition entre protocoles LPD et IPP" donne quelques conseils � ceux qui mettent en �uvre des passerelles entre des mises en oeuvre IPP et LPD (Line Printer Daemon).
Carl Kugler et Harry Lewis ont contribu� � l�id�e de base d�une "interrogation intelligente" dans la bande coupl�e � des r�ponses multiples pour une seule op�ration sur la m�me connexion, avec une r�ponse pour chaque �v�nement d�s qu�il survient. Sans leur persuasion et leur pers�v�rance, nous ne serions pas arriv�s � cette sp�cification de m�thode de livraison et n�aurions pas �t� capables de nous mettre d�accord sur une seule m�thode de livraison EXIG�E pour IPP.
Carl Kugler
IBM Corporation
6300 Diagonal Highway
Boulder, CO 80301
m�l : kugler@us.ibm.com
Adresse des auteurs
Robert Herriot |
Tomas Hastings |
Harry Lewis |
Global Workflow Solutions |
Xerox Corporation |
IBM Corporation |
706 Colorado Ave. |
701 S Aviation Blvd, ESAE 242 |
6300 Diagonal Hwy |
Palo Alto, CA 94303 |
El Segundo, CA� 90245 |
Boulder, CO 80301 |
t�l :� 650-324-4000 |
t�l ::
310-333-6413 |
t�l :: (303)
924-5337 |
m�l:� bob@herriot.com |
M�l: hastings@cp10.es.xerox.com |
email: harryl@us.ibm.com |
D�claration de copyright
Copyright (C) The Internet Society (2005).
Le pr�sent document est soumis aux droits, licences et restrictions contenus dans le BCP 78, et � www.rfc-editor.org, et sauf pour ce qui est mentionn� ci-apr�s, les auteurs conservent tous leurs droits.
Le pr�sent document et les informations y contenues sont fournies sur une base "EN L��TAT" et LE CONTRIBUTEUR, L�ORGANISATION QU�IL OU ELLE REPR�SENTE OU QUI LE/LA FINANCE (S�IL EN EST), LA INTERNET SOCIETY ET LA INTERNET ENGINEERING TASK FORCE D�CLINENT TOUTES GARANTIES, EXPRIM�ES OU IMPLICITES, Y COMPRIS MAIS NON LIMIT�ES � TOUTE GARANTIE QUE L�UTILISATION DES INFORMATIONS CI-ENCLOSES NE VIOLENT AUCUN DROIT OU AUCUNE GARANTIE IMPLICITE DE COMMERCIALISATION OU D�APTITUDE � UN OBJET PARTICULIER.
Propri�t� intellectuelle
L�IETF ne prend pas position sur la validit� et la port�e de tout droit de propri�t� intellectuelle ou autres droits qui pourrait �tre revendiqu�s au titre de la mise en �uvre ou l�utilisation de la technologie d�crite dans le pr�sent document ou sur la mesure dans laquelle toute licence sur de tels droits pourrait �tre ou n��tre pas disponible ; pas plus qu�elle ne pr�tend avoir accompli aucun effort pour identifier de tels droits. Les informations sur les proc�dures de l�ISOC au sujet des droits dans les documents de l�ISOC figurent dans les BCP 78 et BCP 79.
Des copies des d�p�ts d�IPR faites au secr�tariat de l�IETF et toutes assurances de disponibilit� de licences, ou le r�sultat de tentatives faites pour obtenir une licence ou permission g�n�rale d�utilisation de tels droits de propri�t� par ceux qui mettent en �uvre ou utilisent la pr�sente sp�cification peuvent �tre obtenues sur r�pertoire en ligne des IPR de l�IETF � http://www.ietf.org/ipr.
L�IETF invite toute partie int�ress�e � porter son attention sur tous copyrights, licences ou applications de licence, ou autres droits de propri�t� qui pourraient couvrir les technologies qui peuvent �tre n�cessaires pour mettre en �uvre la pr�sente norme. Pri�re d�adresser les informations � l�IETF � ietf- ipr@ietf.org.
Remerciement
Le financement de la fonction d��dition des RFC est actuellement fourni par Internet Society.