129 lines · yaml
1# SPDX-License-Identifier: ((GPL-2.0 WITH Linux-syscall-note) OR BSD-3-Clause)2#3# Author: Chuck Lever <chuck.lever@oracle.com>4#5# Copyright (c) 2023, Oracle and/or its affiliates.6#7 8name: handshake9 10protocol: genetlink11 12doc: Netlink protocol to request a transport layer security handshake.13 14definitions:15 -16 type: enum17 name: handler-class18 value-start: 019 entries: [ none, tlshd, max ]20 -21 type: enum22 name: msg-type23 value-start: 024 entries: [ unspec, clienthello, serverhello ]25 -26 type: enum27 name: auth28 value-start: 029 entries: [ unspec, unauth, psk, x509 ]30 31attribute-sets:32 -33 name: x50934 attributes:35 -36 name: cert37 type: s3238 -39 name: privkey40 type: s3241 -42 name: accept43 attributes:44 -45 name: sockfd46 type: s3247 -48 name: handler-class49 type: u3250 enum: handler-class51 -52 name: message-type53 type: u3254 enum: msg-type55 -56 name: timeout57 type: u3258 -59 name: auth-mode60 type: u3261 enum: auth62 -63 name: peer-identity64 type: u3265 multi-attr: true66 -67 name: certificate68 type: nest69 nested-attributes: x50970 multi-attr: true71 -72 name: peername73 type: string74 -75 name: done76 attributes:77 -78 name: status79 type: u3280 -81 name: sockfd82 type: s3283 -84 name: remote-auth85 type: u3286 multi-attr: true87 88operations:89 list:90 -91 name: ready92 doc: Notify handlers that a new handshake request is waiting93 notify: accept94 -95 name: accept96 doc: Handler retrieves next queued handshake request97 attribute-set: accept98 flags: [ admin-perm ]99 do:100 request:101 attributes:102 - handler-class103 reply:104 attributes:105 - sockfd106 - message-type107 - timeout108 - auth-mode109 - peer-identity110 - certificate111 - peername112 -113 name: done114 doc: Handler reports handshake completion115 attribute-set: done116 do:117 request:118 attributes:119 - status120 - sockfd121 - remote-auth122 123mcast-groups:124 list:125 -126 name: none127 -128 name: tlshd129