Colin Walters
2c326d705e
Particularly when HTTP requests fail, I really want a lot more information. We could theoretically stuff it into the `GError` message field, but that gets ugly *fast*. Using the systemd journal allows us to log things in a structured fashion. Right now e.g. rpm-ostree won't be aware of this additional information, but I think we could teach it to be down the line. In the short term, users can learn to find it from `systemctl status rpm-ostreed` or `journalctl -b -r -u rpm-ostreed`, etc. One thing I'd like to do next is log successful fetches of e.g. commit objects as well with more information about the originating server (things like the final URL if we were redirected, did we use TLS pinning, what was the negotiated TLS version+cipher, etc). Closes: #708 Approved by: jlebon
145 lines
5.7 KiB
C
145 lines
5.7 KiB
C
/* -*- mode: C; c-file-style: "gnu"; indent-tabs-mode: nil; -*-
|
|
*
|
|
* Copyright (C) 2012 Colin Walters <walters@verbum.org>
|
|
*
|
|
* This library is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU Lesser General Public
|
|
* License as published by the Free Software Foundation; either
|
|
* version 2 of the License, or (at your option) any later version.
|
|
*
|
|
* This library 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
|
|
* Lesser General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Lesser General Public
|
|
* License along with this library; if not, write to the
|
|
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
|
|
* Boston, MA 02111-1307, USA.
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#ifndef __GI_SCANNER__
|
|
|
|
#include "libglnx.h"
|
|
|
|
G_BEGIN_DECLS
|
|
|
|
#define OSTREE_TYPE_FETCHER (_ostree_fetcher_get_type ())
|
|
#define OSTREE_FETCHER(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), OSTREE_TYPE_FETCHER, OstreeFetcher))
|
|
#define OSTREE_FETCHER_CLASS(k) (G_TYPE_CHECK_CLASS_CAST((k), OSTREE_TYPE_FETCHER, OstreeFetcherClass))
|
|
#define OSTREE_IS_FETCHER(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), OSTREE_TYPE_FETCHER))
|
|
#define OSTREE_IS_FETCHER_CLASS(k) (G_TYPE_CHECK_CLASS_TYPE ((k), OSTREE_TYPE_FETCHER))
|
|
#define OSTREE_FETCHER_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), OSTREE_TYPE_FETCHER, OstreeFetcherClass))
|
|
|
|
/* Lower values have higher priority */
|
|
#define OSTREE_FETCHER_DEFAULT_PRIORITY 0
|
|
|
|
typedef struct OstreeFetcherURI OstreeFetcherURI;
|
|
|
|
typedef struct OstreeFetcherClass OstreeFetcherClass;
|
|
typedef struct OstreeFetcher OstreeFetcher;
|
|
|
|
struct OstreeFetcherClass
|
|
{
|
|
GObjectClass parent_class;
|
|
};
|
|
|
|
typedef enum {
|
|
OSTREE_FETCHER_FLAGS_NONE = 0,
|
|
OSTREE_FETCHER_FLAGS_TLS_PERMISSIVE = (1 << 0)
|
|
} OstreeFetcherConfigFlags;
|
|
|
|
void
|
|
_ostree_fetcher_uri_free (OstreeFetcherURI *uri);
|
|
G_DEFINE_AUTOPTR_CLEANUP_FUNC(OstreeFetcherURI, _ostree_fetcher_uri_free)
|
|
|
|
OstreeFetcherURI *
|
|
_ostree_fetcher_uri_parse (const char *str,
|
|
GError **error);
|
|
|
|
OstreeFetcherURI *
|
|
_ostree_fetcher_uri_clone (OstreeFetcherURI *uri);
|
|
|
|
OstreeFetcherURI *
|
|
_ostree_fetcher_uri_new_path (OstreeFetcherURI *uri,
|
|
const char *subpath);
|
|
|
|
OstreeFetcherURI *
|
|
_ostree_fetcher_uri_new_subpath (OstreeFetcherURI *uri,
|
|
const char *subpath);
|
|
|
|
char *
|
|
_ostree_fetcher_uri_get_scheme (OstreeFetcherURI *uri);
|
|
|
|
char *
|
|
_ostree_fetcher_uri_get_path (OstreeFetcherURI *uri);
|
|
|
|
char *
|
|
_ostree_fetcher_uri_to_string (OstreeFetcherURI *uri);
|
|
|
|
GType _ostree_fetcher_get_type (void) G_GNUC_CONST;
|
|
|
|
OstreeFetcher *_ostree_fetcher_new (int tmpdir_dfd,
|
|
const char *remote_name,
|
|
OstreeFetcherConfigFlags flags);
|
|
|
|
int _ostree_fetcher_get_dfd (OstreeFetcher *fetcher);
|
|
|
|
void _ostree_fetcher_set_cookie_jar (OstreeFetcher *self,
|
|
const char *jar_path);
|
|
|
|
void _ostree_fetcher_set_proxy (OstreeFetcher *fetcher,
|
|
const char *proxy);
|
|
|
|
void _ostree_fetcher_set_client_cert (OstreeFetcher *fetcher,
|
|
const char *cert_path,
|
|
const char *key_path);
|
|
|
|
void _ostree_fetcher_set_tls_database (OstreeFetcher *self,
|
|
const char *tlsdb_path);
|
|
|
|
void _ostree_fetcher_set_extra_headers (OstreeFetcher *self,
|
|
GVariant *extra_headers);
|
|
|
|
guint64 _ostree_fetcher_bytes_transferred (OstreeFetcher *self);
|
|
|
|
void _ostree_fetcher_request_to_tmpfile (OstreeFetcher *self,
|
|
GPtrArray *mirrorlist,
|
|
const char *filename,
|
|
guint64 max_size,
|
|
int priority,
|
|
GCancellable *cancellable,
|
|
GAsyncReadyCallback callback,
|
|
gpointer user_data);
|
|
|
|
gboolean _ostree_fetcher_request_to_tmpfile_finish (OstreeFetcher *self,
|
|
GAsyncResult *result,
|
|
char **out_filename,
|
|
GError **error);
|
|
|
|
typedef enum {
|
|
OSTREE_FETCHER_REQUEST_NUL_TERMINATION = (1 << 0)
|
|
} OstreeFetcherRequestFlags;
|
|
|
|
void _ostree_fetcher_request_to_membuf (OstreeFetcher *self,
|
|
GPtrArray *mirrorlist,
|
|
const char *filename,
|
|
OstreeFetcherRequestFlags flags,
|
|
guint64 max_size,
|
|
int priority,
|
|
GCancellable *cancellable,
|
|
GAsyncReadyCallback callback,
|
|
gpointer user_data);
|
|
|
|
gboolean _ostree_fetcher_request_to_membuf_finish (OstreeFetcher *self,
|
|
GAsyncResult *result,
|
|
GBytes **out_buf,
|
|
GError **error);
|
|
|
|
|
|
G_END_DECLS
|
|
|
|
#endif
|