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 SvcParams');
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, ech, ipv6hint
47           $rr = Net::DNS::RR->new( 'svcb.example. SVCB 1 svcb.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 draft-ietf-dnsop-
54       svcb-https.  When invoked without arguments, the methods return the
55       presentation format value for the underlying key.  The behaviour with
56       undefined arguments is not specified.
57
58   keyNN
59           $keynn = $rr->keyNN;
60           $rr->keyNN( $keynn );
61           $rr->keyNN( undef );
62
63       Generic constructor and accessor methods for SvcParams.  The key index
64       NN is a decimal integer in the range 0 .. 65535.  The method argument
65       and returned value are both presentation format strings.  The method
66       returns the undefined value if the key is not present.  The specified
67       key will be deleted if the value is undefined.
68
70       Copyright (c)2020-2022 Dick Franks.
71
72       All rights reserved.
73
74       Package template (c)2009,2012 O.M.Kolkman and R.W.Franks.
75

LICENSE

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

SEE ALSO

94       perl Net::DNS Net::DNS::RR draft-ietf-dnsop-svcb-https, RFC1035
95       <https://tools.ietf.org/html/rfc1035>
96
97       Service Parameter Keys <https://www.iana.org/assignments/dns-svcb>
98
99
100
101perl v5.36.1                      2023-06-01             Net::DNS::RR::SVCB(3)
Impressum