[thirdparty/cups.git] / cups / dest-job.c

/*
 * Destination job support for CUPS.
 *
 * Copyright 2012-2016 by Apple Inc.
 *
 * These coded instructions, statements, and computer programs are the
 * property of Apple Inc. and are protected by Federal copyright
 * law.  Distribution and use rights are outlined in the file "LICENSE.txt"
 * which should have been included with this file.  If this file is
 * file is missing or damaged, see the license at "http://www.cups.org/".
 *
 * This file is subject to the Apple OS-Developed Software exception.
 */

/*
 * Include necessary headers...
 */

#include "cups-private.h"


/*
 * 'cupsCancelDestJob()' - Cancel a job on a destination.
 *
 * The "job_id" is the number returned by cupsCreateDestJob.
 *
 * Returns @code IPP_STATUS_OK@ on success and
 * @code IPP_STATUS_ERRPR_NOT_AUTHORIZED@ or
 * @code IPP_STATUS_ERROR_FORBIDDEN@ on failure.
 *
 * @since CUPS 1.6/OS X 10.8@
 */

ipp_status_t
cupsCancelDestJob(http_t      *http,	/* I - Connection to destination */
                  cups_dest_t *dest,	/* I - Destination */
                  int         job_id)	/* I - Job ID */
{
  cups_dinfo_t	*info;			/* Destination information */


  if ((info = cupsCopyDestInfo(http, dest)) != NULL)
  {
    ipp_t	*request;		/* Cancel-Job request */

    request = ippNewRequest(IPP_OP_CANCEL_JOB);

    ippSetVersion(request, info->version / 10, info->version % 10);

    ippAddString(request, IPP_TAG_OPERATION, IPP_TAG_URI, "printer-uri", NULL, info->uri);
    ippAddInteger(request, IPP_TAG_OPERATION, IPP_TAG_INTEGER, "job-id", job_id);
    ippAddString(request, IPP_TAG_OPERATION, IPP_TAG_NAME, "requesting-user-name", NULL, cupsUser());

    ippDelete(cupsDoRequest(http, request, info->resource));
    cupsFreeDestInfo(info);
  }

  return (cupsLastError());
}


/*
 * 'cupsCloseDestJob()' - Close a job and start printing.
 *
 * Use when the last call to cupsStartDocument passed 0 for "last_document".
 * "job_id" is the job ID returned by cupsCreateDestJob. Returns @code IPP_STATUS_OK@
 * on success.
 *
 * @since CUPS 1.6/OS X 10.8@
 */

ipp_status_t				/* O - IPP status code */
cupsCloseDestJob(
    http_t       *http,			/* I - Connection to destination */
    cups_dest_t  *dest,			/* I - Destination */
    cups_dinfo_t *info, 		/* I - Destination information */
    int          job_id)		/* I - Job ID */
{
  int			i;		/* Looping var */
  ipp_t			*request = NULL;/* Close-Job/Send-Document request */
  ipp_attribute_t	*attr;		/* operations-supported attribute */


  DEBUG_printf(("cupsCloseDestJob(http=%p, dest=%p(%s/%s), info=%p, job_id=%d)",
                http, dest, dest ? dest->name : NULL,
                dest ? dest->instance : NULL, info, job_id));

 /*
  * Range check input...
  */

  if (!http || !dest || !info || job_id <= 0)
  {
    _cupsSetError(IPP_STATUS_ERROR_INTERNAL, strerror(EINVAL), 0);
    DEBUG_puts("1cupsCloseDestJob: Bad arguments.");
    return (IPP_STATUS_ERROR_INTERNAL);
  }

 /*
  * Build a Close-Job or empty Send-Document request...
  */

  if ((attr = ippFindAttribute(info->attrs, "operations-supported",
                               IPP_TAG_ENUM)) != NULL)
  {
    for (i = 0; i < attr->num_values; i ++)
      if (attr->values[i].integer == IPP_OP_CLOSE_JOB)
      {
        request = ippNewRequest(IPP_OP_CLOSE_JOB);
        break;
      }
  }

  if (!request)
    request = ippNewRequest(IPP_OP_SEND_DOCUMENT);

  if (!request)
  {
    _cupsSetError(IPP_STATUS_ERROR_INTERNAL, strerror(ENOMEM), 0);
    DEBUG_puts("1cupsCloseDestJob: Unable to create Close-Job/Send-Document "
               "request.");
    return (IPP_STATUS_ERROR_INTERNAL);
  }

  ippSetVersion(request, info->version / 10, info->version % 10);

  ippAddString(request, IPP_TAG_OPERATION, IPP_TAG_URI, "printer-uri",
               NULL, info->uri);
  ippAddInteger(request, IPP_TAG_OPERATION, IPP_TAG_INTEGER, "job-id",
                job_id);
  ippAddString(request, IPP_TAG_OPERATION, IPP_TAG_NAME, "requesting-user-name",
               NULL, cupsUser());
  if (ippGetOperation(request) == IPP_OP_SEND_DOCUMENT)
    ippAddBoolean(request, IPP_TAG_OPERATION, "last-document", 1);

 /*
  * Send the request and return the status...
  */

  ippDelete(cupsDoRequest(http, request, info->resource));

  DEBUG_printf(("1cupsCloseDestJob: %s (%s)", ippErrorString(cupsLastError()),
                cupsLastErrorString()));

  return (cupsLastError());
}


/*
 * 'cupsCreateDestJob()' - Create a job on a destination.
 *
 * Returns @code IPP_STATUS_OK@ or @code IPP_STATUS_OK_SUBST@ on success, saving the job ID
 * in the variable pointed to by "job_id".
 *
 * @since CUPS 1.6/OS X 10.8@
 */

ipp_status_t				/* O - IPP status code */
cupsCreateDestJob(
    http_t        *http,		/* I - Connection to destination */
    cups_dest_t   *dest,		/* I - Destination */
    cups_dinfo_t  *info, 		/* I - Destination information */
    int           *job_id,		/* O - Job ID or 0 on error */
    const char    *title,		/* I - Job name */
    int           num_options,		/* I - Number of job options */
    cups_option_t *options)		/* I - Job options */
{
  ipp_t			*request,	/* Create-Job request */
			*response;	/* Create-Job response */
  ipp_attribute_t	*attr;		/* job-id attribute */


  DEBUG_printf(("cupsCreateDestJob(http=%p, dest=%p(%s/%s), info=%p, "
                "job_id=%p, title=\"%s\", num_options=%d, options=%p)",
                http, dest, dest ? dest->name : NULL,
                dest ? dest->instance : NULL, info, job_id, title, num_options,
                options));

 /*
  * Range check input...
  */

  if (job_id)
    *job_id = 0;

  if (!http || !dest || !info || !job_id)
  {
    _cupsSetError(IPP_STATUS_ERROR_INTERNAL, strerror(EINVAL), 0);
    DEBUG_puts("1cupsCreateDestJob: Bad arguments.");
    return (IPP_STATUS_ERROR_INTERNAL);
  }

 /*
  * Build a Create-Job request...
  */

  if ((request = ippNewRequest(IPP_OP_CREATE_JOB)) == NULL)
  {
    _cupsSetError(IPP_STATUS_ERROR_INTERNAL, strerror(ENOMEM), 0);
    DEBUG_puts("1cupsCreateDestJob: Unable to create Create-Job request.");
    return (IPP_STATUS_ERROR_INTERNAL);
  }

  ippSetVersion(request, info->version / 10, info->version % 10);

  ippAddString(request, IPP_TAG_OPERATION, IPP_TAG_URI, "printer-uri",
               NULL, info->uri);
  ippAddString(request, IPP_TAG_OPERATION, IPP_TAG_NAME, "requesting-user-name",
               NULL, cupsUser());
  if (title)
    ippAddString(request, IPP_TAG_OPERATION, IPP_TAG_NAME, "job-name", NULL,
                 title);

  cupsEncodeOptions2(request, num_options, options, IPP_TAG_OPERATION);
  cupsEncodeOptions2(request, num_options, options, IPP_TAG_JOB);
  cupsEncodeOptions2(request, num_options, options, IPP_TAG_SUBSCRIPTION);

 /*
  * Send the request and get the job-id...
  */

  response = cupsDoRequest(http, request, info->resource);

  if ((attr = ippFindAttribute(response, "job-id", IPP_TAG_INTEGER)) != NULL)
  {
    *job_id = attr->values[0].integer;
    DEBUG_printf(("1cupsCreateDestJob: job-id=%d", *job_id));
  }

  ippDelete(response);

 /*
  * Return the status code from the Create-Job request...
  */

  DEBUG_printf(("1cupsCreateDestJob: %s (%s)", ippErrorString(cupsLastError()),
                cupsLastErrorString()));

  return (cupsLastError());
}


/*
 * 'cupsFinishDestDocument()' - Finish the current document.
 *
 * Returns @code IPP_STATUS_OK@ or @code IPP_STATUS_OK_SUBST@ on success.
 *
 * @since CUPS 1.6/OS X 10.8@
 */

ipp_status_t				/* O - Status of document submission */
cupsFinishDestDocument(
    http_t       *http,			/* I - Connection to destination */
    cups_dest_t  *dest,			/* I - Destination */
    cups_dinfo_t *info) 		/* I - Destination information */
{
  DEBUG_printf(("cupsFinishDestDocument(http=%p, dest=%p(%s/%s), info=%p)",
                http, dest, dest ? dest->name : NULL,
                dest ? dest->instance : NULL, info));

 /*
  * Range check input...
  */

  if (!http || !dest || !info)
  {
    _cupsSetError(IPP_STATUS_ERROR_INTERNAL, strerror(EINVAL), 0);
    DEBUG_puts("1cupsFinishDestDocument: Bad arguments.");
    return (IPP_STATUS_ERROR_INTERNAL);
  }

 /*
  * Get the response at the end of the document and return it...
  */

  ippDelete(cupsGetResponse(http, info->resource));

  DEBUG_printf(("1cupsFinishDestDocument: %s (%s)",
                ippErrorString(cupsLastError()), cupsLastErrorString()));

  return (cupsLastError());
}


/*
 * 'cupsStartDestDocument()' - Start a new document.
 *
 * "job_id" is the job ID returned by cupsCreateDestJob.  "docname" is the name
 * of the document/file being printed, "format" is the MIME media type for the
 * document (see CUPS_FORMAT_xxx constants), and "num_options" and "options"
 * are the options do be applied to the document. "last_document" should be 1
 * if this is the last document to be submitted in the job.  Returns
 * @code HTTP_CONTINUE@ on success.
 *
 * @since CUPS 1.6/OS X 10.8@
 */

http_status_t				/* O - Status of document creation */
cupsStartDestDocument(
    http_t        *http,		/* I - Connection to destination */
    cups_dest_t   *dest,		/* I - Destination */
    cups_dinfo_t  *info, 		/* I - Destination information */
    int           job_id,		/* I - Job ID */
    const char    *docname,		/* I - Document name */
    const char    *format,		/* I - Document format */
    int           num_options,		/* I - Number of document options */
    cups_option_t *options,		/* I - Document options */
    int           last_document)	/* I - 1 if this is the last document */
{
  ipp_t		*request;		/* Send-Document request */
  http_status_t	status;			/* HTTP status */


  DEBUG_printf(("cupsStartDestDocument(http=%p, dest=%p(%s/%s), info=%p, "
                "job_id=%d, docname=\"%s\", format=\"%s\", num_options=%d, "
                "options=%p, last_document=%d)",
                http, dest, dest ? dest->name : NULL,
                dest ? dest->instance : NULL, info, job_id, docname, format,
                num_options, options, last_document));

 /*
  * Range check input...
  */

  if (!http || !dest || !info || job_id <= 0)
  {
    _cupsSetError(IPP_STATUS_ERROR_INTERNAL, strerror(EINVAL), 0);
    DEBUG_puts("1cupsStartDestDocument: Bad arguments.");
    return (HTTP_STATUS_ERROR);
  }

 /*
  * Create a Send-Document request...
  */

  if ((request = ippNewRequest(IPP_OP_SEND_DOCUMENT)) == NULL)
  {
    _cupsSetError(IPP_STATUS_ERROR_INTERNAL, strerror(ENOMEM), 0);
    DEBUG_puts("1cupsStartDestDocument: Unable to create Send-Document "
               "request.");
    return (HTTP_STATUS_ERROR);
  }

  ippSetVersion(request, info->version / 10, info->version % 10);

  ippAddString(request, IPP_TAG_OPERATION, IPP_TAG_URI, "printer-uri",
               NULL, info->uri);
  ippAddInteger(request, IPP_TAG_OPERATION, IPP_TAG_INTEGER, "job-id", job_id);
  ippAddString(request, IPP_TAG_OPERATION, IPP_TAG_NAME, "requesting-user-name",
               NULL, cupsUser());
  if (docname)
    ippAddString(request, IPP_TAG_OPERATION, IPP_TAG_NAME, "document-name",
                 NULL, docname);
  if (format)
    ippAddString(request, IPP_TAG_OPERATION, IPP_TAG_MIMETYPE,
                 "document-format", NULL, format);
  ippAddBoolean(request, IPP_TAG_OPERATION, "last-document", (char)last_document);

  cupsEncodeOptions2(request, num_options, options, IPP_TAG_OPERATION);
  cupsEncodeOptions2(request, num_options, options, IPP_TAG_DOCUMENT);

 /*
  * Send and delete the request, then return the status...
  */

  status = cupsSendRequest(http, request, info->resource, CUPS_LENGTH_VARIABLE);

  ippDelete(request);

  return (status);
}
Commit	Line	Data
dcb445bc	1	/*
7e86f2f6	2	* Destination job support for CUPS.
dcb445bc	3	*
46385a1a	4	* Copyright 2012-2016 by Apple Inc.
dcb445bc	5	*
7e86f2f6 MS	6	* These coded instructions, statements, and computer programs are the
	7	* property of Apple Inc. and are protected by Federal copyright
	8	* law. Distribution and use rights are outlined in the file "LICENSE.txt"
	9	* which should have been included with this file. If this file is
	10	* file is missing or damaged, see the license at "http://www.cups.org/".
dcb445bc	11	*
7e86f2f6	12	* This file is subject to the Apple OS-Developed Software exception.
dcb445bc MS	13	*/
	14
	15	/*
	16	* Include necessary headers...
	17	*/
	18
	19	#include "cups-private.h"
	20
	21
	22	/*
	23	* 'cupsCancelDestJob()' - Cancel a job on a destination.
	24	*
	25	* The "job_id" is the number returned by cupsCreateDestJob.
	26	*
46385a1a MS	27	* Returns @code IPP_STATUS_OK@ on success and
	28	* @code IPP_STATUS_ERRPR_NOT_AUTHORIZED@ or
	29	* @code IPP_STATUS_ERROR_FORBIDDEN@ on failure.
dcb445bc	30	*
f3c17241	31	* @since CUPS 1.6/OS X 10.8@
dcb445bc MS	32	*/
	33
	34	ipp_status_t
	35	cupsCancelDestJob(http_t http, / I - Connection to destination */
	36	cups_dest_t dest, / I - Destination */
	37	int job_id) /* I - Job ID */
	38	{
46385a1a MS	39	cups_dinfo_t info; / Destination information */
	40
	41
	42	if ((info = cupsCopyDestInfo(http, dest)) != NULL)
	43	{
	44	ipp_t request; / Cancel-Job request */
	45
	46	request = ippNewRequest(IPP_OP_CANCEL_JOB);
	47
	48	ippSetVersion(request, info->version / 10, info->version % 10);
	49
	50	ippAddString(request, IPP_TAG_OPERATION, IPP_TAG_URI, "printer-uri", NULL, info->uri);
	51	ippAddInteger(request, IPP_TAG_OPERATION, IPP_TAG_INTEGER, "job-id", job_id);
	52	ippAddString(request, IPP_TAG_OPERATION, IPP_TAG_NAME, "requesting-user-name", NULL, cupsUser());
7e86f2f6	53
46385a1a MS	54	ippDelete(cupsDoRequest(http, request, info->resource));
	55	cupsFreeDestInfo(info);
	56	}
	57
	58	return (cupsLastError());
dcb445bc MS	59	}
	60
	61
	62	/*
	63	* 'cupsCloseDestJob()' - Close a job and start printing.
	64	*
	65	* Use when the last call to cupsStartDocument passed 0 for "last_document".
cb7f98ee	66	* "job_id" is the job ID returned by cupsCreateDestJob. Returns @code IPP_STATUS_OK@
82cc1f9a	67	* on success.
dcb445bc	68	*
f3c17241	69	* @since CUPS 1.6/OS X 10.8@
dcb445bc MS	70	*/
dcb445bc MS	71
82cc1f9a	72	ipp_status_t /* O - IPP status code */
dcb445bc	73	cupsCloseDestJob(
82cc1f9a MS	74	http_t http, / I - Connection to destination */
	75	cups_dest_t dest, / I - Destination */
	76	cups_dinfo_t info, / I - Destination information */
	77	int job_id) /* I - Job ID */
dcb445bc	78	{
82cc1f9a MS	79	int i; /* Looping var */
	80	ipp_t request = NULL;/ Close-Job/Send-Document request */
	81	ipp_attribute_t attr; / operations-supported attribute */
	82
	83
	84	DEBUG_printf(("cupsCloseDestJob(http=%p, dest=%p(%s/%s), info=%p, job_id=%d)",
	85	http, dest, dest ? dest->name : NULL,
	86	dest ? dest->instance : NULL, info, job_id));
	87
	88	/*
	89	* Range check input...
	90	*/
	91
	92	if (!http \|\| !dest \|\| !info \|\| job_id <= 0)
	93	{
cb7f98ee	94	_cupsSetError(IPP_STATUS_ERROR_INTERNAL, strerror(EINVAL), 0);
82cc1f9a	95	DEBUG_puts("1cupsCloseDestJob: Bad arguments.");
cb7f98ee	96	return (IPP_STATUS_ERROR_INTERNAL);
82cc1f9a MS	97	}
	98
	99	/*
	100	* Build a Close-Job or empty Send-Document request...
	101	*/
	102
	103	if ((attr = ippFindAttribute(info->attrs, "operations-supported",
	104	IPP_TAG_ENUM)) != NULL)
	105	{
	106	for (i = 0; i < attr->num_values; i ++)
cb7f98ee	107	if (attr->values[i].integer == IPP_OP_CLOSE_JOB)
82cc1f9a	108	{
cb7f98ee	109	request = ippNewRequest(IPP_OP_CLOSE_JOB);
82cc1f9a MS	110	break;
	111	}
	112	}
	113
	114	if (!request)
cb7f98ee	115	request = ippNewRequest(IPP_OP_SEND_DOCUMENT);
82cc1f9a MS	116
	117	if (!request)
	118	{
cb7f98ee	119	_cupsSetError(IPP_STATUS_ERROR_INTERNAL, strerror(ENOMEM), 0);
82cc1f9a MS	120	DEBUG_puts("1cupsCloseDestJob: Unable to create Close-Job/Send-Document "
82cc1f9a MS	121	"request.");
cb7f98ee	122	return (IPP_STATUS_ERROR_INTERNAL);
82cc1f9a MS	123	}
82cc1f9a MS	124
6961465f MS	125	ippSetVersion(request, info->version / 10, info->version % 10);
6961465f MS	126
82cc1f9a MS	127	ippAddString(request, IPP_TAG_OPERATION, IPP_TAG_URI, "printer-uri",
	128	NULL, info->uri);
	129	ippAddInteger(request, IPP_TAG_OPERATION, IPP_TAG_INTEGER, "job-id",
	130	job_id);
	131	ippAddString(request, IPP_TAG_OPERATION, IPP_TAG_NAME, "requesting-user-name",
	132	NULL, cupsUser());
cb7f98ee	133	if (ippGetOperation(request) == IPP_OP_SEND_DOCUMENT)
82cc1f9a MS	134	ippAddBoolean(request, IPP_TAG_OPERATION, "last-document", 1);
	135
	136	/*
	137	* Send the request and return the status...
	138	*/
	139
	140	ippDelete(cupsDoRequest(http, request, info->resource));
	141
	142	DEBUG_printf(("1cupsCloseDestJob: %s (%s)", ippErrorString(cupsLastError()),
	143	cupsLastErrorString()));
	144
	145	return (cupsLastError());
dcb445bc MS	146	}
	147
	148
	149	/*
	150	* 'cupsCreateDestJob()' - Create a job on a destination.
	151	*
cb7f98ee	152	* Returns @code IPP_STATUS_OK@ or @code IPP_STATUS_OK_SUBST@ on success, saving the job ID
82cc1f9a	153	* in the variable pointed to by "job_id".
dcb445bc	154	*
f3c17241	155	* @since CUPS 1.6/OS X 10.8@
dcb445bc MS	156	*/
	157
	158	ipp_status_t /* O - IPP status code */
	159	cupsCreateDestJob(
	160	http_t http, / I - Connection to destination */
	161	cups_dest_t dest, / I - Destination */
	162	cups_dinfo_t info, / I - Destination information */
	163	int job_id, / O - Job ID or 0 on error */
	164	const char title, / I - Job name */
	165	int num_options, /* I - Number of job options */
	166	cups_option_t options) / I - Job options */
	167	{
82cc1f9a MS	168	ipp_t request, / Create-Job request */
	169	response; / Create-Job response */
	170	ipp_attribute_t attr; / job-id attribute */
	171
	172
	173	DEBUG_printf(("cupsCreateDestJob(http=%p, dest=%p(%s/%s), info=%p, "
	174	"job_id=%p, title=\"%s\", num_options=%d, options=%p)",
	175	http, dest, dest ? dest->name : NULL,
	176	dest ? dest->instance : NULL, info, job_id, title, num_options,
	177	options));
	178
	179	/*
	180	* Range check input...
	181	*/
	182
	183	if (job_id)
	184	*job_id = 0;
	185
	186	if (!http \|\| !dest \|\| !info \|\| !job_id)
	187	{
cb7f98ee	188	_cupsSetError(IPP_STATUS_ERROR_INTERNAL, strerror(EINVAL), 0);
82cc1f9a	189	DEBUG_puts("1cupsCreateDestJob: Bad arguments.");
cb7f98ee	190	return (IPP_STATUS_ERROR_INTERNAL);
82cc1f9a MS	191	}
	192
	193	/*
	194	* Build a Create-Job request...
	195	*/
	196
cb7f98ee	197	if ((request = ippNewRequest(IPP_OP_CREATE_JOB)) == NULL)
82cc1f9a	198	{
cb7f98ee	199	_cupsSetError(IPP_STATUS_ERROR_INTERNAL, strerror(ENOMEM), 0);
82cc1f9a	200	DEBUG_puts("1cupsCreateDestJob: Unable to create Create-Job request.");
cb7f98ee	201	return (IPP_STATUS_ERROR_INTERNAL);
82cc1f9a MS	202	}
82cc1f9a MS	203
6961465f MS	204	ippSetVersion(request, info->version / 10, info->version % 10);
6961465f MS	205
82cc1f9a MS	206	ippAddString(request, IPP_TAG_OPERATION, IPP_TAG_URI, "printer-uri",
	207	NULL, info->uri);
	208	ippAddString(request, IPP_TAG_OPERATION, IPP_TAG_NAME, "requesting-user-name",
	209	NULL, cupsUser());
	210	if (title)
	211	ippAddString(request, IPP_TAG_OPERATION, IPP_TAG_NAME, "job-name", NULL,
	212	title);
a29fd7dd	213
a469f8a5	214	cupsEncodeOptions2(request, num_options, options, IPP_TAG_OPERATION);
a29fd7dd MS	215	cupsEncodeOptions2(request, num_options, options, IPP_TAG_JOB);
a29fd7dd MS	216	cupsEncodeOptions2(request, num_options, options, IPP_TAG_SUBSCRIPTION);
82cc1f9a MS	217
	218	/*
	219	* Send the request and get the job-id...
	220	*/
dcb445bc	221
82cc1f9a MS	222	response = cupsDoRequest(http, request, info->resource);
	223
	224	if ((attr = ippFindAttribute(response, "job-id", IPP_TAG_INTEGER)) != NULL)
	225	{
	226	*job_id = attr->values[0].integer;
	227	DEBUG_printf(("1cupsCreateDestJob: job-id=%d", *job_id));
	228	}
	229
	230	ippDelete(response);
	231
	232	/*
	233	* Return the status code from the Create-Job request...
	234	*/
	235
	236	DEBUG_printf(("1cupsCreateDestJob: %s (%s)", ippErrorString(cupsLastError()),
	237	cupsLastErrorString()));
	238
	239	return (cupsLastError());
dcb445bc MS	240	}
	241
	242
	243	/*
	244	* 'cupsFinishDestDocument()' - Finish the current document.
	245	*
cb7f98ee	246	* Returns @code IPP_STATUS_OK@ or @code IPP_STATUS_OK_SUBST@ on success.
dcb445bc	247	*
f3c17241	248	* @since CUPS 1.6/OS X 10.8@
dcb445bc MS	249	*/
dcb445bc MS	250
82cc1f9a	251	ipp_status_t /* O - Status of document submission */
dcb445bc	252	cupsFinishDestDocument(
82cc1f9a MS	253	http_t http, / I - Connection to destination */
	254	cups_dest_t dest, / I - Destination */
	255	cups_dinfo_t info) / I - Destination information */
dcb445bc	256	{
82cc1f9a MS	257	DEBUG_printf(("cupsFinishDestDocument(http=%p, dest=%p(%s/%s), info=%p)",
	258	http, dest, dest ? dest->name : NULL,
	259	dest ? dest->instance : NULL, info));
	260
	261	/*
	262	* Range check input...
	263	*/
	264
	265	if (!http \|\| !dest \|\| !info)
	266	{
cb7f98ee	267	_cupsSetError(IPP_STATUS_ERROR_INTERNAL, strerror(EINVAL), 0);
82cc1f9a	268	DEBUG_puts("1cupsFinishDestDocument: Bad arguments.");
cb7f98ee	269	return (IPP_STATUS_ERROR_INTERNAL);
82cc1f9a MS	270	}
	271
	272	/*
	273	* Get the response at the end of the document and return it...
	274	*/
	275
	276	ippDelete(cupsGetResponse(http, info->resource));
	277
	278	DEBUG_printf(("1cupsFinishDestDocument: %s (%s)",
	279	ippErrorString(cupsLastError()), cupsLastErrorString()));
	280
	281	return (cupsLastError());
dcb445bc MS	282	}
	283
	284
	285	/*
	286	* 'cupsStartDestDocument()' - Start a new document.
	287	*
	288	* "job_id" is the job ID returned by cupsCreateDestJob. "docname" is the name
	289	* of the document/file being printed, "format" is the MIME media type for the
	290	* document (see CUPS_FORMAT_xxx constants), and "num_options" and "options"
	291	* are the options do be applied to the document. "last_document" should be 1
	292	* if this is the last document to be submitted in the job. Returns
82cc1f9a	293	* @code HTTP_CONTINUE@ on success.
dcb445bc	294	*
f3c17241	295	* @since CUPS 1.6/OS X 10.8@
dcb445bc MS	296	*/
dcb445bc MS	297
82cc1f9a	298	http_status_t /* O - Status of document creation */
dcb445bc MS	299	cupsStartDestDocument(
	300	http_t http, / I - Connection to destination */
	301	cups_dest_t dest, / I - Destination */
	302	cups_dinfo_t info, / I - Destination information */
	303	int job_id, /* I - Job ID */
	304	const char docname, / I - Document name */
	305	const char format, / I - Document format */
	306	int num_options, /* I - Number of document options */
	307	cups_option_t options, / I - Document options */
	308	int last_document) /* I - 1 if this is the last document */
	309	{
82cc1f9a MS	310	ipp_t request; / Send-Document request */
	311	http_status_t status; /* HTTP status */
	312
	313
	314	DEBUG_printf(("cupsStartDestDocument(http=%p, dest=%p(%s/%s), info=%p, "
	315	"job_id=%d, docname=\"%s\", format=\"%s\", num_options=%d, "
	316	"options=%p, last_document=%d)",
	317	http, dest, dest ? dest->name : NULL,
	318	dest ? dest->instance : NULL, info, job_id, docname, format,
	319	num_options, options, last_document));
	320
	321	/*
	322	* Range check input...
	323	*/
	324
	325	if (!http \|\| !dest \|\| !info \|\| job_id <= 0)
	326	{
cb7f98ee	327	_cupsSetError(IPP_STATUS_ERROR_INTERNAL, strerror(EINVAL), 0);
82cc1f9a	328	DEBUG_puts("1cupsStartDestDocument: Bad arguments.");
cb7f98ee	329	return (HTTP_STATUS_ERROR);
82cc1f9a MS	330	}
	331
	332	/*
	333	* Create a Send-Document request...
	334	*/
	335
cb7f98ee	336	if ((request = ippNewRequest(IPP_OP_SEND_DOCUMENT)) == NULL)
82cc1f9a	337	{
cb7f98ee	338	_cupsSetError(IPP_STATUS_ERROR_INTERNAL, strerror(ENOMEM), 0);
82cc1f9a MS	339	DEBUG_puts("1cupsStartDestDocument: Unable to create Send-Document "
82cc1f9a MS	340	"request.");
cb7f98ee	341	return (HTTP_STATUS_ERROR);
82cc1f9a MS	342	}
82cc1f9a MS	343
6961465f MS	344	ippSetVersion(request, info->version / 10, info->version % 10);
6961465f MS	345
82cc1f9a MS	346	ippAddString(request, IPP_TAG_OPERATION, IPP_TAG_URI, "printer-uri",
	347	NULL, info->uri);
	348	ippAddInteger(request, IPP_TAG_OPERATION, IPP_TAG_INTEGER, "job-id", job_id);
	349	ippAddString(request, IPP_TAG_OPERATION, IPP_TAG_NAME, "requesting-user-name",
	350	NULL, cupsUser());
	351	if (docname)
	352	ippAddString(request, IPP_TAG_OPERATION, IPP_TAG_NAME, "document-name",
	353	NULL, docname);
	354	if (format)
	355	ippAddString(request, IPP_TAG_OPERATION, IPP_TAG_MIMETYPE,
	356	"document-format", NULL, format);
7e86f2f6	357	ippAddBoolean(request, IPP_TAG_OPERATION, "last-document", (char)last_document);
82cc1f9a	358
a469f8a5	359	cupsEncodeOptions2(request, num_options, options, IPP_TAG_OPERATION);
82cc1f9a MS	360	cupsEncodeOptions2(request, num_options, options, IPP_TAG_DOCUMENT);
	361
	362	/*
	363	* Send and delete the request, then return the status...
	364	*/
	365
	366	status = cupsSendRequest(http, request, info->resource, CUPS_LENGTH_VARIABLE);
	367
	368	ippDelete(request);
	369
	370	return (status);
dcb445bc	371	}