thodg/libgit2/include/git2/sys/stream.h

• Show log

  Commit

• Hash : 43b592ac
  Author :
  Date : 2018-10-25T08:49:01
  

  tls: introduce a wrap function
  
  Introduce `git_tls_stream_wrap` which will take an existing `stream`
  with an already connected socket and begin speaking TLS on top of it.
  This is useful if you've built a connection to a proxy server and you
  wish to begin CONNECT over it to tunnel a TLS connection.
  
  Also update the pluggable TLS stream layer so that it can accept a
  registration structure that provides an `init` and `wrap` function,
  instead of a single initialization function.
  

Download

• include/git2/sys/stream.h

• /*
   * Copyright (C) the libgit2 contributors. All rights reserved.
   *
   * This file is part of libgit2, distributed under the GNU GPL v2 with
   * a Linking Exception. For full terms see the included COPYING file.
   */
  #ifndef INCLUDE_sys_git_stream_h__
  #define INCLUDE_sys_git_stream_h__
  
  #include "git2/common.h"
  #include "git2/types.h"
  #include "git2/proxy.h"
  
  GIT_BEGIN_DECL
  
  #define GIT_STREAM_VERSION 1
  
  /**
   * Every stream must have this struct as its first element, so the
   * API can talk to it. You'd define your stream as
   *
   *     struct my_stream {
   *             git_stream parent;
   *             ...
   *     }
   *
   * and fill the functions
   */
  typedef struct git_stream {
  	int version;
  
  	int encrypted;
  	int proxy_support;
  	int (*connect)(struct git_stream *);
  	int (*certificate)(git_cert **, struct git_stream *);
  	int (*set_proxy)(struct git_stream *, const git_proxy_options *proxy_opts);
  	ssize_t (*read)(struct git_stream *, void *, size_t);
  	ssize_t (*write)(struct git_stream *, const char *, size_t, int);
  	int (*close)(struct git_stream *);
  	void (*free)(struct git_stream *);
  } git_stream;
  
  typedef struct {
  	/** The `version` field should be set to `GIT_STREAM_VERSION`. */
  	int version;
  
  	/**
  	 * Called to create a new TLS connection to a given host.
  	 *
  	 * @param out The created TLS stream
  	 * @param host The hostname to connect to; may be a hostname or
  	 *             IP address
  	 * @param port The port to connect to; may be a port number or
  	 *             service name
  	 * @return 0 or an error code
  	 */
  	int (*init)(git_stream **out, const char *host, const char *port);
  
  	/**
  	 * Called to create a new TLS connection on top of the given
  	 * stream.  May be used to proxy a TLS stream over a CONNECT
  	 * session.
  	 *
  	 * @param out The created TLS stream
  	 * @param in An existing stream to add TLS to
  	 * @param host The hostname that the stream is connected to,
  	 *             for certificate validation
  	 * @return 0 or an error code
  	 */
  	int (*wrap)(git_stream **out, git_stream *in, const char *host);
  } git_stream_registration;
  
  /**
   * Register TLS stream constructors for the library to use
   *
   * If a registration structure is already set, it will be overwritten.
   * Pass `NULL` in order to deregister the current constructor and return
   * to the system defaults.
   *
   * @param registration the registration data
   * @return 0 or an error code
   */
  GIT_EXTERN(int) git_stream_register_tls(
  	git_stream_registration *registration);
  
  GIT_END_DECL
  
  #endif
  

Download