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.



1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
 
# File 'lib/resolv.rb', line 1355

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.



1370
1371
1372
 
# File 'lib/resolv.rb', line 1370

def aa
  @aa
end

#additional ⇒ Object (readonly)

Returns the value of attribute additional.



1371
1372
1373
 
# File 'lib/resolv.rb', line 1371

def additional
  @additional
end

#answer ⇒ Object (readonly)

Returns the value of attribute answer.



1371
1372
1373
 
# File 'lib/resolv.rb', line 1371

def answer
  @answer
end

#authority ⇒ Object (readonly)

Returns the value of attribute authority.



1371
1372
1373
 
# File 'lib/resolv.rb', line 1371

def authority
  @authority
end

#id ⇒ Object

Returns the value of attribute id.



1370
1371
1372
 
# File 'lib/resolv.rb', line 1370

def id
  @id
end

#opcode ⇒ Object

Returns the value of attribute opcode.



1370
1371
1372
 
# File 'lib/resolv.rb', line 1370

def opcode
  @opcode
end

#qr ⇒ Object

Returns the value of attribute qr.



1370
1371
1372
 
# File 'lib/resolv.rb', line 1370

def qr
  @qr
end

#question ⇒ Object (readonly)

Returns the value of attribute question.



1371
1372
1373
 
# File 'lib/resolv.rb', line 1371

def question
  @question
end

#ra ⇒ Object

Returns the value of attribute ra.



1370
1371
1372
 
# File 'lib/resolv.rb', line 1370

def ra
  @ra
end

#rcode ⇒ Object

Returns the value of attribute rcode.



1370
1371
1372
 
# File 'lib/resolv.rb', line 1370

def rcode
  @rcode
end

#rd ⇒ Object

Returns the value of attribute rd.



1370
1371
1372
 
# File 'lib/resolv.rb', line 1370

def rd
  @rd
end

#tc ⇒ Object

Returns the value of attribute tc.



1370
1371
1372
 
# File 'lib/resolv.rb', line 1370

def tc
  @tc
end

Class Method Details

.decode(m) ⇒ Object 



1529
1530
1531
1532
1533
1534
1535
1536
1537
1538
1539
1540
1541
1542
1543
1544
1545
1546
1547
1548
1549
1550
1551
1552
1553
1554
1555
1556
1557
1558
1559
1560
1561
1562
 
# File 'lib/resolv.rb', line 1529

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 



1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
 
# File 'lib/resolv.rb', line 1373

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 



1418
1419
1420
 
# File 'lib/resolv.rb', line 1418

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

#add_answer(name, ttl, data) ⇒ Object 



1398
1399
1400
 
# File 'lib/resolv.rb', line 1398

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

#add_authority(name, ttl, data) ⇒ Object 



1408
1409
1410
 
# File 'lib/resolv.rb', line 1408

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

#add_question(name, typeclass) ⇒ Object 



1388
1389
1390
 
# File 'lib/resolv.rb', line 1388

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

#each_additional ⇒ Object 



1422
1423
1424
1425
1426
 
# File 'lib/resolv.rb', line 1422

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

#each_answer ⇒ Object 



1402
1403
1404
1405
1406
 
# File 'lib/resolv.rb', line 1402

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

#each_authority ⇒ Object 



1412
1413
1414
1415
1416
 
# File 'lib/resolv.rb', line 1412

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

#each_question ⇒ Object 



1392
1393
1394
1395
1396
 
# File 'lib/resolv.rb', line 1392

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

#each_resource ⇒ Object 



1428
1429
1430
1431
1432
 
# File 'lib/resolv.rb', line 1428

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 



1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
 
# File 'lib/resolv.rb', line 1434

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