diff options
Diffstat (limited to 'usr/src/man/man3papi')
| -rw-r--r-- | usr/src/man/man3papi/papiAttributeListAddValue.3papi | 86 | ||||
| -rw-r--r-- | usr/src/man/man3papi/papiJobSubmit.3papi | 55 | ||||
| -rw-r--r-- | usr/src/man/man3papi/papiLibrarySupportedCall.3papi | 19 | ||||
| -rw-r--r-- | usr/src/man/man3papi/papiPrintersList.3papi | 48 | ||||
| -rw-r--r-- | usr/src/man/man3papi/papiServiceCreate.3papi | 35 | ||||
| -rw-r--r-- | usr/src/man/man3papi/papiStatusString.3papi | 19 |
6 files changed, 55 insertions, 207 deletions
diff --git a/usr/src/man/man3papi/papiAttributeListAddValue.3papi b/usr/src/man/man3papi/papiAttributeListAddValue.3papi index 09b700b3ef..fad0b32f91 100644 --- a/usr/src/man/man3papi/papiAttributeListAddValue.3papi +++ b/usr/src/man/man3papi/papiAttributeListAddValue.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 papiAttributeListAddValue 3PAPI "17 Jan 2007" "SunOS 5.11" "PAPI Library Functions" +.TH PAPIATTRIBUTELISTADDVALUE 3PAPI "Jan 17, 2007" .SH NAME papiAttributeListAddValue, papiAttributeListAddBoolean, papiAttributeListAddCollection, papiAttributeListAddDatetime, @@ -19,7 +19,7 @@ papiAttributeListToString, papiAttributeListFree \- manage PAPI attribute lists .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 \fBpapiAttributeListAddValue\fR(\fBpapi_attribute_t ***\fR\fIattrs\fR, @@ -170,116 +170,95 @@ cc [ \fIflag\fR\&.\|.\|. ] \fIfile\fR\&.\|.\|. \fB-lpapi\fR [ \fIlibrary\fR\&.\| .SH PARAMETERS .sp .ne 2 -.mk .na \fB\fIattrs\fR\fR .ad .RS 14n -.rt address of array of pointers to attributes .RE .sp .ne 2 -.mk .na \fB\fIattributes\fR\fR .ad .RS 14n -.rt a list of attributes (of type \fBpapi_attribute_t **\fR) contained in a collection. Lists can be hierarchical. .RE .sp .ne 2 -.mk .na \fB\fIboolean\fR\fR .ad .RS 14n -.rt boolean value (\fBPAPI_TRUE\fR or \fBPAPI_FALSE)\fR .RE .sp .ne 2 -.mk .na \fB\fIbuffer\fR\fR .ad .RS 14n -.rt buffer to fill .RE .sp .ne 2 -.mk .na \fB\fIbuflen\fR\fR .ad .RS 14n -.rt length of supplied buffer .RE .sp .ne 2 -.mk .na \fB\fIcollection\fR\fR .ad .RS 14n -.rt list of attributes .RE .sp .ne 2 -.mk .na \fB\fIdatetime\fR\fR .ad .RS 14n -.rt attribute time value specified in \fBtime_t\fR representation .RE .sp .ne 2 -.mk .na \fB\fIdelim\fR\fR .ad .RS 14n -.rt delimiter used in construction of a string representation of an attribute list .RE .sp .ne 2 -.mk .na \fB\fIdt\fR\fR .ad .RS 14n -.rt date and time represented as a \fBtime_t\fR .RE .sp .ne 2 -.mk .na \fB\fIflags\fR\fR .ad .RS 14n -.rt Specify bit fields defining how actions will be performed: .sp .ne 2 -.mk .na \fB\fBPAPI_ATTR_REPLACE\fR\fR .ad @@ -290,7 +269,6 @@ Free any existing value(s) and replace it with the supplied value(s). .sp .ne 2 -.mk .na \fB\fBPAPI_ATTR_APPEND\fR\fR .ad @@ -301,7 +279,6 @@ Add the supplied value to the attribute. .sp .ne 2 -.mk .na \fB\fBPAPI_ATTR_EXCL\fR\fR .ad @@ -315,67 +292,55 @@ defined. .sp .ne 2 -.mk .na \fB\fIinteger\fR\fR .ad .RS 14n -.rt integer value .RE .sp .ne 2 -.mk .na \fB\fIiterator\fR\fR .ad .RS 14n -.rt iterator for enumerating multiple values of multi-value attributes .RE .sp .ne 2 -.mk .na \fB\fIlist\fR\fR .ad .RS 14n -.rt array of pointers to attributes (attribute list) .RE .sp .ne 2 -.mk .na \fB\fIlower\fR\fR .ad .RS 14n -.rt lower bound for a range of integer .RE .sp .ne 2 -.mk .na \fB\fImax\fR\fR .ad .RS 14n -.rt maximum value in a range .RE .sp .ne 2 -.mk .na \fB\fImetadata\fR\fR .ad .RS 14n -.rt pseudo-values for specialized attributes \fBPAPI_UNSUPPORTED\fR, \fBPAPI_DEFAULT\fR, \fBPAPI_UNKNOWN\fR, \fBPAPI_NO_VALUE\fR, \fBPAPI_NOT_SETTABLE\fR, \fBPAPI_DELETE\fR @@ -383,45 +348,37 @@ pseudo-values for specialized attributes \fBPAPI_UNSUPPORTED\fR, .sp .ne 2 -.mk .na \fB\fImin\fR\fR .ad .RS 14n -.rt minimum value in a range .RE .sp .ne 2 -.mk .na \fB\fIname\fR\fR .ad .RS 14n -.rt attribute name .RE .sp .ne 2 -.mk .na \fB\fIstring\fR\fR .ad .RS 14n -.rt string value .RE .sp .ne 2 -.mk .na \fB\fItype\fR\fR .ad .RS 14n -.rt attribute type (\fBPAPI_STRING\fR, \fBPAPI_INTEGER\fR, \fBPAPI_BOOLEAN\fR, \fBPAPI_RANGE\fR, \fBPAPI_RESOLUTION\fR, \fBPAPI_DATETIME\fR, \fBPAPI_COLLECTION\fR, \fBPAPI_METADATA\fR) @@ -429,89 +386,73 @@ attribute type (\fBPAPI_STRING\fR, \fBPAPI_INTEGER\fR, \fBPAPI_BOOLEAN\fR, .sp .ne 2 -.mk .na \fB\fIunits\fR\fR .ad .RS 14n -.rt resolution unit of measure (\fBPAPI_RES_PER_INCH\fR or \fBPAPI_RES_PER_CM\fR) .RE .sp .ne 2 -.mk .na \fB\fIupper\fR\fR .ad .RS 14n -.rt upper bound for a range of integer .RE .sp .ne 2 -.mk .na \fB\fIvalue\fR\fR .ad .RS 14n -.rt attribute value .RE .sp .ne 2 -.mk .na \fB\fIvptr\fR\fR .ad .RS 14n -.rt pointer to arbitrary data .RE .sp .ne 2 -.mk .na \fB\fIx\fR\fR .ad .RS 14n -.rt horizontal (x) resolution .RE .sp .ne 2 -.mk .na \fB\fIxres\fR\fR .ad .RS 14n -.rt horizontal (x) component of a resolution .RE .sp .ne 2 -.mk .na \fB\fIy\fR\fR .ad .RS 14n -.rt vertical (y) resolution .RE .sp .ne 2 -.mk .na \fB\fIyres\fR\fR .ad .RS 14n -.rt vertical (y) component of a resolution .RE @@ -594,56 +535,46 @@ These functions return \fBPAPI_OK\fR upon successful completion and one of the following on failure: .sp .ne 2 -.mk .na \fB\fBPAPI_BAD_ARGUMENT\fR\fR .ad .RS 24n -.rt The supplied arguments were not valid. .RE .sp .ne 2 -.mk .na \fB\fBPAPI_CONFLICT\fR\fR .ad .RS 24n -.rt There was an attribute type mismatch. .RE .sp .ne 2 -.mk .na \fB\fBPAPI_NOT_FOUND\fR\fR .ad .RS 24n -.rt The requested attribute could not be found. .RE .sp .ne 2 -.mk .na \fB\fBPAPI_NOT_POSSIBLE\fR\fR .ad .RS 24n -.rt The requested operation could not be performed due to buffer overflow. .RE .sp .ne 2 -.mk .na \fB\fBPAPI_TEMPORARY_ERROR\fR\fR .ad .RS 24n -.rt Memory could not be allocated to add to the attribute list. .RE @@ -715,15 +646,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 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 diff --git a/usr/src/man/man3papi/papiLibrarySupportedCall.3papi b/usr/src/man/man3papi/papiLibrarySupportedCall.3papi index df2710027c..4aa8f6031c 100644 --- a/usr/src/man/man3papi/papiLibrarySupportedCall.3papi +++ b/usr/src/man/man3papi/papiLibrarySupportedCall.3papi @@ -3,14 +3,14 @@ .\" 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 papiLibrarySupportedCall 3PAPI "17 Jan 2007" "SunOS 5.11" "PAPI Library Functions" +.TH PAPILIBRARYSUPPORTEDCALL 3PAPI "Jan 17, 2007" .SH NAME papiLibrarySupportedCall, papiLibrarySupportedCalls \- determine if a PAPI function returns valid data .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> \fBchar\fR \fBpapiLibrarySupportedCall\fR(\fBconst char *\fR\fIname\fR); @@ -24,12 +24,10 @@ cc [ \fIflag\fR\&.\|.\|. ] \fIfile\fR\&.\|.\|. \fB-lpapi\fR [ \fIlibrary\fR\&.\| .SH PARAMETERS .sp .ne 2 -.mk .na \fB\fIname\fR\fR .ad .RS 8n -.rt the name of a PAPI function .RE @@ -62,15 +60,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 diff --git a/usr/src/man/man3papi/papiPrintersList.3papi b/usr/src/man/man3papi/papiPrintersList.3papi index cc0e2c1741..b63302e558 100644 --- a/usr/src/man/man3papi/papiPrintersList.3papi +++ b/usr/src/man/man3papi/papiPrintersList.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 papiPrintersList 3PAPI "17 Jan 2007" "SunOS 5.11" "PAPI Library Functions" +.TH PAPIPRINTERSLIST 3PAPI "Jan 17, 2007" .SH NAME papiPrintersList, papiPrinterQuery, papiPrinterAdd, papiPrinterModify, papiPrinterRemove, papiPrinterDisable, papiPrinterEnable, papiPrinterPause, @@ -13,7 +13,7 @@ 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 \fBpapiPrintersList\fR(\fBpapi_service_t\fR \fIhandle\fR, @@ -98,126 +98,104 @@ 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\fIfilter\fR\fR .ad .RS 19n -.rt a filter to be applied during printer enumeration .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, created by calling \fBpapiServiceCreate()\fR .RE .sp .ne 2 -.mk .na \fB\fIjob_attributes\fR\fR .ad .RS 19n -.rt unused .RE .sp .ne 2 -.mk .na \fB\fIjobs\fR\fR .ad .RS 19n -.rt a pointer to a list to return job objects (initialized to \fINULL\fR) enumerated by \fBpapiPrinterGetJobs()\fR .RE .sp .ne 2 -.mk .na \fB\fImax_num_jobs\fR\fR .ad .RS 19n -.rt the maximum number of jobs to return from a \fBpapiPrinterGetJobs()\fR request .RE .sp .ne 2 -.mk .na \fB\fImessage\fR\fR .ad .RS 19n -.rt a message to be associated with a printer while disabled or paused .RE .sp .ne 2 -.mk .na \fB\fIname\fR\fR .ad .RS 19n -.rt the name of the printer object being operated on .RE .sp .ne 2 -.mk .na \fB\fIprinter\fR\fR .ad .RS 19n -.rt a pointer to a printer object (initialized to \fINULL\fR) to be filled in by \fBpapiPrinterQuery()\fR, \fBpapiPrinterAdd()\fR, and \fBpapiPrinterModify()\fR .RE .sp .ne 2 -.mk .na \fB\fIprinters\fR\fR .ad .RS 19n -.rt a pointer to a list to return printer objects (initialized to \fINULL\fR) enumerated by \fBpapiPrintersList()\fR .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 printer enumeration (\fBpapiPrintersList()\fR), printer query (\fBpapiPrinterQuery()\fR), or job enumeration (\fBpapiPrinterListJobs()\fR) @@ -225,18 +203,15 @@ enumeration (\fBpapiPrintersList()\fR), printer query .sp .ne 2 -.mk .na \fB\fItype_mask\fR\fR .ad .RS 19n -.rt a bit field indicating which type of jobs to return \fBPAPI_LIST_JOBS_OTHERS\fR include jobs submitted by others. The default is to report only on your own jobs .sp .ne 2 -.mk .na \fB\fBPAPI_LIST_JOBS_COMPLETED\fR\fR .ad @@ -247,7 +222,6 @@ include completed jobs .sp .ne 2 -.mk .na \fB\fBPAPI_LIST_JOBS_NOT_COMPLETED\fR\fR .ad @@ -258,7 +232,6 @@ include jobs not complete .sp .ne 2 -.mk .na \fB\fBPAPI_LIST_JOBS_ALL\fR\fR .ad @@ -419,7 +392,7 @@ main(int ac, char *av[]) int i; for (i = 0; printers[i] != NULL; i++) { - papi_attribute_t **list = + papi_attribute_t **list = papiPrinterGetAttributeList(printers[i]); if (list != NULL) { @@ -516,7 +489,7 @@ main(int ac, char *av[]) PAPI_ENCRYPT_NEVER, NULL); if (status != PAPI_OK) { - printf("papiServiceCreate(%s): %s\en", svc_name ? svc_name : + printf("papiServiceCreate(%s): %s\en", svc_name ? svc_name : "NULL", papiStatusString(status)); papiServiceDestroy(svc); exit(1); @@ -553,15 +526,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 diff --git a/usr/src/man/man3papi/papiServiceCreate.3papi b/usr/src/man/man3papi/papiServiceCreate.3papi index 916ddf6e42..65a95d83e1 100644 --- a/usr/src/man/man3papi/papiServiceCreate.3papi +++ b/usr/src/man/man3papi/papiServiceCreate.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 papiServiceCreate 3PAPI "17 Jan 2007" "SunOS 5.11" "PAPI Library Functions" +.TH PAPISERVICECREATE 3PAPI "Jan 17, 2007" .SH NAME papiServiceCreate, papiServiceDestroy, papiServiceSetUserName, papiServiceSetPassword, papiServiceSetEncryption, papiServiceSetAuthCB, @@ -14,7 +14,7 @@ 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 \fBpapiServiceCreate\fR(\fBpapi_service_t *\fR\fIhandle\fR, @@ -96,35 +96,29 @@ cc [ \fIflag\fR\&.\|.\|. ] \fIfile\fR\&.\|.\|. \fB-lpapi\fR [ \fIlibrary\fR\&.\| .SH PARAMETERS .sp .ne 2 -.mk .na \fB\fIapp_data\fR\fR .ad .RS 16n -.rt a set of additional data to be passed to the \fIauthCB\fR if/when it is called .RE .sp .ne 2 -.mk .na \fB\fIauthCB\fR\fR .ad .RS 16n -.rt a callback routine use to gather additional authentication information on behalf of the print service .RE .sp .ne 2 -.mk .na \fB\fIencryption\fR\fR .ad .RS 16n -.rt whether or not encryption should be used for communication with the print service, where applicable. If \fBPAPI_ENCRYPT_IF_REQUESTED\fR is specified, encryption will be used if the print service requests it. If @@ -136,24 +130,20 @@ communicating with the print service .sp .ne 2 -.mk .na \fB\fIhandle\fR\fR .ad .RS 16n -.rt a pointer to a handle to be used for all \fBlibpapi\fR operations. This handle should be initialized to \fINULL\fR prior to creation .RE .sp .ne 2 -.mk .na \fB\fIpassword\fR\fR .ad .RS 16n -.rt a plain text password to be used during any required user authentication with the print service function set with \fBpapiServiceSetAuthCB()\fR. This provides the callback function a means of interrogating the service context for user @@ -162,23 +152,19 @@ information and setting a password. .sp .ne 2 -.mk .na \fB\fIs\fR\fR .ad .RS 16n -.rt the service context passed into the the authentication callback .RE .sp .ne 2 -.mk .na \fB\fIservice_name\fR\fR .ad .RS 16n -.rt the name of a print service to contact. This can be \fINULL\fR, a print service name like "lpsched", a resolvable printer name, or a \fBprinter-uri\fR like \fBipp://server/printers/queue\fR. @@ -186,12 +172,10 @@ like \fBipp://server/printers/queue\fR. .sp .ne 2 -.mk .na \fB\fIsvc\fR\fR .ad .RS 16n -.rt a handle (service context) used by subsequent PAPI calls to keep/pass information across PAPI calls. It generally contains connection, state, and authentication information. @@ -199,12 +183,10 @@ authentication information. .sp .ne 2 -.mk .na \fB\fIuser_name\fR\fR .ad .RS 16n -.rt the name of the user to act on behalf of while contacting the print service. If a value of \fINULL\fR is used, the user name associated with the current processes UID will be used. Specifying a user name might require further @@ -317,15 +299,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 diff --git a/usr/src/man/man3papi/papiStatusString.3papi b/usr/src/man/man3papi/papiStatusString.3papi index a3f35b59fd..7866f4baf2 100644 --- a/usr/src/man/man3papi/papiStatusString.3papi +++ b/usr/src/man/man3papi/papiStatusString.3papi @@ -3,13 +3,13 @@ .\" 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 papiStatusString 3PAPI "17 Jan 2007" "SunOS 5.11" "PAPI Library Functions" +.TH PAPISTATUSSTRING 3PAPI "Jan 17, 2007" .SH NAME papiStatusString \- return the string equivalent of a papi_status_t .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> \fBchar *\fR\fBpapiStatusString\fR(\fBpapi_status_t\fR \fIstatus\fR); @@ -18,12 +18,10 @@ cc [ \fIflag\fR\&.\|.\|. ] \fIfile\fR\&.\|.\|. \fB-lpapi\fR [ \fIlibrary\fR\&.\| .SH PARAMETERS .sp .ne 2 -.mk .na \fB\fIstatus\fR\fR .ad .RS 10n -.rt a \fBpapi_status_t\fR returned from most \fBpapi*()\fR functions .RE @@ -71,15 +69,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 |