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.



1302
1303
1304
1305
1306
1307
1308
1309
1310
1311
1312
1313
1314
1315
 
# File 'lib/resolv.rb', line 1302

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



1317
1318
1319
 
# File 'lib/resolv.rb', line 1317

def aa
  @aa
end

#additional ⇒ Object (readonly)

Returns the value of attribute additional



1318
1319
1320
 
# File 'lib/resolv.rb', line 1318

def additional
  @additional
end

#answer ⇒ Object (readonly)

Returns the value of attribute answer



1318
1319
1320
 
# File 'lib/resolv.rb', line 1318

def answer
  @answer
end

#authority ⇒ Object (readonly)

Returns the value of attribute authority



1318
1319
1320
 
# File 'lib/resolv.rb', line 1318

def authority
  @authority
end

#id ⇒ Object

Returns the value of attribute id



1317
1318
1319
 
# File 'lib/resolv.rb', line 1317

def id
  @id
end

#opcode ⇒ Object

Returns the value of attribute opcode



1317
1318
1319
 
# File 'lib/resolv.rb', line 1317

def opcode
  @opcode
end

#qr ⇒ Object

Returns the value of attribute qr



1317
1318
1319
 
# File 'lib/resolv.rb', line 1317

def qr
  @qr
end

#question ⇒ Object (readonly)

Returns the value of attribute question



1318
1319
1320
 
# File 'lib/resolv.rb', line 1318

def question
  @question
end

#ra ⇒ Object

Returns the value of attribute ra



1317
1318
1319
 
# File 'lib/resolv.rb', line 1317

def ra
  @ra
end

#rcode ⇒ Object

Returns the value of attribute rcode



1317
1318
1319
 
# File 'lib/resolv.rb', line 1317

def rcode
  @rcode
end

#rd ⇒ Object

Returns the value of attribute rd



1317
1318
1319
 
# File 'lib/resolv.rb', line 1317

def rd
  @rd
end

#tc ⇒ Object

Returns the value of attribute tc



1317
1318
1319
 
# File 'lib/resolv.rb', line 1317

def tc
  @tc
end

Class Method Details

.decode(m) ⇒ Object 



1474
1475
1476
1477
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
 
# File 'lib/resolv.rb', line 1474

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 



1320
1321
1322
1323
1324
1325
1326
1327
1328
1329
1330
1331
1332
1333
 
# File 'lib/resolv.rb', line 1320

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 



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

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

#add_answer(name, ttl, data) ⇒ Object 



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

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

#add_authority(name, ttl, data) ⇒ Object 



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

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

#add_question(name, typeclass) ⇒ Object 



1335
1336
1337
 
# File 'lib/resolv.rb', line 1335

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

#each_additional ⇒ Object 



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

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

#each_answer ⇒ Object 



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

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

#each_authority ⇒ Object 



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

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

#each_question ⇒ Object 



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

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

#each_resource ⇒ Object 



1375
1376
1377
1378
1379
 
# File 'lib/resolv.rb', line 1375

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 



1381
1382
1383
1384
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
 
# File 'lib/resolv.rb', line 1381

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