[IPP] Documentation for "How to use the Internet Printing Protocol"

John Madden via ipp <ipp@pwg.org> Thu, 29 February 2024 01:31 UTC

Return-Path: <ipp-bounces@pwg.org>
X-Original-To: ietfarch-ipp-archive@ietfa.amsl.com
Delivered-To: ietfarch-ipp-archive@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id B0E0AC14F71F for <ietfarch-ipp-archive@ietfa.amsl.com>; Wed, 28 Feb 2024 17:31:10 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -3.005
X-Spam-Level:
X-Spam-Status: No, score=-3.005 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FORGED_MSGID_YAHOO=0.1, HTML_MESSAGE=0.001, MAILING_LIST_MULTI=-1, RCVD_IN_ZEN_BLOCKED_OPENDNS=0.001, SPF_HELO_FAIL=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01, URIBL_BLOCKED=0.001, URIBL_DBL_BLOCKED_OPENDNS=0.001, URIBL_ZEN_BLOCKED_OPENDNS=0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (1024-bit key) header.d=pwg.org header.b="ktXeTrsi"; dkim=pass (1024-bit key) header.d=pwg.org header.b="tgBErfks"; dkim=fail (2048-bit key) reason="fail (message has been altered)" header.d=yahoo.com header.b="MBXNrLw1"
Received: from mail.ietf.org ([50.223.129.194]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id MnX0sBX7Ej1E for <ietfarch-ipp-archive@ietfa.amsl.com>; Wed, 28 Feb 2024 17:31:06 -0800 (PST)
Received: from mail.pwg.org (mail.pwg.org [172.104.19.21]) by ietfa.amsl.com (Postfix) with ESMTP id B5E51C151066 for <ipp-archive2@ietf.org>; Wed, 28 Feb 2024 17:30:32 -0800 (PST)
Received: by mail.pwg.org (Postfix, from userid 1002) id C9B273EF5; Thu, 29 Feb 2024 01:30:31 +0000 (UTC)
DKIM-Filter: OpenDKIM Filter v2.11.0 mail.pwg.org C9B273EF5
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=pwg.org; s=default; t=1709170231; bh=RUEs5y3h9oPElC2mpprsnIiizF2W0F1MeCAqAd82Q+0=; h=Date:To:References:Subject:List-Id:List-Unsubscribe:List-Archive: List-Post:List-Help:List-Subscribe:From:Reply-To:Cc:From; b=ktXeTrsisXv/bRRaYbU+h+zrnhQa4l+/vOyuGM0LF+j1vHkahLmSaMjpgOc3ApVkD kJK38hP9uJuZLZ+mxUpyGSswIMAARwHV5BOE/NXFVpvApDeh5Q0Szb0PVSPHdAV4wA Fa4aVX+Id3IM6+UHaSbgO+BIJt32ut68pRgfFmdE=
Received: from mail.pwg.org (localhost [IPv6:::1]) by mail.pwg.org (Postfix) with ESMTP id 0AF2238D; Thu, 29 Feb 2024 01:30:30 +0000 (UTC)
DKIM-Filter: OpenDKIM Filter v2.11.0 mail.pwg.org 0AF2238D
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=pwg.org; s=default; t=1709170230; bh=RUEs5y3h9oPElC2mpprsnIiizF2W0F1MeCAqAd82Q+0=; h=Date:To:References:Subject:List-Id:List-Unsubscribe:List-Archive: List-Post:List-Help:List-Subscribe:From:Reply-To:Cc:From; b=tgBErfks1uGsrFyK41KCLoOUhPy+HAg4ro/fCPky3uDwmuH23YNELdjhRcYz5iKfL vPkmauGvlaV7UuHzbCnIY18himHaco9dCxBscsqg/IsX7gj/JWQ/UQbfk8bk9Iy6Ou Vq6rNvxNjPNcVVrQEcsTCPkAszSM2dKJF/AjVDFY=
X-Original-To: ipp@pwg.org
Delivered-To: ipp@pwg.org
Received: by mail.pwg.org (Postfix, from userid 1002) id 0CCBE3A8F; Thu, 29 Feb 2024 01:30:28 +0000 (UTC)
DKIM-Filter: OpenDKIM Filter v2.11.0 mail.pwg.org 0CCBE3A8F
Authentication-Results: mail.pwg.org; dkim=pass (2048-bit key) header.d=yahoo.com header.i=@yahoo.com header.b="MBXNrLw1"
Received: from sonic306-22.consmr.mail.ne1.yahoo.com (sonic306-22.consmr.mail.ne1.yahoo.com [66.163.189.84]) by mail.pwg.org (Postfix) with ESMTPS id DB12238D for <ipp@pwg.org>; Thu, 29 Feb 2024 01:30:24 +0000 (UTC)
DKIM-Filter: OpenDKIM Filter v2.11.0 mail.pwg.org DB12238D
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yahoo.com; s=s2048; t=1709170222; bh=eP44pYnYEvTEpszpFUYxmcKckT81QR47AdrW2y/2rXg=; h=Date:To:From:Subject:References:From:Subject:Reply-To; b=MBXNrLw19PY7Z7AYwnYh3cNmHLKVvfYAqdDFdZXOo59p2GA58rVENDX+ICF9/rEdMeDOfUdcvSOSDqtzDsR5RqgEll9gil13ESr6GI93d8Kf/MSIGaIpvwrww/LuQdZFdDJdq0LCNwEq561N0T2nuHy9pnwt9DCpf5BxgLhWqNGDddT2pVNH1YwMe24stpZTPVbPmcXktryDxa9xNQlHnF1Q2WMDJYy7SuMx8IK+da8RJVeDNTjpsJYK+YbU+Kca1sHggdRT/QOu2xo0CAVzYu0fbzGQeqDhlyUNcqZBlqQI52JF7xS9WPbaJTqyqIth4R0RQuXrt1zrZy6fbC6VPw==
X-SONIC-DKIM-SIGN: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yahoo.com; s=s2048; t=1709170222; bh=hKuGvhPA4WwzJNsdXr10gDsbjafOCnONf2w062xo+Hp=; h=X-Sonic-MF:Date:To:From:Subject:From:Subject; b=QZhLwayQYBs5dHn6lbUMyg5fMwtTeKn8w1ZByBCftaeXOPQ9AgayXDhhU1UnUgfKxTwpJtSVM9MCkKz3NPRk0J9TyG8t8YJZ0lSpX0Kf9vrTEkOAAxKlfDkb8z6BcORDqMPg/n7Y1x+PQAFph6N7C06MOo+gFOvfBPswN7qJzigULQIsNP9BCaA+o/WWA5z32RKF5TFAp1Yww8xI19NtYov6RfE8jjl50Nad5F42gQ4ImBcwh3FU2pMtT5+++Imriv261d2TCgA+Q+FTIpv9p9AuNDvFghJpRX4dZz2jM2QceDhl4OmFO2X98/HHB3PXWb95WGdDSXjcLU4Jd1QX3w==
X-YMail-OSG: aZ0cvKwVM1l5lw7Xu.TjeNMWfvai6N9Oac921LZQwq7yyfMmdoYnanqEV.Uev87 9Mv2_lo7aQasdZHJwzl.lcays6WHNnCZ3wwr4H6KIjTQBW4l7YuM0CI9zoseH2b0gMFx5F5E4g0r CIiLgiLXcdPf7ngJZ3GpbD_8kGIC_MTvP5.99dUgDnFEFzq2kgE8AFrON1jWZu95vZnQxgLCk_dy rWIh3nPlJhbePV1_Pdp3_UeNBPgk0a8Vu9Tai0YtIHb5B9wtWcJcpTPXmumQMDFnFQqHJ7bEfobX BDIBwaTppqYhJk53MOckIOG5LEYrNDi_db8HQe1RM8oJnDzvpiJ1Ucjosvw3M7fbhnWv4.fosJaH ezQQcOUmVhdJPGypzX6nmr7mBI1BeFjKuot2lEf3kAcGhoLepHzf6VhPtPEcuoWZSlpC8uFc_QKr ScO1wauziOYBUB9t4YtxUiUO2OW97DGNlHIWovyk3PAzfKGA6euk4AB.hfUPoP8LroZEU3qnFdIa F1QeT3UwST4Up85dIcnXkWebqfJDi_b.0FPh7S17CW.xBnqQXGeozcjelWnUynkJXEUdIi_IEpWw WZYSn25vQ4B9qOXKjOr5uODKqwGh79ClU.2xIxX.flqRdfrL6LoiK0UjGF5JkuUYyf6XA3Ar_IpZ I17hRCrYCEKI1HI1lo3NgQAM0R4bHD9r7JV_EDVygeTZ_Ot5R.K5ipJeo0cWsvCyCJSmGgvFpoJE GkcK5kZMKVkx5w_ouTZ7dPXcTDZS2qdflQMK9uvkvNtNw1eLS19e01wlZwldPjnH8LwaPvJvpffU TpRKiP1LtGoAlilnKnOhgB0mfKi_xZ2MSZNiMP7AlLC6I.FCA7zGpCNdz1GcyIEBLxIxDw6JWMRs iKIP8Awu0Q4g2YgRC3gs.9w.yN1JBsizlDFkrmyuTqUreZRwGZ82O0Iv251EViTaaPwLRXqfz7.i KYbvmu5JZc_xxVDH3c4Z6ovl9thcBNyZqCnOGeaCrGxkEu.XeWkUIPDiKBDO1LFdtkb2fROYyUM1 lF48dxm4oPeJmFN3TTdZnaFVnry4EGQCYJxJVpFrHKoK_M41e.cKmY.XOVkABqeDfnIzE61YREoY Fg5E6O.SB4W2ZsVwj.6WG2eBV6PTLALIgzs3pkkQI0ARvEtjAvubPbo230Sd3PYlXjjQ5hY8wCCc 5_Z6am3lfXS_moIIyYI8NXNNxML5gz9yN9oZHd27D9F1VgBMuogpwcmJbK1AIgyhGp5gF5ZhaUmg WneR.44nQQtzDX.IXOvdy4rlQT_xt6D3rWGpTfGk7UJpgmEMyUkM8fisDLUvvCfxSMhSZRC5u6e0 EUAjMl5vXV9N8cBpxOtnCeRggdSgf.svX3z0Xt.H0Vdj5yJO9x0zgSUSaJf.BMCtji7uRlFPQSN0 J9eJH1XX0w7OzjqJGmRuf0cXqj2laPgsjPAk6iIb9si_rKRspdGBspClLqT_As1vxyxyPzjxYeR6 2cSupnoPPM2a0lHyDtIBdrnhuvgeABHT9eALoDXemfzsTyJkeksAk4sjHdUVMK5NunperJD9vIHJ Pw8M0MxFTSBL54jzLcol0zLjT282_herWUL6S4hFCcb6eFtIClBuFs8mLz1yvd6GbMY6qpF4gfWj NQ.Ia3kHnMagiP4VAm.d.6aUtMg7XUwCn1UxCUcrKmiuabGnbJnHCWLBHrVSBBx6tIjs6dIw6gjI eVXJ0nBuSgmfNjccNlNSqquXudtnixaxYgftdG2aBqhhdJ3yeQYYMGV6HYIAcUE3.XIuBK9UfJRC PTPTxzotfikQunIWKirwSCedacfRJK97Er13taKKG6PuTxHnOYuQsByynTG1Bfc.PYEP950q4.XD QyDocj9lcxtuyysvqi7TrhVTrZskz7JMcuGh3Qx823BQ7BQyXg0o06V3V6Wdv4gQOSI00YMJUg38 pKdiixx5ka8OJaIAJS.U2_rl_RPLuf1vL8ypfGHy0qs_P2VBsqasD4frJx0nhcZapa.VAx6LKwFA GB6ELKmE82cBuPMl.PE0HQXsR.RG6YvOd4SYL9BrGktr3dA3lcGajUArbyWeyEhFyGKxa0Y7lyNA YGhXgoFvfhyiUsL5Q7KTzz5BMj_4soMotthSLFR99VMjgBYT6IMYOiLxJ9qnUGmK0Aw4IP6sELs_ 5xC_0.uWj6KQiHKjtPlBGz4UuRLW4oyA1eVnJG4etDBq3q0Uc5TzhQW7l14KMLCW_qv5RiZw0Svi 2gEePXIYPpjS_S977H_WkDGdnU09PDQXjCmKsKJs_WNmy1ZEbUqvp2QVQGfbFTmtz
X-Sonic-MF: <jpmsparks@yahoo.com>
X-Sonic-ID: c955f480-fffd-44cd-92f8-0ac6ea81a06a
Received: from sonic.gate.mail.ne1.yahoo.com by sonic306.consmr.mail.ne1.yahoo.com with HTTP; Thu, 29 Feb 2024 01:30:22 +0000
Received: by hermes--production-bf1-7d6dbd57c9-xvhsj (Yahoo Inc. Hermes SMTP Server) with ESMTPA ID a075539cdd40698c5ddba225b8bf1482; Thu, 29 Feb 2024 01:30:17 +0000 (UTC)
Message-ID: <85019096-827b-47ba-9dbb-a3f60640018d@yahoo.com>
Date: Wed, 28 Feb 2024 20:30:13 -0500
MIME-Version: 1.0
User-Agent: Mozilla Thunderbird
Content-Language: en-US
To: ipp@pwg.org
References: <85019096-827b-47ba-9dbb-a3f60640018d.ref@yahoo.com>
X-Mailer: WebService/1.1.22103 mail.backend.jedi.jws.acl:role.jedi.acl.token.atz.jws.hermes.yahoo
Subject: [IPP] Documentation for "How to use the Internet Printing Protocol"
X-BeenThere: ipp@pwg.org
X-Mailman-Version: 2.1.39
Precedence: list
List-Id: ISTO-PWG Internet Printing Protocol workgroup discussion forum <ipp.pwg.org>
List-Unsubscribe: <https://www.pwg.org/mailman/options/ipp>, <mailto:ipp-request@pwg.org?subject=unsubscribe>
List-Archive: <http://www.pwg.org/pipermail/ipp/>
List-Post: <mailto:ipp@pwg.org>
List-Help: <mailto:ipp-request@pwg.org?subject=help>
List-Subscribe: <https://www.pwg.org/mailman/listinfo/ipp>, <mailto:ipp-request@pwg.org?subject=subscribe>
From: John Madden via ipp <ipp@pwg.org>
Reply-To: ISTO-PWG Internet Printing Protocol workgroup discussion forum <ipp@pwg.org>
Cc: John Madden <jpmsparks@yahoo.com>
Content-Type: multipart/mixed; boundary="===============1182415495521290993=="
Errors-To: ipp-bounces@pwg.org
Sender: ipp <ipp-bounces@pwg.org>

Looks like the example for the CREATE-JOB, SEND-DOCUMENT code needs to 
be updated in the “How to Use the Internet Printing Protocol” document. 
Kept getting a 1024 error codeusing cupsDoFileRequest - I had to use the 
"last-document" boolean to the SEND_DOCUMENT op before it finally 
worked. Appears the *last-document* boolean is required. The 
*last-document* attribute does not appear as a required attribute in the 
Common Operations section of the document in Appendix A either.

//****code below****

request = ippNewRequest(IPP_OP_SEND_DOCUMENT);
status = ippGetStatusCode(request);
if ((status == IPP_STATUS_OK)||(status == 
IPP_STATUS_OK_BUT_CANCEL_SUBSCRIPTION))
{
ippAddInteger(request, IPP_TAG_OPERATION, IPP_TAG_INTEGER, "job-id", 
iJobId);
ippAddString(request, IPP_TAG_OPERATION, IPP_TAG_URI, "printer-uri", 
NULL, szUriTag);
ippAddString(request, IPP_TAG_OPERATION, IPP_TAG_NAME, 
"requesting-user-name", NULL, userName);
ippAddString(request, IPP_TAG_OPERATION, IPP_TAG_MIMETYPE, 
"document-format", NULL, getMimeType(filetoPrint));
//must include the 'last-document' op or this will fail..
**ippAddBoolean(request, IPP_TAG_OPERATION, "last-document", 1);**
response = cupsDoFileRequest(http, request, "/ipp/print", filetoPrint);
status = ippGetStatusCode(response);

|||if (response)|
|||{|
|||ippDelete(response);|
|||}|
|}|

|//**** ||end code ****|

Also, could you add a code example for the Cancel-Job (with a job ID)? I 
am following the guidelines for required attributes (Appendix A) but get 
a 1024 for this op as well. Thanks for the great work!
_______________________________________________
ipp mailing list
ipp@pwg.org
https://www.pwg.org/mailman/listinfo/ipp