2 * Copyright (C) 2006 John (J5) Palmieri <johnp@redhat.com>
4 * This library is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU Lesser General Public
6 * License as published by the Free Software Foundation; either
7 * version 2 of the License, or (at your option) any later version.
9 * This library is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 * Lesser General Public License for more details.
14 * You should have received a copy of the GNU Lesser General Public
15 * License along with this library. If not, see <http://www.gnu.org/licenses/>.
18 #ifndef __GTK_CUPS_UTILS_H__
19 #define __GTK_CUPS_UTILS_H__
22 #include <cups/cups.h>
23 #include <cups/language.h>
24 #include <cups/http.h>
29 typedef struct _GtkCupsRequest GtkCupsRequest;
30 typedef struct _GtkCupsResult GtkCupsResult;
31 typedef struct _GtkCupsConnectionTest GtkCupsConnectionTest;
39 GTK_CUPS_ERROR_GENERAL
50 * Direction we should be polling the http socket on.
51 * We are either reading or writting at each state.
52 * This makes it easy for mainloops to connect to poll.
63 GTK_CUPS_CONNECTION_AVAILABLE,
64 GTK_CUPS_CONNECTION_NOT_AVAILABLE,
65 GTK_CUPS_CONNECTION_IN_PROGRESS
66 } GtkCupsConnectionState;
70 GTK_CUPS_PASSWORD_NONE,
71 GTK_CUPS_PASSWORD_REQUESTED,
72 GTK_CUPS_PASSWORD_HAS,
73 GTK_CUPS_PASSWORD_APPLIED,
74 GTK_CUPS_PASSWORD_NOT_VALID
75 } GtkCupsPasswordState;
77 struct _GtkCupsRequest
79 GtkCupsRequestType type;
82 http_status_t last_status;
90 GtkCupsResult *result;
93 GtkCupsPollState poll_state;
94 guint64 bytes_received;
100 gint need_password : 1;
101 gint need_auth_info : 1;
102 gchar **auth_info_required;
104 GtkCupsPasswordState password_state;
107 struct _GtkCupsConnectionTest
109 GtkCupsConnectionState at_init;
110 http_addrlist_t *addrlist;
111 http_addrlist_t *current_addr;
112 http_addrlist_t *last_wrong_addr;
116 #define GTK_CUPS_REQUEST_START 0
117 #define GTK_CUPS_REQUEST_DONE 500
122 GTK_CUPS_POST_CONNECT = GTK_CUPS_REQUEST_START,
124 GTK_CUPS_POST_WRITE_REQUEST,
125 GTK_CUPS_POST_WRITE_DATA,
128 GTK_CUPS_POST_READ_RESPONSE,
129 GTK_CUPS_POST_DONE = GTK_CUPS_REQUEST_DONE
135 GTK_CUPS_GET_CONNECT = GTK_CUPS_REQUEST_START,
139 GTK_CUPS_GET_READ_DATA,
140 GTK_CUPS_GET_DONE = GTK_CUPS_REQUEST_DONE
143 GtkCupsRequest * gtk_cups_request_new_with_username (http_t *connection,
144 GtkCupsRequestType req_type,
148 const char *resource,
149 const char *username);
150 GtkCupsRequest * gtk_cups_request_new (http_t *connection,
151 GtkCupsRequestType req_type,
155 const char *resource);
156 void gtk_cups_request_ipp_add_string (GtkCupsRequest *request,
162 void gtk_cups_request_ipp_add_strings (GtkCupsRequest *request,
168 const char * const *values);
169 const char * gtk_cups_request_ipp_get_string (GtkCupsRequest *request,
172 gboolean gtk_cups_request_read_write (GtkCupsRequest *request,
173 gboolean connect_only);
174 GtkCupsPollState gtk_cups_request_get_poll_state (GtkCupsRequest *request);
175 void gtk_cups_request_free (GtkCupsRequest *request);
176 GtkCupsResult * gtk_cups_request_get_result (GtkCupsRequest *request);
177 gboolean gtk_cups_request_is_done (GtkCupsRequest *request);
178 void gtk_cups_request_encode_option (GtkCupsRequest *request,
181 gboolean gtk_cups_result_is_error (GtkCupsResult *result);
182 ipp_t * gtk_cups_result_get_response (GtkCupsResult *result);
183 GtkCupsErrorType gtk_cups_result_get_error_type (GtkCupsResult *result);
184 int gtk_cups_result_get_error_status (GtkCupsResult *result);
185 int gtk_cups_result_get_error_code (GtkCupsResult *result);
186 const char * gtk_cups_result_get_error_string (GtkCupsResult *result);
187 GtkCupsConnectionTest * gtk_cups_connection_test_new (const char *server);
188 GtkCupsConnectionState gtk_cups_connection_test_get_state (GtkCupsConnectionTest *test);
189 void gtk_cups_connection_test_free (GtkCupsConnectionTest *test);