diff options
Diffstat (limited to 'usr/src/man/man3papi/papiJobSubmit.3papi')
-rw-r--r-- | usr/src/man/man3papi/papiJobSubmit.3papi | 55 |
1 files changed, 13 insertions, 42 deletions
diff --git a/usr/src/man/man3papi/papiJobSubmit.3papi b/usr/src/man/man3papi/papiJobSubmit.3papi index 76ad3facfc..5e67ca2ab3 100644 --- a/usr/src/man/man3papi/papiJobSubmit.3papi +++ b/usr/src/man/man3papi/papiJobSubmit.3papi @@ -3,7 +3,7 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH papiJobSubmit 3PAPI "17 Jan 2007" "SunOS 5.11" "PAPI Library Functions" +.TH PAPIJOBSUBMIT 3PAPI "Jan 17, 2007" .SH NAME papiJobSubmit, papiJobSubmitByReference, papiJobValidate, papiJobStreamOpen, papiJobStreamWrite, papiJobStreamClose, papiJobQuery, papiJobModify, @@ -13,7 +13,7 @@ papiJobGetJobTicket, papiJobFree, papiJobListFree \- job object manipulation .SH SYNOPSIS .LP .nf -cc [ \fIflag\fR\&.\|.\|. ] \fIfile\fR\&.\|.\|. \fB-lpapi\fR [ \fIlibrary\fR\&.\|.\|. ] +cc [ \fIflag\fR\&.\|.\|. ] \fIfile\fR\&.\|.\|. \fB-lpapi\fR [ \fIlibrary\fR\&.\|.\|. ] #include <papi.h> \fBpapi_status_t\fR \fBpapiJobSubmit\fR(\fBpapi_service_t\fR \fIhandle\fR, @@ -140,80 +140,66 @@ cc [ \fIflag\fR\&.\|.\|. ] \fIfile\fR\&.\|.\|. \fB-lpapi\fR [ \fIlibrary\fR\&.\| .SH PARAMETERS .sp .ne 2 -.mk .na \fB\fIattributes\fR\fR .ad .RS 19n -.rt a set of attributes to be applied to a printer object .RE .sp .ne 2 -.mk .na \fB\fIbuffer\fR\fR .ad .RS 19n -.rt a buffer of data to be written to the job stream .RE .sp .ne 2 -.mk .na \fB\fIbufflen\fR\fR .ad .RS 19n -.rt the size of the supplied buffer .RE .sp .ne 2 -.mk .na \fB\fIdestination\fR\fR .ad .RS 19n -.rt the name of the printer where a print job should be relocated, which must reside within the same print services as the job is currently queued .RE .sp .ne 2 -.mk .na \fB\fIfiles\fR\fR .ad .RS 19n -.rt files to use during job submission .RE .sp .ne 2 -.mk .na \fB\fIhandle\fR\fR .ad .RS 19n -.rt a pointer to a handle to be used for all PAPI operations that is created by calling \fBpapiServiceCreate()\fR .RE .sp .ne 2 -.mk .na \fB\fIjob\fR\fR .ad .RS 19n -.rt a pointer to a printer object (initialized to NULL) to be filled in by \fBpapiJobQuery()\fR, \fBpapiJobSubmit()\fR, \fBpapiJobSubmitByReference()\fR, \fBpapiJobValidate()\fR, \fBpapiJobStreamClose()\fR, and \fBpapiJobModify()\fR @@ -221,80 +207,66 @@ a pointer to a printer object (initialized to NULL) to be filled in by .sp .ne 2 -.mk .na \fB\fIjob_attributes\fR\fR .ad .RS 19n -.rt attributes to apply during job creation or modification .RE .sp .ne 2 -.mk .na \fB\fIjob_id\fR\fR .ad .RS 19n -.rt ID number of the job reported on or manipulated .RE .sp .ne 2 -.mk .na \fB\fIjob_ticket\fR\fR .ad .RS 19n -.rt unused .RE .sp .ne 2 -.mk .na \fB\fIjobs\fR\fR .ad .RS 19n -.rt a list of job objects returned by \fBpapiPrinterListJobs()\fR or \fBpapiPrinterPurgeJobs()\fR .RE .sp .ne 2 -.mk .na \fB\fIprinter\fR\fR .ad .RS 19n -.rt name of the printer where the job is or should reside .RE .sp .ne 2 -.mk .na \fB\fIrequested_attrs\fR\fR .ad .RS 19n -.rt a null-terminated array of pointers to attribute names requested during job enumeration (\fBpapiPrinterListJobs()\fR) or job query (\fBpapiJobQuery()\fR) .RE .sp .ne 2 -.mk .na \fB\fIstream\fR\fR .ad .RS 19n -.rt a communication endpoint for sending print job data .RE @@ -417,7 +389,7 @@ authCB(papi_service_t svc, void *app_data) /* build the prompt string */ snprintf(prompt, sizeof (prompt), - gettext("passphrase for %s to access %s: "), user, + gettext("passphrase for %s to access %s: "), user, svc_name); /* ask for the passphrase */ @@ -482,7 +454,7 @@ main(int ac, char *av[]) "printer-name", &name); (void) papiAttributeListGetInteger(list, NULL, "job-id", &id); - while (papiAttributeListToString(list, "\n\t", buffer, + while (papiAttributeListToString(list, "\n\t", buffer, size) != PAPI_OK) buffer = realloc(buffer, size += BUFSIZ); @@ -652,7 +624,7 @@ authCB(papi_service_t svc, void *app_data) /* build the prompt string */ snprintf(prompt, sizeof (prompt), - gettext("passphrase for %s to access %s: "), user, + gettext("passphrase for %s to access %s: "), user, svc_name); /* ask for the passphrase */ @@ -692,7 +664,7 @@ main(int ac, char *av[]) PAPI_ENCRYPT_NEVER, NULL); if (status != PAPI_OK) { - printf("papiServiceCreate(%s): %s\n", svc_name ? svc_name : + printf("papiServiceCreate(%s): %s\n", svc_name ? svc_name : "NULL", papiStatusString(status)); papiServiceDestroy(svc); exit(1); @@ -705,7 +677,7 @@ main(int ac, char *av[]) "job-title", "Standard Input"); status = papiJobStreamOpen(svc, pname, attrs, NULL, &stream); - while ((status == PAPI_OK) && ((rc = read(0, buf, + while ((status == PAPI_OK) && ((rc = read(0, buf, sizeof (buf))) > 0)) status = papiJobStreamWrite(svc, stream, buf, rc); @@ -753,15 +725,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityVolatile +Interface Stability Volatile _ -MT-LevelSafe +MT-Level Safe .TE .SH SEE ALSO |