#!/usr/bin/perl
#
#Copyright (C) 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008
#	Yokogawa Electric Corporation.
#All rights reserved.
#
#Redistribution and use of this software in source and binary
#forms, with or without modification, are permitted provided that
#the following conditions and disclaimer are agreed and accepted
#by the user:
#
#1. Redistributions of source code must retain the above copyright
#   notice, this list of conditions and the following disclaimer.
#
#2. Redistributions in binary form must reproduce the above copyright
#   notice, this list of conditions and the following disclaimer in
#   the documentation and/or other materials provided with
#   the distribution.
#
#3. Neither the names of the copyrighters, the name of the project
#   which is related to this software (hereinafter referred to as
#   "project") nor the names of the contributors may be used to
#   endorse or promote products derived from this software without
#   specific prior written permission.
#
#4. No merchantable use may be permitted without prior written
#   notification to the copyrighters.
#
#5. The copyrighters, the project and the contributors may prohibit
#   the use of this software at any time.
#
#THIS SOFTWARE IS PROVIDED BY THE COPYRIGHTERS, THE PROJECT AND
#CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING
#BUT NOT LIMITED THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
#FOR A PARTICULAR PURPOSE, ARE DISCLAIMED.  IN NO EVENT SHALL THE
#COPYRIGHTERS, THE PROJECT OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
#INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
#(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
#SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
#HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
#STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
#IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
#POSSIBILITY OF SUCH DAMAGE.
#
#$Id: C_RFC2462_RA_FTF.seq,v 1.2 2008/08/29 06:26:00 ozoe Exp $
###############################################################################
BEGIN{
	$V6evalTool::TestVersion = '$Name: DHCPv6_Self_Test_P2_1_0_16 $';
}
use strict;
use V6evalTool;

use lib '../.';
use DHCPv6_common;
use Client_pktdesc;

dhcpExitNS  if ChkFuncSupport('STATELESSDHCP');

#--------------------------------------------------------------#
# Initialization variables
#--------------------------------------------------------------#
my $IF0_NUT = $V6evalTool::NutDef{"Link0_device"};
my $IF0 = "Link0";
my $timeout = 20;
vCapture($IF0);

#--------------------------------------------------------------#
# manuallly address configuration 
#--------------------------------------------------------------#
#my $ret = initial_ra_w_ping($IF0,'ra_server2_to_all_addr_assign');
#if($ret != 0){
#	vLogHTML('<FONT COLOR="#FF0000">Global Address of NUT is not assigned by RA!</FONT><BR>');
#	dhcpExitFail;
#}

# send RA with O = 0
vSend($IF0, 'ra_server2_to_all_addr_assign_O_0');

my $ret = vRemote("dhcp6c.rmt", "start", "inforeq", "dns", "lst", "link0=$IF0_NUT");
if($ret != 0) {
	vLogHTML('<FONT COLOR="#FF0000">Cannot Initialize DHCPv6 Client program.</FONT><BR>');
	dhcpExitFail;
};
#--------------------------------------------------------------#
# 1. Capture Information-request
#--------------------------------------------------------------#
my ($retinf, %inf) = wait_for_information_request($IF0, $timeout);
if($retinf != 0){
	
	# send RA with O = 1
	vSend($IF0, 'ra_server2_to_all_addr_assign');
	my ($retinf, %inf) = wait_for_information_request($IF0, $timeout);
	if($retinf != 0){
		dhcpExitFail;
	}
}

vClear($IF0);

# send RA with O = 0
vSend($IF0, 'ra_server2_to_all_addr_assign_O_0');

#--------------------------------------------------------------#
# 2. Capture Information-request
#--------------------------------------------------------------#
my ($retinf, %inf) = wait_for_information_request($IF0, $timeout);
if($retinf != 0){
	dhcpExitFail;
}

vClear($IF0);
vStop($IF0);
dhcpExitPass;
#NEED
###############################################################################
__END__

=head1 NAME 

  C_RFC2462_RA_FTF.seq - Router Advertisement's M bit changes from FALSE to TRUE to FALSE

=head1 TARGET

  Client

=head1 SYNOPSIS

=begin html
<PRE>
  <A HREF="./C_RFC2462_RA_FTF.seq"> C_RFC2462_RA_FTF.seq</A> [-tooloption...] <BR>  -pkt  <A HREF="./C_RFC2462_RA_FTF.def"> C_RFC2462_RA_FTF.def</A> <BR>  -tooloption : v6eval tool option
<BR>
  See Also <A HREF="../DHCPv6.def"> DHCPv6.def </A> 
</PRE>

=end html

=head1 INITIALIZATION

=begin html
  <ul>
  <li><STRONG>Network Topology</STRONG></li> 
    <PRE>
          NUT(Client)
          |           
          |                        
Link0   --+--------+------------------------ 3ffe:501:ffff:100::/64
                   |
                   |          
                   TN(Server) 
    </PRE>
  </ul>
  <ul>
  <li><STRONG>Verification Points</STRONG></li><br>
    <PRE>
   On receipt of a valid Router Advertisement, 
   a host copies the value of the advertisement's M bit
   into ManagedFlag. If the value of ManagedFlag changes from FALSE to
   TRUE, and the host is not already running the stateful address
   autoconfiguration protocol, the host should invoke the stateful
   address autoconfiguration protocol, requesting both address
   information and other information.  If the value of the ManagedFlag
   changes from TRUE to FALSE, the host should continue running the
   stateful address autoconfiguration, i.e., the change in the value of
   the ManagedFlag has no effect.  If the value of the flag stays
   unchanged, no special action takes place. In particular, a host MUST
   NOT reinvoke stateful address configuration if it is already
   participating in the stateful protocol as a result of an earlier
   advertisement.
    </PRE>
  </ul>
  <ul>  
  <li><STRONG>Configurations</STRONG></li><br>
    <BR>
    <TABLE BORDER="1">
    <TR>
    <TD><TT>Device Name</TT></TD>
    <TD><TT>Device Type</TT></TD>
    <TD><TT>Interface</TT></TD>
    <TD><TT>Assigned Prefix</TT></TD>
    <TD><TT>Link Local Addr</TT></TD>
    <TD><TT>MAC Addr</TT></TD>
    </TR>
    <TR>
    <TD><TT>Client</TT></TD>
    <TD><TT>NUT</TT></TD>
    <TD><TT>Link0</TT></TD>
    <TD><TT>3ffe:501:ffff:100::/64</TT></TD>
    <TD><TT>NUT's Linklocal address</TT></TD>
    <TD><TT>NUT's MAC address</TT></TD>
    </TR>
    <TR>
    <TD><TT>Server</TT></TD>
    <TD><TT>TN</TT></TD>
    <TD><TT>Link0</TT></TD>
    <TD><TT>3ffe:501:ffff:100::/64</TT></TD>
    <TD><TT>fe80::200:ff:fe00:a1a1</TT></TD>
    <TD><TT>00:00:00:00:a1:a1</TT></TD>
    </TR>
    </TABLE>
  </ul>

=end html

=head1 TEST PROCEDURE

=begin html
<PRE>
<BR>
       NUT      TN
        |       |
        |       | NUT has been configured with IPv6 address,
        |       | and request stateless DHCPv6 service
        |       |
        | <---- |<B>RA with O=0</B> 
        |       |
        | ----> |<B>Information-request</B> w/Option Request option/23,24 (2*)
        |       |  if NUT send Information-request, skip to ***
        |       |
        | <---- |<B>RA with O=1</B> 
        |       |
        | ----> |<B>Information-request</B> w/Option Request option/23,24 (4*)
        |       |
        | <---- |<B>RA with O=0</B> ***
        |       |
        | ----->|<B>Information-request</B> w/Option Request option/23,24 (6*)
        |       |
<BR>
</PRE>

=end html

=head1 JUDGEMENT

=begin html
<PRE>
<BR>  
  (2*)PASS: NUT transmits Information-request to TN.
  (4*)PASS: NUT transmits Information-request to TN.
  (6*)PASS: NUT transmits Information-request to TN.
</PRE>

=end html

=head1 TERMINATION

=begin html
<PRE>
  N/A
</PRE>

=end html

=head1 REFERENCE

=begin html
<PRE>
  Also see RFC2462 Section 5.5.3
  Also see RFC3736
</PRE>

=end html

=head1 SEE ALSO

=begin html
<PRE>
<BR>
  perldoc  V6evalTool
<BR>
</PRE>

=end html