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.



1306
1307
1308
1309
1310
1311
1312
1313
1314
1315
1316
1317
1318
1319
 
# File 'lib/resolv.rb', line 1306

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



1321
1322
1323
 
# File 'lib/resolv.rb', line 1321

def aa
  @aa
end

#additional ⇒ Object (readonly)

Returns the value of attribute additional



1322
1323
1324
 
# File 'lib/resolv.rb', line 1322

def additional
  @additional
end

#answer ⇒ Object (readonly)

Returns the value of attribute answer



1322
1323
1324
 
# File 'lib/resolv.rb', line 1322

def answer
  @answer
end

#authority ⇒ Object (readonly)

Returns the value of attribute authority



1322
1323
1324
 
# File 'lib/resolv.rb', line 1322

def authority
  @authority
end

#id ⇒ Object

Returns the value of attribute id



1321
1322
1323
 
# File 'lib/resolv.rb', line 1321

def id
  @id
end

#opcode ⇒ Object

Returns the value of attribute opcode



1321
1322
1323
 
# File 'lib/resolv.rb', line 1321

def opcode
  @opcode
end

#qr ⇒ Object

Returns the value of attribute qr



1321
1322
1323
 
# File 'lib/resolv.rb', line 1321

def qr
  @qr
end

#question ⇒ Object (readonly)

Returns the value of attribute question



1322
1323
1324
 
# File 'lib/resolv.rb', line 1322

def question
  @question
end

#ra ⇒ Object

Returns the value of attribute ra



1321
1322
1323
 
# File 'lib/resolv.rb', line 1321

def ra
  @ra
end

#rcode ⇒ Object

Returns the value of attribute rcode



1321
1322
1323
 
# File 'lib/resolv.rb', line 1321

def rcode
  @rcode
end

#rd ⇒ Object

Returns the value of attribute rd



1321
1322
1323
 
# File 'lib/resolv.rb', line 1321

def rd
  @rd
end

#tc ⇒ Object

Returns the value of attribute tc



1321
1322
1323
 
# File 'lib/resolv.rb', line 1321

def tc
  @tc
end

Class Method Details

.decode(m) ⇒ Object 



1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
1499
1500
1501
1502
1503
1504
1505
1506
1507
1508
1509
 
# File 'lib/resolv.rb', line 1478

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.qr = (flag >> 15) & 1
    o.opcode = (flag >> 11) & 15
    o.aa = (flag >> 10) & 1
    o.tc = (flag >> 9) & 1
    o.rd = (flag >> 8) & 1
    o.ra = (flag >> 7) & 1
    o.rcode = flag & 15
    (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 



1324
1325
1326
1327
1328
1329
1330
1331
1332
1333
1334
1335
1336
1337
 
# File 'lib/resolv.rb', line 1324

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 



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

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

#add_answer(name, ttl, data) ⇒ Object 



1349
1350
1351
 
# File 'lib/resolv.rb', line 1349

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

#add_authority(name, ttl, data) ⇒ Object 



1359
1360
1361
 
# File 'lib/resolv.rb', line 1359

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

#add_question(name, typeclass) ⇒ Object 



1339
1340
1341
 
# File 'lib/resolv.rb', line 1339

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

#each_additional ⇒ Object 



1373
1374
1375
1376
1377
 
# File 'lib/resolv.rb', line 1373

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

#each_answer ⇒ Object 



1353
1354
1355
1356
1357
 
# File 'lib/resolv.rb', line 1353

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

#each_authority ⇒ Object 



1363
1364
1365
1366
1367
 
# File 'lib/resolv.rb', line 1363

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

#each_question ⇒ Object 



1343
1344
1345
1346
1347
 
# File 'lib/resolv.rb', line 1343

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

#each_resource ⇒ Object 



1379
1380
1381
1382
1383
 
# File 'lib/resolv.rb', line 1379

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 



1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
 
# File 'lib/resolv.rb', line 1385

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