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.



1291
1292
1293
1294
1295
1296
1297
1298
1299
1300
1301
1302
1303
1304
 
# File 'lib/resolv.rb', line 1291

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



1306
1307
1308
 
# File 'lib/resolv.rb', line 1306

def aa
  @aa
end

#additional ⇒ Object (readonly)

Returns the value of attribute additional



1307
1308
1309
 
# File 'lib/resolv.rb', line 1307

def additional
  @additional
end

#answer ⇒ Object (readonly)

Returns the value of attribute answer



1307
1308
1309
 
# File 'lib/resolv.rb', line 1307

def answer
  @answer
end

#authority ⇒ Object (readonly)

Returns the value of attribute authority



1307
1308
1309
 
# File 'lib/resolv.rb', line 1307

def authority
  @authority
end

#id ⇒ Object

Returns the value of attribute id



1306
1307
1308
 
# File 'lib/resolv.rb', line 1306

def id
  @id
end

#opcode ⇒ Object

Returns the value of attribute opcode



1306
1307
1308
 
# File 'lib/resolv.rb', line 1306

def opcode
  @opcode
end

#qr ⇒ Object

Returns the value of attribute qr



1306
1307
1308
 
# File 'lib/resolv.rb', line 1306

def qr
  @qr
end

#question ⇒ Object (readonly)

Returns the value of attribute question



1307
1308
1309
 
# File 'lib/resolv.rb', line 1307

def question
  @question
end

#ra ⇒ Object

Returns the value of attribute ra



1306
1307
1308
 
# File 'lib/resolv.rb', line 1306

def ra
  @ra
end

#rcode ⇒ Object

Returns the value of attribute rcode



1306
1307
1308
 
# File 'lib/resolv.rb', line 1306

def rcode
  @rcode
end

#rd ⇒ Object

Returns the value of attribute rd



1306
1307
1308
 
# File 'lib/resolv.rb', line 1306

def rd
  @rd
end

#tc ⇒ Object

Returns the value of attribute tc



1306
1307
1308
 
# File 'lib/resolv.rb', line 1306

def tc
  @tc
end

Class Method Details

.decode(m) ⇒ Object 



1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
 
# File 'lib/resolv.rb', line 1463

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 



1309
1310
1311
1312
1313
1314
1315
1316
1317
1318
1319
1320
1321
1322
 
# File 'lib/resolv.rb', line 1309

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 



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

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

#add_answer(name, ttl, data) ⇒ Object 



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

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

#add_authority(name, ttl, data) ⇒ Object 



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

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

#add_question(name, typeclass) ⇒ Object 



1324
1325
1326
 
# File 'lib/resolv.rb', line 1324

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

#each_additional ⇒ Object 



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

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

#each_answer ⇒ Object 



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

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

#each_authority ⇒ Object 



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

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

#each_question ⇒ Object 



1328
1329
1330
1331
1332
 
# File 'lib/resolv.rb', line 1328

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

#each_resource ⇒ Object 



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

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 



1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
 
# File 'lib/resolv.rb', line 1370

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