1Net::DNS::RR::SVCB(3) User Contributed Perl DocumentationNet::DNS::RR::SVCB(3)
2
3
4

NAME

6       Net::DNS::RR::SVCB - DNS SVCB resource record
7

SYNOPSIS

9           use Net::DNS;
10           $rr = Net::DNS::RR->new('name HTTPS SvcPriority TargetName alpn=h3,...');
11

DESCRIPTION

13       DNS Service Binding (SVCB) resource record
14
15       Service binding and parameter specification via the DNS (SVCB and HTTPS
16       RRs)
17

METHODS

19       The available methods are those inherited from the base class augmented
20       by the type-specific methods defined in this package.
21
22       Use of undocumented package features or direct access to internal data
23       structures is discouraged and could result in program termination or
24       other unpredictable behaviour.
25
26   SvcPriority
27           $svcpriority = $rr->svcpriority;
28           $rr->svcpriority( $svcpriority );
29
30       The priority of this record (relative to others, with lower values
31       preferred).  A value of 0 indicates AliasMode.
32
33   TargetName
34           $rr->targetname( $targetname );
35           $effecivetarget = $rr->targetname;
36
37       The domain name of either the alias target (for AliasMode) or the
38       alternative endpoint (for ServiceMode).
39
40       For AliasMode SVCB RRs, a TargetName of "." indicates that the service
41       is not available or does not exist.
42
43       For ServiceMode SVCB RRs, a TargetName of "." indicates that the owner
44       name of this record must be used as the effective TargetName.
45
46   mandatory, alpn, no-default-alpn, port, ipv4hint, echconfig, ipv6hint
47           $rr = Net::DNS::RR->new( 'svc.example. SVCB 1 svc.example. port=1234' );
48
49           $rr->port(1234);
50           $string = $rr->port();      # \004\210
51           $rr->key3($string);
52
53       Constructor methods for mnemonic SvcParams defined in
54       draft-ietf-dnsop-svcb-https-01.  When invoked without arguments, the
55       methods return the presentation format value for the underlying key.
56       The behaviour with undefined arguments is not specified.
57
58   keyNN
59           $keynn = $rr->keyNN;
60           $rr->keyNN( $keynn );
61
62       Generic constructor and accessor methods for SvcParams.  The key index
63       NN is a decimal integer in the range 0 .. 65534.  The method argument
64       and returned value are both presentation format strings.  The method
65       returns the undefined value if the key is not present.  A (key,value)
66       pair will be ignored if the value is undefined.
67
69       Copyright (c)2020 Dick Franks.
70
71       All rights reserved.
72
73       Package template (c)2009,2012 O.M.Kolkman and R.W.Franks.
74

LICENSE

76       Permission to use, copy, modify, and distribute this software and its
77       documentation for any purpose and without fee is hereby granted,
78       provided that the above copyright notice appear in all copies and that
79       both that copyright notice and this permission notice appear in
80       supporting documentation, and that the name of the author not be used
81       in advertising or publicity pertaining to distribution of the software
82       without specific prior written permission.
83
84       THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
85       OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
86       MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
87       IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
88       CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
89       TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
90       SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
91

SEE ALSO

93       perl, Net::DNS, Net::DNS::RR, draft-ietf-dnsop-svcb-https-01
94
95
96
97perl v5.32.1                      2021-01-27             Net::DNS::RR::SVCB(3)
Impressum