Skip Navigation Links | |
Exit Print View | |
man pages section 3: Extended Library Functions, Volume 3 Oracle Solaris 11 Information Library |
Extended Library Functions, Volume 3
nvlist_add_boolean_array(3NVPAIR)
nvlist_add_boolean_value(3NVPAIR)
nvlist_add_byte_array(3NVPAIR)
nvlist_add_int16_array(3NVPAIR)
nvlist_add_int32_array(3NVPAIR)
nvlist_add_int64_array(3NVPAIR)
nvlist_add_int8_array(3NVPAIR)
nvlist_add_nvlist_array(3NVPAIR)
nvlist_add_string_array(3NVPAIR)
nvlist_add_uint16_array(3NVPAIR)
nvlist_add_uint32_array(3NVPAIR)
nvlist_add_uint64_array(3NVPAIR)
nvlist_add_uint8_array(3NVPAIR)
nvlist_lookup_boolean(3NVPAIR)
nvlist_lookup_boolean_array(3NVPAIR)
nvlist_lookup_boolean_value(3NVPAIR)
nvlist_lookup_byte_array(3NVPAIR)
nvlist_lookup_int16_array(3NVPAIR)
nvlist_lookup_int32_array(3NVPAIR)
nvlist_lookup_int64_array(3NVPAIR)
nvlist_lookup_int8_array(3NVPAIR)
nvlist_lookup_nv_alloc(3NVPAIR)
nvlist_lookup_nvlist_array(3NVPAIR)
nvlist_lookup_string_array(3NVPAIR)
nvlist_lookup_uint16_array(3NVPAIR)
nvlist_lookup_uint32_array(3NVPAIR)
nvlist_lookup_uint64_array(3NVPAIR)
nvlist_lookup_uint8_array(3NVPAIR)
nvpair_value_boolean_array(3NVPAIR)
nvpair_value_boolean_value(3NVPAIR)
nvpair_value_byte_array(3NVPAIR)
nvpair_value_int16_array(3NVPAIR)
nvpair_value_int32_array(3NVPAIR)
nvpair_value_int64_array(3NVPAIR)
nvpair_value_int8_array(3NVPAIR)
nvpair_value_nvlist_array(3NVPAIR)
nvpair_value_string_array(3NVPAIR)
nvpair_value_uint16_array(3NVPAIR)
nvpair_value_uint32_array(3NVPAIR)
nvpair_value_uint64_array(3NVPAIR)
nvpair_value_uint8_array(3NVPAIR)
papiAttributeListAddBoolean(3PAPI)
papiAttributeListAddCollection(3PAPI)
papiAttributeListAddDatetime(3PAPI)
papiAttributeListAddInteger(3PAPI)
papiAttributeListAddMetadata(3PAPI)
papiAttributeListAddRange(3PAPI)
papiAttributeListAddResolution(3PAPI)
papiAttributeListAddString(3PAPI)
papiAttributeListAddValue(3PAPI)
papiAttributeListDelete(3PAPI)
papiAttributeListFromString(3PAPI)
papiAttributeListGetBoolean(3PAPI)
papiAttributeListGetCollection(3PAPI)
papiAttributeListGetDatetime(3PAPI)
papiAttributeListGetInteger(3PAPI)
papiAttributeListGetMetadata(3PAPI)
papiAttributeListGetNext(3PAPI)
papiAttributeListGetRange(3PAPI)
papiAttributeListGetResolution(3PAPI)
papiAttributeListGetString(3PAPI)
papiAttributeListGetValue(3PAPI)
papiAttributeListToString(3PAPI)
papiJobGetAttributeList(3PAPI)
papiLibrarySupportedCall(3PAPI)
papiLibrarySupportedCalls(3PAPI)
papiPrinterGetAttributeList(3PAPI)
papiServiceGetAttributeList(3PAPI)
papiServiceGetEncryption(3PAPI)
papiServiceGetServiceName(3PAPI)
papiServiceGetStatusMessage(3PAPI)
papiServiceSetEncryption(3PAPI)
picld_plugin_register(3PICLTREE)
picl_get_frutree_parent(3PICL)
picl_get_propinfo_by_name(3PICL)
picl_get_propval_by_name(3PICL)
picl_set_propval_by_name(3PICL)
picl_walk_tree_by_class(3PICL)
pool_get_owning_resource(3POOL)
pool_get_resource_binding(3POOL)
pool_query_pool_resources(3POOL)
pool_query_resource_components(3POOL)
pool_resource_type_list(3POOL)
pool_resource_xtransfer(3POOL)
ptree_add_row_to_table(3PICLTREE)
ptree_create_and_add_node(3PICLTREE)
ptree_create_and_add_prop(3PICLTREE)
ptree_get_first_prop(3PICLTREE)
ptree_get_frutree_parent(3PICLTREE)
ptree_get_next_by_col(3PICLTREE)
ptree_get_next_by_row(3PICLTREE)
ptree_get_next_prop(3PICLTREE)
ptree_get_node_by_path(3PICLTREE)
ptree_get_prop_by_name(3PICLTREE)
ptree_get_propinfo_by_name(3PICLTREE)
ptree_get_propval_by_name(3PICLTREE)
ptree_init_propinfo(3PICLTREE)
ptree_register_handler(3PICLTREE)
ptree_unregister_handler(3PICLTREE)
ptree_update_propval(3PICLTREE)
ptree_update_propval_by_name(3PICLTREE)
- job object manipulation
cc [ flag… ] file… -lpapi [ library… ] #include <papi.h> papi_status_t papiJobSubmit(papi_service_t handle, char *printer, papi_attribute_t **job_attributes, papi_job_ticket_t *job_ticket, char **files, papi_job_t *job);
papi_status_t papiJobSubmitByReference(papi_service_t handle, char *printer, papi_attribute_t **job_attributes, papi_job_ticket_t *job_ticket, char **files, papi_job_t *job);
papi_status_t papiJobValidate(papi_service_t handle, char *printer, papi_attribute_t **job_attributes, papi_job_ticket_t *job_ticket, char **files, papi_job_t *job);
papi_status_t papiJobStreamOpen(papi_service_t handle, char *printer, papi_attribute_t **job_attributes, papi_job_ticket_t *job_ticket, papi_stream_t *stream);
papi_status_t papiJobStreamWrite(papi_service_t handle, papi_stream_t stream, void *buffer, size_t buflen);
papi_status_t papiJobStreamClose(papi_service_t handle, papi_stream_t stream, papi_job_t *job);
papi_status_t papiJobQuery(papi_service_t handle, char *printer, int32_t job_id, char **requested_attrs, papi_job_t *job);
papi_status_t papiJobModify(papi_service_t handle, char *printer, int32_t job_id, papi_attribute_t **attributes, papi_job_t *job);
papi_status_t papiJobMove(papi_service_t handle, char *printer, int32_t job_id, char *destination);
papi_status_t papiJobCancel(papi_service_t handle, char *printer, int32_t job_id);
papi_status_t papiJobHold(papi_service_t handle, char *printer, int32_t job_id);
papi_status_t papiJobRelease(papi_service_t handle, char *printer, int32_t job_id);
papi_status_t papiJobRestart(papi_service_t handle, char *printer, int32_t job_id);
papi_status_t papiJobPromote(papi_service_t handle, char *printer, int32_t job_id);
papi_attribute_t **papiJobGetAttributeList(papi_job_t job);
char *papiJobGetPrinterName(papi_job_t job);
int32_t papiJobGetId(papi_job_t job);
papi_job_ticket_t *papiJobGetJobTicket(papi_job_t job);
void papiJobFree(papi_job_t job);
void papiJobListFree(papi_job_t *jobs);
a set of attributes to be applied to a printer object
a buffer of data to be written to the job stream
the size of the supplied buffer
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
files to use during job submission
a pointer to a handle to be used for all PAPI operations that is created by calling papiServiceCreate()
a pointer to a printer object (initialized to NULL) to be filled in by papiJobQuery(), papiJobSubmit(), papiJobSubmitByReference(), papiJobValidate(), papiJobStreamClose(), and papiJobModify()
attributes to apply during job creation or modification
ID number of the job reported on or manipulated
unused
a list of job objects returned by papiPrinterListJobs() or papiPrinterPurgeJobs()
name of the printer where the job is or should reside
a null-terminated array of pointers to attribute names requested during job enumeration (papiPrinterListJobs()) or job query (papiJobQuery())
a communication endpoint for sending print job data
The papiJobSubmit() function creates a print job containing the passed in files with the supplied attributes. When the function returns, the data in the passed files will have been copied by the print service. A job object is returned that reflects the state of the job.
The papiJobSubmitByReference() function creates a print job containing the passed in files with the supplied attributes. When the function returns, the data in the passed files might have been copied by the print service. A job object is returned that reflects the state of the job.
The papiJobStreamOpen(), papiJobStreamWrite(), papiJobStreamClose() functions create a print job by opening a stream, writing to the stream, and closing it.
The papiJobValidate() function validates that the supplied attributes and files will result in a valid print job.
The papiJobQuery() function retrieves job information from the print service.
The papiJobModify() function modifies a queued job according to the attribute list passed into the call. A job object is returned that reflects the state of the job after the modification has been applied.
The papiJobMove() function moves a job from its current queue to the named destination within the same print service.
The papiJobCancel() function removes a job from the queue.
The papiJobHold() and papiJobRelease() functions set the job state to “held” or “idle” to indicate whether the job is eligible for processing.
The papiJobRestart() function restarts processing of a currently queued print job.
The papiJobGetAttributeList() function returns a list of attributes describing the job. This list can be searched and/or enumerated using papiAttributeList*() calls. See papiAttributeListAddValue(3PAPI).
The papiJobGetPrinterName() function returns the name of the queue where the job is currently queued.
The papiJobGetId() function returns a job identifier number from the job object passed in.
The papiJobPromote() function moves a job to the head of the print queue.
The papiJobGetJobTicket() function retrieves a pointer to a job ticket associated with the job object.
The papiJobFree() and papiJobListFree() functions deallocate memory allocated for the return of printer object(s) from functions that return printer objects.
Upon successful completion, all papiJob*() functions that return a value return PAPI_OK. Otherwise, they return an appropriate papi_status_t indicating the type of failure.
Upon successful completion, papiJobGetAttributeList() returns a pointer to the requested data. Otherwise, it returns NULL.
Example 1 Enumerate all jobs in a queue
/* * program to enumerate queued jobs using PAPI interfaces. */ #include <stdio.h> #include <stdlib.h> #include <unistd.h> #include <libintl.h> #include <pwd.h> #include <papi.h> static int authCB(papi_service_t svc, void *app_data) { char prompt[BUFSIZ]; char *user, *svc_name, *passphrase; /* get the name of the service we are contacting */ if ((svc_name = papiServiceGetServiceName(svc)) == NULL) return (-1); /* find out who we are supposed to be */ if ((user = papiServiceGetUserName(svc)) == NULL) { struct passwd *pw; if ((pw = getpwuid(getuid())) != NULL) user = pw->pw_name; else user = "nobody"; } /* build the prompt string */ snprintf(prompt, sizeof (prompt), gettext("passphrase for %s to access %s: "), user, svc_name); /* ask for the passphrase */ if ((passphrase = getpassphrase(prompt)) != NULL) papiServiceSetPassword(svc, passphrase); return (0); } /*ARGSUSED*/ int main(int ac, char *av[]) { papi_status_t status; papi_service_t svc = NULL; papi_job_t *jobs = NULL; char *svc_name = NULL; char *pname = "unknown"; int c; while ((c = getopt(ac, av, "s:p:")) != EOF) switch (c) { case 's': svc_name = optarg; break; case 'p': pname = optarg; break; } status = papiServiceCreate(&svc, svc_name, NULL, NULL, authCB, PAPI_ENCRYPT_NEVER, NULL); if (status != PAPI_OK) { printf("papiServiceCreate(%s): %s\ ", svc_name ? svc_name : "NULL", papiStatusString(status)); papiServiceDestroy(svc); exit(1); } status = papiPrinterListJobs(svc, pname, NULL, 0, 0, &jobs); if (status != PAPI_OK) { printf("papiPrinterListJobs(%s): %s\ ", pname, papiStatusString(status)); papiServiceDestroy(svc); exit(1); } if (jobs != NULL) { int i; for (i = 0; jobs[i] != NULL; i++) { papi_attribute_t **list = papiJobGetAttributeList(jobs[i]); if (list != NULL) { char *name = "unknown"; int32_t id = 0; char *buffer = NULL; size_t size = 0; (void) papiAttributeListGetString(list, NULL, "printer-name", &name); (void) papiAttributeListGetInteger(list, NULL, "job-id", &id); while (papiAttributeListToString(list, "\ \\t", buffer, size) != PAPI_OK) buffer = realloc(buffer, size += BUFSIZ); printf("%s-%d:\ \\t%s\ ", name, id, buffer); free(buffer); } } papiJobListFree(jobs); } papiServiceDestroy(svc); exit(0); }
Example 2 Dump all job attributes.
/* * program to dump a queued job's attributes using PAPI interfaces. */ #include <stdio.h> #include <stdlib.h> #include <unistd.h> #include <libintl.h> #include <pwd.h> #include <papi.h> static int authCB(papi_service_t svc, void *app_data) { char prompt[BUFSIZ]; char *user, *svc_name, *passphrase; /* get the name of the service we are contacting */ if ((svc_name = papiServiceGetServiceName(svc)) == NULL) return (-1); /* find out who we are supposed to be */ if ((user = papiServiceGetUserName(svc)) == NULL) { struct passwd *pw; if ((pw = getpwuid(getuid())) != NULL) user = pw->pw_name; else user = "nobody"; } /* build the prompt string */ snprintf(prompt, sizeof (prompt), gettext("passphrase for %s to access %s: "), user, svc_name); /* ask for the passphrase */ if ((passphrase = getpassphrase(prompt)) != NULL) papiServiceSetPassword(svc, passphrase); return (0); } /*ARGSUSED*/ int main(int ac, char *av[]) { papi_status_t status; papi_service_t svc = NULL; papi_job_t job = NULL; char *svc_name = NULL; char *pname = "unknown"; int id = 0; int c; while ((c = getopt(ac, av, "s:p:j:")) != EOF) switch (c) { case 's': svc_name = optarg; break; case 'p': pname = optarg; break; case 'j': id = atoi(optarg); break; } status = papiServiceCreate(&svc, svc_name, NULL, NULL, authCB, PAPI_ENCRYPT_NEVER, NULL); if (status != PAPI_OK) { printf("papiServiceCreate(%s): %s\ ", svc_name ? svc_name : "NULL", papiStatusString(status)); papiServiceDestroy(svc); exit(1); } status = papiJobQuery(svc, pname, id, NULL, &job); if ((status == PAPI_OK) && (job != NULL)) { papi_attribute_t **list = papiJobGetAttributeList(job); if (list != NULL) { char *name = "unknown"; int32_t id = 0; char *buffer = NULL; size_t size = 0; (void) papiAttributeListGetString(list, NULL, "printer-name", &name); (void) papiAttributeListGetInteger(list, NULL, "job-id", &id); while (papiAttributeListToString(list, "\ \\t", buffer, size) != PAPI_OK) buffer = realloc(buffer, size += BUFSIZ); printf("%s-%d:\ \\t%s\ ", name, id, buffer); free(buffer); } } else printf("papiJobQuery(%s-%d): %s\ ", pname, id, papiStatusString(status)); papiJobFree(job); papiServiceDestroy(svc); exit(0); }
Example 3 Submit a job (stream).
/* * program to submit a job from standard input. */ #include <stdio.h> #include <stdlib.h> #include <unistd.h> #include <libintl.h> #include <pwd.h> #include <papi.h> static int authCB(papi_service_t svc, void *app_data) { char prompt[BUFSIZ]; char *user, *svc_name, *passphrase; /* get the name of the service we are contacting */ if ((svc_name = papiServiceGetServiceName(svc)) == NULL) return (-1); /* find out who we are supposed to be */ if ((user = papiServiceGetUserName(svc)) == NULL) { struct passwd *pw; if ((pw = getpwuid(getuid())) != NULL) user = pw->pw_name; else user = "nobody"; } /* build the prompt string */ snprintf(prompt, sizeof (prompt), gettext("passphrase for %s to access %s: "), user, svc_name); /* ask for the passphrase */ if ((passphrase = getpassphrase(prompt)) != NULL) papiServiceSetPassword(svc, passphrase); return (0); } /*ARGSUSED*/ int main(int ac, char *av[]) { papi_status_t status; papi_service_t svc = NULL; papi_stream_t stream = NULL; papi_job_t job = NULL; papi_attribute_t **attrs = NULL; char *svc_name = NULL; char *pname = "unknown"; int id = 0; int c; int rc; char buf[BUFSIZ]; while ((c = getopt(ac, av, "s:p:")) != EOF) switch (c) { case 's': svc_name = optarg; break; case 'p': pname = optarg; break; } status = papiServiceCreate(&svc, svc_name, NULL, NULL, authCB, PAPI_ENCRYPT_NEVER, NULL); if (status != PAPI_OK) { printf("papiServiceCreate(%s): %s\ ", svc_name ? svc_name : "NULL", papiStatusString(status)); papiServiceDestroy(svc); exit(1); } papiAttributeListAddInteger(&attrs, PAPI_ATTR_EXCL, "copies", 1); papiAttributeListAddString(&attrs, PAPI_ATTR_EXCL, "document-format", "application/octet-stream"); papiAttributeListAddString(&attrs, PAPI_ATTR_EXCL, "job-title", "Standard Input"); status = papiJobStreamOpen(svc, pname, attrs, NULL, &stream); while ((status == PAPI_OK) && ((rc = read(0, buf, sizeof (buf))) > 0)) status = papiJobStreamWrite(svc, stream, buf, rc); if (status == PAPI_OK) status = papiJobStreamClose(svc, stream, &job); if ((status == PAPI_OK) && (job != NULL)) { papi_attribute_t **list = papiJobGetAttributeList(job); if (list != NULL) { char *name = "unknown"; int32_t id = 0; char *buffer = NULL; size_t size = 0; (void) papiAttributeListGetString(list, NULL, "printer-name", &name); (void) papiAttributeListGetInteger(list, NULL, "job-id", &id); while (papiAttributeListToString(list, "\ \\t", buffer, size) != PAPI_OK) buffer = realloc(buffer, size += BUFSIZ); printf("%s-%d:\ \\t%s\ ", name, id, buffer); free(buffer); } } else printf("papiJobStream*(%s-%d): %s\ ", pname, id, papiStatusString(status)); papiJobFree(job); papiServiceDestroy(svc); exit(0); }
See attributes(5) for descriptions of the following attributes:
|
libpapi(3LIB), papiAttributeListAddValue(3PAPI), attributes(5)