Class: Resolv::DNS::Message

Inherits:
Object
  • Object
show all
Defined in:
lib/resolv.rb

Overview

:nodoc:

Defined Under Namespace

Classes: MessageDecoder, MessageEncoder

Constant Summary collapse

@@identifier = 
-1

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(id = (@@identifier += 1) & 0xffff) ⇒ Message

Returns a new instance of Message.



1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
 
# File 'lib/resolv.rb', line 1368

def initialize(id = (@@identifier += 1) & 0xffff)
  @id = id
  @qr = 0
  @opcode = 0
  @aa = 0
  @tc = 0
  @rd = 0 # recursion desired
  @ra = 0 # recursion available
  @rcode = 0
  @question = []
  @answer = []
  @authority = []
  @additional = []
end

Instance Attribute Details

#aa ⇒ Object

Returns the value of attribute aa.



1383
1384
1385
 
# File 'lib/resolv.rb', line 1383

def aa
  @aa
end

#additional ⇒ Object (readonly)

Returns the value of attribute additional.



1384
1385
1386
 
# File 'lib/resolv.rb', line 1384

def additional
  @additional
end

#answer ⇒ Object (readonly)

Returns the value of attribute answer.



1384
1385
1386
 
# File 'lib/resolv.rb', line 1384

def answer
  @answer
end

#authority ⇒ Object (readonly)

Returns the value of attribute authority.



1384
1385
1386
 
# File 'lib/resolv.rb', line 1384

def authority
  @authority
end

#id ⇒ Object

Returns the value of attribute id.



1383
1384
1385
 
# File 'lib/resolv.rb', line 1383

def id
  @id
end

#opcode ⇒ Object

Returns the value of attribute opcode.



1383
1384
1385
 
# File 'lib/resolv.rb', line 1383

def opcode
  @opcode
end

#qr ⇒ Object

Returns the value of attribute qr.



1383
1384
1385
 
# File 'lib/resolv.rb', line 1383

def qr
  @qr
end

#question ⇒ Object (readonly)

Returns the value of attribute question.



1384
1385
1386
 
# File 'lib/resolv.rb', line 1384

def question
  @question
end

#ra ⇒ Object

Returns the value of attribute ra.



1383
1384
1385
 
# File 'lib/resolv.rb', line 1383

def ra
  @ra
end

#rcode ⇒ Object

Returns the value of attribute rcode.



1383
1384
1385
 
# File 'lib/resolv.rb', line 1383

def rcode
  @rcode
end

#rd ⇒ Object

Returns the value of attribute rd.



1383
1384
1385
 
# File 'lib/resolv.rb', line 1383

def rd
  @rd
end

#tc ⇒ Object

Returns the value of attribute tc.



1383
1384
1385
 
# File 'lib/resolv.rb', line 1383

def tc
  @tc
end

Class Method Details

.decode(m) ⇒ Object 



1542
1543
1544
1545
1546
1547
1548
1549
1550
1551
1552
1553
1554
1555
1556
1557
1558
1559
1560
1561
1562
1563
1564
1565
1566
1567
1568
1569
1570
1571
1572
1573
1574
1575
 
# File 'lib/resolv.rb', line 1542

def Message.decode(m)
  o = Message.new(0)
  MessageDecoder.new(m) {|msg|
    id, flag, qdcount, ancount, nscount, arcount =
      msg.get_unpack('nnnnnn')
    o.id = id
    o.tc = (flag >> 9) & 1
    o.rcode = flag & 15
    return o unless o.tc.zero?

    o.qr = (flag >> 15) & 1
    o.opcode = (flag >> 11) & 15
    o.aa = (flag >> 10) & 1
    o.rd = (flag >> 8) & 1
    o.ra = (flag >> 7) & 1
    (1..qdcount).each {
      name, typeclass = msg.get_question
      o.add_question(name, typeclass)
    }
    (1..ancount).each {
      name, ttl, data = msg.get_rr
      o.add_answer(name, ttl, data)
    }
    (1..nscount).each {
      name, ttl, data = msg.get_rr
      o.add_authority(name, ttl, data)
    }
    (1..arcount).each {
      name, ttl, data = msg.get_rr
      o.add_additional(name, ttl, data)
    }
  }
  return o
end

Instance Method Details

#==(other) ⇒ Object 



1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
 
# File 'lib/resolv.rb', line 1386

def ==(other)
  return @id == other.id &&
         @qr == other.qr &&
         @opcode == other.opcode &&
         @aa == other.aa &&
         @tc == other.tc &&
         @rd == other.rd &&
         @ra == other.ra &&
         @rcode == other.rcode &&
         @question == other.question &&
         @answer == other.answer &&
         @authority == other.authority &&
         @additional == other.additional
end

#add_additional(name, ttl, data) ⇒ Object 



1431
1432
1433
 
# File 'lib/resolv.rb', line 1431

def add_additional(name, ttl, data)
  @additional << [Name.create(name), ttl, data]
end

#add_answer(name, ttl, data) ⇒ Object 



1411
1412
1413
 
# File 'lib/resolv.rb', line 1411

def add_answer(name, ttl, data)
  @answer << [Name.create(name), ttl, data]
end

#add_authority(name, ttl, data) ⇒ Object 



1421
1422
1423
 
# File 'lib/resolv.rb', line 1421

def add_authority(name, ttl, data)
  @authority << [Name.create(name), ttl, data]
end

#add_question(name, typeclass) ⇒ Object 



1401
1402
1403
 
# File 'lib/resolv.rb', line 1401

def add_question(name, typeclass)
  @question << [Name.create(name), typeclass]
end

#each_additional ⇒ Object 



1435
1436
1437
1438
1439
 
# File 'lib/resolv.rb', line 1435

def each_additional
  @additional.each {|name, ttl, data|
    yield name, ttl, data
  }
end

#each_answer ⇒ Object 



1415
1416
1417
1418
1419
 
# File 'lib/resolv.rb', line 1415

def each_answer
  @answer.each {|name, ttl, data|
    yield name, ttl, data
  }
end

#each_authority ⇒ Object 



1425
1426
1427
1428
1429
 
# File 'lib/resolv.rb', line 1425

def each_authority
  @authority.each {|name, ttl, data|
    yield name, ttl, data
  }
end

#each_question ⇒ Object 



1405
1406
1407
1408
1409
 
# File 'lib/resolv.rb', line 1405

def each_question
  @question.each {|name, typeclass|
    yield name, typeclass
  }
end

#each_resource ⇒ Object 



1441
1442
1443
1444
1445
 
# File 'lib/resolv.rb', line 1441

def each_resource
  each_answer {|name, ttl, data| yield name, ttl, data}
  each_authority {|name, ttl, data| yield name, ttl, data}
  each_additional {|name, ttl, data| yield name, ttl, data}
end

#encode ⇒ Object 



1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
 
# File 'lib/resolv.rb', line 1447

def encode
  return MessageEncoder.new {|msg|
    msg.put_pack('nnnnnn',
      @id,
      (@qr & 1) << 15 |
      (@opcode & 15) << 11 |
      (@aa & 1) << 10 |
      (@tc & 1) << 9 |
      (@rd & 1) << 8 |
      (@ra & 1) << 7 |
      (@rcode & 15),
      @question.length,
      @answer.length,
      @authority.length,
      @additional.length)
    @question.each {|q|
      name, typeclass = q
      msg.put_name(name)
      msg.put_pack('nn', typeclass::TypeValue, typeclass::ClassValue)
    }
    [@answer, @authority, @additional].each {|rr|
      rr.each {|r|
        name, ttl, data = r
        msg.put_name(name)
        msg.put_pack('nnN', data.class::TypeValue, data.class::ClassValue, ttl)
        msg.put_length16 {data.encode_rdata(msg)}
      }
    }
  }.to_s
end