summaryrefslogtreecommitdiffstats
path: root/src/vlib/dir.dox
blob: 4806e7a91c6f77419de292bf0f1e5f7841111219 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
/*
 * Copyright (c) 2016 Cisco and/or its affiliates.
 * Copyright (c) 2016 Comcast Cable Communications Management, LLC.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at:
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
/* Doxygen directory documentation */
/**
@dir
@brief VLIB application library source.
*/
/*? %%clicmd:group_label VLIB application library%% ?*/
Literal.Number.Oct */ .highlight .sa { color: #e6db74 } /* Literal.String.Affix */ .highlight .sb { color: #e6db74 } /* Literal.String.Backtick */ .highlight .sc { color: #e6db74 } /* Literal.String.Char */ .highlight .dl { color: #e6db74 } /* Literal.String.Delimiter */ .highlight .sd { color: #e6db74 } /* Literal.String.Doc */ .highlight .s2 { color: #e6db74 } /* Literal.String.Double */ .highlight .se { color: #ae81ff } /* Literal.String.Escape */ .highlight .sh { color: #e6db74 } /* Literal.String.Heredoc */ .highlight .si { color: #e6db74 } /* Literal.String.Interpol */ .highlight .sx { color: #e6db74 } /* Literal.String.Other */ .highlight .sr { color: #e6db74 } /* Literal.String.Regex */ .highlight .s1 { color: #e6db74 } /* Literal.String.Single */ .highlight .ss { color: #e6db74 } /* Literal.String.Symbol */ .highlight .bp { color: #f8f8f2 } /* Name.Builtin.Pseudo */ .highlight .fm { color: #a6e22e } /* Name.Function.Magic */ .highlight .vc { color: #f8f8f2 } /* Name.Variable.Class */ .highlight .vg { color: #f8f8f2 } /* Name.Variable.Global */ .highlight .vi { color: #f8f8f2 } /* Name.Variable.Instance */ .highlight .vm { color: #f8f8f2 } /* Name.Variable.Magic */ .highlight .il { color: #ae81ff } /* Literal.Number.Integer.Long */ } @media (prefers-color-scheme: light) { .highlight .hll { background-color: #ffffcc } .highlight .c { color: #888888 } /* Comment */ .highlight .err { color: #a61717; background-color: #e3d2d2 } /* Error */ .highlight .k { color: #008800; font-weight: bold } /* Keyword */ .highlight .ch { color: #888888 } /* Comment.Hashbang */ .highlight .cm { color: #888888 } /* Comment.Multiline */ .highlight .cp { color: #cc0000; font-weight: bold } /* Comment.Preproc */ .highlight .cpf { color: #888888 } /* Comment.PreprocFile */ .highlight .c1 { color: #888888 } /* Comment.Single */ .highlight .cs { color: #cc0000; font-weight: bold; background-color: #fff0f0 } /* Comment.Special */ .highlight .gd { color: #000000; background-color: #ffdddd } /* Generic.Deleted */ .highlight .ge { font-style: italic } /* Generic.Emph */ .highlight .gr { color: #aa0000 } /* Generic.Error */ .highlight .gh { color: #333333 } /* Generic.Heading */ .highlight .gi { color: #000000; background-color: #ddffdd } /* Generic.Inserted */ .highlight .go { color: #888888 } /* Generic.Output */ .highlight .gp { color: #555555 } /* Generic.Prompt */ .highlight .gs { font-weight: bold } /* Generic.Strong */ .highlight .gu { color: #666666 } /* Generic.Subheading */ .highlight .gt { color: #aa0000 } /* Generic.Traceback */ .highlight .kc { color: #008800; font-weight: bold } /* Keyword.Constant */ .highlight .kd { color: #008800; font-weight: bold } /* Keyword.Declaration */ .highlight .kn { color: #008800; font-weight: bold } /* Keyword.Namespace */ .highlight .kp { color: #008800 } /* Keyword.Pseudo */ .highlight .kr { color: #008800; font-weight: bold } /* Keyword.Reserved */ .highlight .kt { color: #888888; font-weight: bold } /* Keyword.Type */ .highlight .m { color: #0000DD; font-weight: bold } /* Literal.Number */ .highlight .s { color: #dd2200; background-color: #fff0f0 } /* Literal.String */ .highlight .na { color: #336699 } /* Name.Attribute */ .highlight .nb { color: #003388 } /* Name.Builtin */ .highlight .nc { color: #bb0066; font-weight: bold } /* Name.Class */ .highlight .no { color: #003366; font-weight: bold } /* Name.Constant */ .highlight .nd { color: #555555 } /* Name.Decorator */ .highlight .ne { color: #bb0066; font-weight: bold } /* Name.Exception */ .highlight .nf { color: #0066bb; font-weight: bold } /* Name.Function */ .highlight .nl { color: #336699; font-style: italic } /* Name.Label */ .highlight .nn { color: #bb0066; font-weight: bold } /* Name.Namespace */ .highlight .py { color: #336699; font-weight: bold } /* Name.Property */ .highlight .nt { color: #bb0066; font-weight: bold } /* Name.Tag */ .highlight .nv { color: #336699 } /* Name.Variable */ .highlight .ow { color: #008800 } /* Operator.Word */ .highlight .w { color: #bbbbbb } /* Text.Whitespace */ .highlight .mb { color: #0000DD; font-weight: bold } /* Literal.Number.Bin */ .highlight .mf { color: #0000DD; font-weight: bold } /* Literal.Number.Float */ .highlight .mh { color: #0000DD; font-weight: bold } /* Literal.Number.Hex */ .highlight .mi { color: #0000DD; font-weight: bold } /* Literal.Number.Integer */ .highlight .mo { color: #0000DD; font-weight: bold } /* Literal.Number.Oct */ .highlight .sa { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Affix */ .highlight .sb { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Backtick */ .highlight .sc { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Char */ .highlight .dl { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Delimiter */ .highlight .sd { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Doc */ .highlight .s2 { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Double */ .highlight .se { color: #0044dd; background-color: #fff0f0 } /* Literal.String.Escape */ .highlight .sh { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Heredoc */ .highlight .si { color: #3333bb; background-color: #fff0f0 } /* Literal.String.Interpol */ .highlight .sx { color: #22bb22; background-color: #f0fff0 } /* Literal.String.Other */ .highlight .sr { color: #008800; background-color: #fff0ff } /* Literal.String.Regex */ .highlight .s1 { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Single */ .highlight .ss { color: #aa6600; background-color: #fff0f0 } /* Literal.String.Symbol */ .highlight .bp { color: #003388 } /* Name.Builtin.Pseudo */ .highlight .fm { color: #0066bb; font-weight: bold } /* Name.Function.Magic */ .highlight .vc { color: #336699 } /* Name.Variable.Class */ .highlight .vg { color: #dd7700 } /* Name.Variable.Global */ .highlight .vi { color: #3333bb } /* Name.Variable.Instance */ .highlight .vm { color: #336699 } /* Name.Variable.Magic */ .highlight .il { color: #0000DD; font-weight: bold } /* Literal.Number.Integer.Long */ }
/*
 * Copyright (c) 2019 Cisco and/or its affiliates.
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at:
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

#include <quic/quic.h>

#include <quicly.h>
#include <quicly/constants.h>

u8 *
quic_format_err (u8 * s, va_list * args)
{
  u64 code = va_arg (*args, u64);
  switch (code)
    {
    case 0:
      s = format (s, "no error");
      break;
      /* app errors */
    case QUIC_ERROR_FULL_FIFO:
      s = format (s, "full fifo");
      break;
    case QUIC_APP_ERROR_CLOSE_NOTIFY:
      s = format (s, "QUIC_APP_ERROR_CLOSE_NOTIFY");
      break;
    case QUIC_APP_ALLOCATION_ERROR:
      s = format (s, "QUIC_APP_ALLOCATION_ERROR");
      break;
    case QUIC_APP_ACCEPT_NOTIFY_ERROR:
      s = format (s, "QUIC_APP_ACCEPT_NOTIFY_ERROR");
      break;
    case QUIC_APP_CONNECT_NOTIFY_ERROR:
      s = format (s, "QUIC_APP_CONNECT_NOTIFY_ERROR");
      break;
      /* quicly errors */
    case QUICLY_ERROR_PACKET_IGNORED:
      s = format (s, "QUICLY_ERROR_PACKET_IGNORED");
      break;
    case QUICLY_ERROR_SENDBUF_FULL:
      s = format (s, "QUICLY_ERROR_SENDBUF_FULL");
      break;
    case QUICLY_ERROR_FREE_CONNECTION:
      s = format (s, "QUICLY_ERROR_FREE_CONNECTION");
      break;
    case QUICLY_ERROR_RECEIVED_STATELESS_RESET:
      s = format (s, "QUICLY_ERROR_RECEIVED_STATELESS_RESET");
      break;
    case QUICLY_TRANSPORT_ERROR_NONE:
      s = format (s, "QUICLY_TRANSPORT_ERROR_NONE");
      break;
    case QUICLY_TRANSPORT_ERROR_INTERNAL:
      s = format (s, "QUICLY_TRANSPORT_ERROR_INTERNAL");
      break;
    case QUICLY_TRANSPORT_ERROR_SERVER_BUSY:
      s = format (s, "QUICLY_TRANSPORT_ERROR_SERVER_BUSY");
      break;
    case QUICLY_TRANSPORT_ERROR_FLOW_CONTROL:
      s = format (s, "QUICLY_TRANSPORT_ERROR_FLOW_CONTROL");
      break;
    case QUICLY_TRANSPORT_ERROR_STREAM_LIMIT:
      s = format (s, "QUICLY_TRANSPORT_ERROR_STREAM_LIMIT");
      break;
    case QUICLY_TRANSPORT_ERROR_STREAM_STATE:
      s = format (s, "QUICLY_TRANSPORT_ERROR_STREAM_STATE");
      break;
    case QUICLY_TRANSPORT_ERROR_FINAL_SIZE:
      s = format (s, "QUICLY_TRANSPORT_ERROR_FINAL_SIZE");
      break;
    case QUICLY_TRANSPORT_ERROR_FRAME_ENCODING:
      s = format (s, "QUICLY_TRANSPORT_ERROR_FRAME_ENCODING");
      break;
    case QUICLY_TRANSPORT_ERROR_TRANSPORT_PARAMETER:
      s = format (s, "QUICLY_TRANSPORT_ERROR_TRANSPORT_PARAMETER");
      break;
    case QUICLY_ERROR_NO_COMPATIBLE_VERSION:
      s = format (s, "QUICLY_ERROR_NO_COMPATIBLE_VERSION");
      break;
    case QUICLY_TRANSPORT_ERROR_PROTOCOL_VIOLATION:
      s = format (s, "QUICLY_TRANSPORT_ERROR_PROTOCOL_VIOLATION");
      break;
    case QUICLY_TRANSPORT_ERROR_CRYPTO_BUFFER_EXCEEDED:
      s = format (s, "QUICLY_TRANSPORT_ERROR_CRYPTO_BUFFER_EXCEEDED");
      break;
      /* picotls errors */
    case QUICLY_TRANSPORT_ERROR_TLS_ALERT_BASE + PTLS_ERROR_TO_ALERT (PTLS_ALERT_CLOSE_NOTIFY):
      s =
        format (s, "PTLS_ALERT_CLOSE_NOTIFY");
      break;
    case QUICLY_TRANSPORT_ERROR_TLS_ALERT_BASE + PTLS_ERROR_TO_ALERT (PTLS_ALERT_UNEXPECTED_MESSAGE):
      s =
        format (s, "PTLS_ALERT_UNEXPECTED_MESSAGE");
      break;
    case QUICLY_TRANSPORT_ERROR_TLS_ALERT_BASE + PTLS_ERROR_TO_ALERT (PTLS_ALERT_BAD_RECORD_MAC):
      s =
        format (s, "PTLS_ALERT_BAD_RECORD_MAC");
      break;
    case QUICLY_TRANSPORT_ERROR_TLS_ALERT_BASE + PTLS_ERROR_TO_ALERT (PTLS_ALERT_HANDSHAKE_FAILURE):
      s =
        format (s, "PTLS_ALERT_HANDSHAKE_FAILURE");
      break;
    case QUICLY_TRANSPORT_ERROR_TLS_ALERT_BASE + PTLS_ERROR_TO_ALERT (PTLS_ALERT_BAD_CERTIFICATE):
      s =
        format (s, "PTLS_ALERT_BAD_CERTIFICATE");
      break;
    case QUICLY_TRANSPORT_ERROR_TLS_ALERT_BASE + PTLS_ERROR_TO_ALERT (PTLS_ALERT_CERTIFICATE_REVOKED):
      s =
        format (s, "PTLS_ALERT_CERTIFICATE_REVOKED");
      break;
    case QUICLY_TRANSPORT_ERROR_TLS_ALERT_BASE + PTLS_ERROR_TO_ALERT (PTLS_ALERT_CERTIFICATE_EXPIRED):
      s =
        format (s, "PTLS_ALERT_CERTIFICATE_EXPIRED");
      break;
    case QUICLY_TRANSPORT_ERROR_TLS_ALERT_BASE + PTLS_ERROR_TO_ALERT (PTLS_ALERT_CERTIFICATE_UNKNOWN):
      s =
        format (s, "PTLS_ALERT_CERTIFICATE_UNKNOWN");
      break;
    case QUICLY_TRANSPORT_ERROR_TLS_ALERT_BASE + PTLS_ERROR_TO_ALERT (PTLS_ALERT_ILLEGAL_PARAMETER):
      s =
        format (s, "PTLS_ALERT_ILLEGAL_PARAMETER");
      break;
    case QUICLY_TRANSPORT_ERROR_TLS_ALERT_BASE + PTLS_ERROR_TO_ALERT (PTLS_ALERT_UNKNOWN_CA):
      s =
        format (s, "PTLS_ALERT_UNKNOWN_CA");
      break;
    case QUICLY_TRANSPORT_ERROR_TLS_ALERT_BASE + PTLS_ERROR_TO_ALERT (PTLS_ALERT_DECODE_ERROR):
      s =
        format (s, "PTLS_ALERT_DECODE_ERROR");
      break;
    case QUICLY_TRANSPORT_ERROR_TLS_ALERT_BASE + PTLS_ERROR_TO_ALERT (PTLS_ALERT_DECRYPT_ERROR):
      s =
        format (s, "PTLS_ALERT_DECRYPT_ERROR");
      break;
    case QUICLY_TRANSPORT_ERROR_TLS_ALERT_BASE + PTLS_ERROR_TO_ALERT (PTLS_ALERT_PROTOCOL_VERSION):
      s =
        format (s, "PTLS_ALERT_PROTOCOL_VERSION");
      break;
    case QUICLY_TRANSPORT_ERROR_TLS_ALERT_BASE + PTLS_ERROR_TO_ALERT (PTLS_ALERT_INTERNAL_ERROR):
      s =
        format (s, "PTLS_ALERT_INTERNAL_ERROR");
      break;
    case QUICLY_TRANSPORT_ERROR_TLS_ALERT_BASE + PTLS_ERROR_TO_ALERT (PTLS_ALERT_USER_CANCELED):
      s =
        format (s, "PTLS_ALERT_USER_CANCELED");
      break;
    case QUICLY_TRANSPORT_ERROR_TLS_ALERT_BASE + PTLS_ERROR_TO_ALERT (PTLS_ALERT_MISSING_EXTENSION):
      s =
        format (s, "PTLS_ALERT_MISSING_EXTENSION");
      break;
    case QUICLY_TRANSPORT_ERROR_TLS_ALERT_BASE + PTLS_ERROR_TO_ALERT (PTLS_ALERT_UNRECOGNIZED_NAME):
      s =
        format (s, "PTLS_ALERT_UNRECOGNIZED_NAME");
      break;
    case QUICLY_TRANSPORT_ERROR_TLS_ALERT_BASE + PTLS_ERROR_TO_ALERT (PTLS_ALERT_CERTIFICATE_REQUIRED):
      s =
        format (s, "PTLS_ALERT_CERTIFICATE_REQUIRED");
      break;
    case QUICLY_TRANSPORT_ERROR_TLS_ALERT_BASE + PTLS_ERROR_TO_ALERT (PTLS_ALERT_NO_APPLICATION_PROTOCOL):
      s =
        format (s, "PTLS_ALERT_NO_APPLICATION_PROTOCOL");
      break;
    case QUICLY_TRANSPORT_ERROR_TLS_ALERT_BASE + PTLS_ERROR_TO_ALERT (PTLS_ERROR_NO_MEMORY):
      s =
        format (s, "PTLS_ERROR_NO_MEMORY");
      break;
    case QUICLY_TRANSPORT_ERROR_TLS_ALERT_BASE + PTLS_ERROR_TO_ALERT (PTLS_ERROR_IN_PROGRESS):
      s =
        format (s, "PTLS_ERROR_IN_PROGRESS");
      break;
    case QUICLY_TRANSPORT_ERROR_TLS_ALERT_BASE + PTLS_ERROR_TO_ALERT (PTLS_ERROR_LIBRARY):
      s =
        format (s, "PTLS_ERROR_LIBRARY");
      break;
    case QUICLY_TRANSPORT_ERROR_TLS_ALERT_BASE + PTLS_ERROR_TO_ALERT (PTLS_ERROR_INCOMPATIBLE_KEY):
      s =
        format (s, "PTLS_ERROR_INCOMPATIBLE_KEY");
      break;
    case QUICLY_TRANSPORT_ERROR_TLS_ALERT_BASE + PTLS_ERROR_TO_ALERT (PTLS_ERROR_SESSION_NOT_FOUND):
      s =
        format (s, "PTLS_ERROR_SESSION_NOT_FOUND");
      break;
    case QUICLY_TRANSPORT_ERROR_TLS_ALERT_BASE + PTLS_ERROR_TO_ALERT (PTLS_ERROR_STATELESS_RETRY):
      s =
        format (s, "PTLS_ERROR_STATELESS_RETRY");
      break;
    case QUICLY_TRANSPORT_ERROR_TLS_ALERT_BASE + PTLS_ERROR_TO_ALERT (PTLS_ERROR_NOT_AVAILABLE):
      s =
        format (s, "PTLS_ERROR_NOT_AVAILABLE");
      break;
    case QUICLY_TRANSPORT_ERROR_TLS_ALERT_BASE + PTLS_ERROR_TO_ALERT (PTLS_ERROR_COMPRESSION_FAILURE):
      s =
        format (s, "PTLS_ERROR_COMPRESSION_FAILURE");
      break;
    case QUICLY_TRANSPORT_ERROR_TLS_ALERT_BASE + PTLS_ERROR_TO_ALERT (PTLS_ERROR_BER_INCORRECT_ENCODING):
      s =
        format (s, "PTLS_ERROR_BER_INCORRECT_ENCODING");
      break;
    case QUICLY_TRANSPORT_ERROR_TLS_ALERT_BASE + PTLS_ERROR_TO_ALERT (PTLS_ERROR_BER_MALFORMED_TYPE):
      s =
        format (s, "PTLS_ERROR_BER_MALFORMED_TYPE");
      break;
    case QUICLY_TRANSPORT_ERROR_TLS_ALERT_BASE + PTLS_ERROR_TO_ALERT (PTLS_ERROR_BER_MALFORMED_LENGTH):
      s =
        format (s, "PTLS_ERROR_BER_MALFORMED_LENGTH");
      break;
    case QUICLY_TRANSPORT_ERROR_TLS_ALERT_BASE + PTLS_ERROR_TO_ALERT (PTLS_ERROR_BER_EXCESSIVE_LENGTH):
      s =
        format (s, "PTLS_ERROR_BER_EXCESSIVE_LENGTH");
      break;
    case QUICLY_TRANSPORT_ERROR_TLS_ALERT_BASE + PTLS_ERROR_TO_ALERT (PTLS_ERROR_BER_ELEMENT_TOO_SHORT):
      s =
        format (s, "PTLS_ERROR_BER_ELEMENT_TOO_SHORT");
      break;
    case QUICLY_TRANSPORT_ERROR_TLS_ALERT_BASE + PTLS_ERROR_TO_ALERT (PTLS_ERROR_BER_UNEXPECTED_EOC):
      s =
        format (s, "PTLS_ERROR_BER_UNEXPECTED_EOC");
      break;
    case QUICLY_TRANSPORT_ERROR_TLS_ALERT_BASE + PTLS_ERROR_TO_ALERT (PTLS_ERROR_DER_INDEFINITE_LENGTH):
      s =
        format (s, "PTLS_ERROR_DER_INDEFINITE_LENGTH");
      break;
    case QUICLY_TRANSPORT_ERROR_TLS_ALERT_BASE + PTLS_ERROR_TO_ALERT (PTLS_ERROR_INCORRECT_ASN1_SYNTAX):
      s =
        format (s, "PTLS_ERROR_INCORRECT_ASN1_SYNTAX");
      break;
    case QUICLY_TRANSPORT_ERROR_TLS_ALERT_BASE + PTLS_ERROR_TO_ALERT (PTLS_ERROR_INCORRECT_PEM_KEY_VERSION):
      s =
        format (s, "PTLS_ERROR_INCORRECT_PEM_KEY_VERSION");
      break;
    case QUICLY_TRANSPORT_ERROR_TLS_ALERT_BASE + PTLS_ERROR_TO_ALERT (PTLS_ERROR_INCORRECT_PEM_ECDSA_KEY_VERSION):
      s =
        format (s, "PTLS_ERROR_INCORRECT_PEM_ECDSA_KEY_VERSION");
      break;
    case QUICLY_TRANSPORT_ERROR_TLS_ALERT_BASE + PTLS_ERROR_TO_ALERT (PTLS_ERROR_INCORRECT_PEM_ECDSA_CURVE):
      s =
        format (s, "PTLS_ERROR_INCORRECT_PEM_ECDSA_CURVE");
      break;
    case QUICLY_TRANSPORT_ERROR_TLS_ALERT_BASE + PTLS_ERROR_TO_ALERT (PTLS_ERROR_INCORRECT_PEM_ECDSA_KEYSIZE):
      s =
        format (s, "PTLS_ERROR_INCORRECT_PEM_ECDSA_KEYSIZE");
      break;
    case QUICLY_TRANSPORT_ERROR_TLS_ALERT_BASE + PTLS_ERROR_TO_ALERT (PTLS_ERROR_INCORRECT_ASN1_ECDSA_KEY_SYNTAX):
      s =
        format (s, "PTLS_ERROR_INCORRECT_ASN1_ECDSA_KEY_SYNTAX");
      break;
    default:
      s = format (s, "unknown error 0x%lx", code);
      break;
    }
  return s;
}