gnome-control-center/panels/printers/pp-utils.h
Marek Kasik 1eb906515f printers: Use GPLv2+ for files created by Marek Kasik
This commit is related to the bug #683420.
2012-09-11 15:02:26 +02:00

298 lines
10 KiB
C

/* -*- Mode: C; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 8 -*-
*
* Copyright 2009-2010 Red Hat, Inc,
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
*
*/
#ifndef __PP_UTILS_H__
#define __PP_UTILS_H__
#include <gtk/gtk.h>
#include <cups/cups.h>
#define ALLOWED_CHARACTERS "abcdefghijklmnopqrtsuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789-_"
#define MECHANISM_BUS "org.opensuse.CupsPkHelper.Mechanism"
#define SCP_BUS "org.fedoraproject.Config.Printing"
#define SCP_PATH "/org/fedoraproject/Config/Printing"
#define SCP_IFACE "org.fedoraproject.Config.Printing"
G_BEGIN_DECLS
typedef void (*UserResponseCallback) (GtkDialog *dialog, gint response_id, gpointer user_data);
/*
* Match level of PPD driver.
*/
enum
{
PPD_NO_MATCH = 0,
PPD_GENERIC_MATCH,
PPD_CLOSE_MATCH,
PPD_EXACT_MATCH,
PPD_EXACT_CMD_MATCH
};
enum
{
ACQUISITION_METHOD_DEFAULT_CUPS_SERVER = 0,
ACQUISITION_METHOD_REMOTE_CUPS_SERVER,
ACQUISITION_METHOD_SNMP
};
typedef struct
{
gchar *ppd_name;
gchar *ppd_display_name;
gint ppd_match_level;
} PPDName;
typedef struct
{
gchar *manufacturer_name;
gchar *manufacturer_display_name;
PPDName **ppds;
gsize num_of_ppds;
} PPDManufacturerItem;
typedef struct
{
PPDManufacturerItem **manufacturers;
gsize num_of_manufacturers;
} PPDList;
gchar *get_tag_value (const gchar *tag_string,
const gchar *tag_name);
char *get_dest_attr (const char *dest_name,
const char *attr);
gchar *get_ppd_attribute (const gchar *ppd_file_name,
const gchar *attribute_name);
void cancel_cups_subscription (gint id);
gint renew_cups_subscription (gint id,
const char * const *events,
gint num_events,
gint lease_duration);
void set_local_default_printer (const gchar *printer_name);
gboolean printer_set_location (const gchar *printer_name,
const gchar *location);
gboolean printer_set_accepting_jobs (const gchar *printer_name,
gboolean accepting_jobs,
const gchar *reason);
gboolean printer_set_enabled (const gchar *printer_name,
gboolean enabled);
gboolean printer_rename (const gchar *old_name,
const gchar *new_name);
gboolean printer_delete (const gchar *printer_name);
gboolean printer_set_default (const gchar *printer_name);
gboolean printer_set_shared (const gchar *printer_name,
gboolean shared);
gboolean printer_set_job_sheets (const gchar *printer_name,
const gchar *start_sheet,
const gchar *end_sheet);
gboolean printer_set_policy (const gchar *printer_name,
const gchar *policy,
gboolean error_policy);
gboolean printer_set_users (const gchar *printer_name,
gchar **users,
gboolean allowed);
gboolean class_add_printer (const gchar *class_name,
const gchar *printer_name);
gboolean printer_is_local (cups_ptype_t printer_type,
const gchar *device_uri);
gchar *printer_get_hostname (cups_ptype_t printer_type,
const gchar *device_uri,
const gchar *printer_uri);
void printer_set_default_media_size (const gchar *printer_name);
typedef void (*PSPCallback) (gchar *printer_name,
gboolean success,
gpointer user_data);
void printer_set_ppd_async (const gchar *printer_name,
const gchar *ppd_name,
GCancellable *cancellable,
PSPCallback callback,
gpointer user_data);
void printer_set_ppd_file_async (const gchar *printer_name,
const gchar *ppd_filename,
GCancellable *cancellable,
PSPCallback callback,
gpointer user_data);
typedef void (*GPNCallback) (PPDName **names,
const gchar *printer_name,
gboolean cancelled,
gpointer user_data);
void get_ppd_names_async (gchar *printer_name,
gint count,
GCancellable *cancellable,
GPNCallback callback,
gpointer user_data);
typedef void (*GAPCallback) (PPDList *ppds,
gpointer user_data);
void get_all_ppds_async (GCancellable *cancellable,
GAPCallback callback,
gpointer user_data);
PPDList *ppd_list_copy (PPDList *list);
void ppd_list_free (PPDList *list);
enum
{
IPP_ATTRIBUTE_TYPE_INTEGER = 0,
IPP_ATTRIBUTE_TYPE_STRING,
IPP_ATTRIBUTE_TYPE_RANGE,
IPP_ATTRIBUTE_TYPE_BOOLEAN
};
typedef struct
{
gboolean boolean_value;
gchar *string_value;
gint integer_value;
gint lower_range;
gint upper_range;
} IPPAttributeValue;
typedef struct
{
gchar *attribute_name;
IPPAttributeValue *attribute_values;
gint num_of_values;
gint attribute_type;
} IPPAttribute;
typedef void (*GIACallback) (GHashTable *table,
gpointer user_data);
void get_ipp_attributes_async (const gchar *printer_name,
gchar **attributes_names,
GIACallback callback,
gpointer user_data);
IPPAttribute *ipp_attribute_copy (IPPAttribute *attr);
void ipp_attribute_free (IPPAttribute *attr);
gchar *get_standard_manufacturers_name (gchar *name);
typedef void (*PGPCallback) (const gchar *ppd_filename,
gpointer user_data);
void printer_get_ppd_async (const gchar *printer_name,
const gchar *host_name,
gint port,
PGPCallback callback,
gpointer user_data);
typedef void (*GNDCallback) (cups_dest_t *destination,
gpointer user_data);
void get_named_dest_async (const gchar *printer_name,
GNDCallback callback,
gpointer user_data);
typedef void (*PAOCallback) (gboolean success,
gpointer user_data);
void printer_add_option_async (const gchar *printer_name,
const gchar *option_name,
gchar **values,
gboolean set_default,
GCancellable *cancellable,
PAOCallback callback,
gpointer user_data);
typedef void (*CGJCallback) (cups_job_t *jobs,
gint num_of_jobs,
gpointer user_data);
void cups_get_jobs_async (const gchar *printer_name,
gboolean my_jobs,
gint which_jobs,
CGJCallback callback,
gpointer user_data);
typedef void (*JCPCallback) (gpointer user_data);
void job_cancel_purge_async (gint job_id,
gboolean job_purge,
GCancellable *cancellable,
JCPCallback callback,
gpointer user_data);
typedef void (*JSHUCallback) (gpointer user_data);
void job_set_hold_until_async (gint job_id,
const gchar *job_hold_until,
GCancellable *cancellable,
JSHUCallback callback,
gpointer user_data);
typedef struct{
gchar *device_class;
gchar *device_id;
gchar *device_info;
gchar *device_make_and_model;
gchar *device_uri;
gchar *device_location;
gchar *device_name;
gchar *device_ppd;
gchar *host_name;
gint host_port;
gint acquisition_method;
} PpPrintDevice;
void pp_print_device_free (PpPrintDevice *device);
const gchar *get_paper_size_from_locale (void);
typedef void (*GCDCallback) (GList *devices,
gboolean finished,
gboolean cancelled,
gpointer user_data);
void get_cups_devices_async (GCancellable *cancellable,
GCDCallback callback,
gpointer user_data);
G_END_DECLS
#endif /* __PP_UTILS_H */