sal/qa/osl/socket/osl_Socket2.cxx

   1 /*************************************************************************
   2  *
   3  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   4  *
   5  * Copyright 2008 by Sun Microsystems, Inc.
   6  *
   7  * OpenOffice.org - a multi-platform office productivity suite
   8  *
   9  * $RCSfile: osl_Socket2.cxx,v $
  10  * $Revision: 1.8 $
  11  *
  12  * This file is part of OpenOffice.org.
  13  *
  14  * OpenOffice.org is free software: you can redistribute it and/or modify
  15  * it under the terms of the GNU Lesser General Public License version 3
  16  * only, as published by the Free Software Foundation.
  17  *
  18  * OpenOffice.org is distributed in the hope that it will be useful,
  19  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  20  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  21  * GNU Lesser General Public License version 3 for more details
  22  * (a copy is included in the LICENSE file that accompanied this code).
  23  *
  24  * You should have received a copy of the GNU Lesser General Public License
  25  * version 3 along with OpenOffice.org.  If not, see
  26  * <http://www.openoffice.org/license.html>
  27  * for a copy of the LGPLv3 License.
  28  *
  29  ************************************************************************/
  30
  31 // MARKER(update_precomp.py): autogen include statement, do not remove
  32 #include "precompiled_sal.hxx"
  33
  34 /**  test coder preface:
  35     1. the BSD socket function will meet "unresolved external symbol error" on Windows platform
  36     if you are not including ws2_32.lib in makefile.mk,  the including format will be like this:
  37
  38     .IF "$(GUI)" == "WNT"
  39     SHL1STDLIBS +=      $(SOLARLIBDIR)$/cppunit.lib
  40     SHL1STDLIBS +=  ws2_32.lib
  41     .ENDIF
  42
  43     likewise on Solaris platform.
  44     .IF "$(GUI)" == "UNX"
  45     SHL1STDLIBS+=$(SOLARLIBDIR)$/libcppunit$(DLLPOSTFIX).a
  46     SHL1STDLIBS += -lsocket -ldl -lnsl
  47     .ENDIF
  48
  49     2. since the Socket implementation of osl is only IPv4 oriented, our test are mainly focus on IPv4
  50     category.
  51
  52     3. some fragment of Socket source implementation are lack of comment so it is hard for testers
  53     guess what the exact functionality or usage of a member.  Hope the Socket section's comment
  54     will be added.
  55
  56     4. following functions are declared but not implemented:
  57     inline sal_Bool SAL_CALL operator== (const SocketAddr & Addr) const;
  58  */
  59
  60 //------------------------------------------------------------------------
  61 // include files
  62 //------------------------------------------------------------------------
  63
  64 #include <cppunit/simpleheader.hxx>
  65
  66 //#include "osl_Socket_Const.h"
  67 #include "sockethelper.hxx"
  68
  69 using namespace osl;
  70 using namespace rtl;
  71
  72 #define IP_PORT_FTP     21
  73 #define IP_PORT_TELNET  23
  74 #define IP_PORT_HTTP2   8080
  75 #define IP_PORT_INVAL   99999
  76 #define IP_PORT_POP3    110
  77 #define IP_PORT_NETBIOS 139
  78 #define IP_PORT_MYPORT  8881
  79 #define IP_PORT_MYPORT1 8882
  80 #define IP_PORT_MYPORT5 8886
  81 #define IP_PORT_MYPORT6 8887
  82 #define IP_PORT_MYPORT7 8895
  83 #define IP_PORT_MYPORT8 8896
  84 #define IP_PORT_MYPORT9 8897
  85
  86 //------------------------------------------------------------------------
  87 // helper functions
  88 //------------------------------------------------------------------------
  89
  90 // just used to test socket::close() when accepting
  91 class AcceptorThread : public Thread
  92 {
  93     ::osl::AcceptorSocket asAcceptorSocket;
  94     ::rtl::OUString aHostIP;
  95     sal_Bool bOK;
  96 protected:
  97     void SAL_CALL run( )
  98     {
  99         ::osl::SocketAddr saLocalSocketAddr( aHostIP, IP_PORT_MYPORT9 );
 100         ::osl::StreamSocket ssStreamConnection;
 101
 102         asAcceptorSocket.setOption( osl_Socket_OptionReuseAddr, 1 ); //integer not sal_Bool : sal_True);
 103         sal_Bool bOK1 = asAcceptorSocket.bind( saLocalSocketAddr );
 104         if  ( sal_True != bOK1 )
 105         {
 106             t_print("# AcceptorSocket bind address failed.\n" ) ;
 107             return;
 108         }
 109         sal_Bool bOK2 = asAcceptorSocket.listen( 1 );
 110         if  ( sal_True != bOK2 )
 111         {
 112             t_print("# AcceptorSocket listen address failed.\n" ) ;
 113             return;
 114         }
 115
 116         asAcceptorSocket.enableNonBlockingMode( sal_False );
 117
 118         oslSocketResult eResult = asAcceptorSocket.acceptConnection( ssStreamConnection );
 119         if (eResult != osl_Socket_Ok )
 120         {
 121             bOK = sal_True;
 122             t_print("AcceptorThread: acceptConnection failed! \n");
 123         }
 124     }
 125 public:
 126     AcceptorThread(::osl::AcceptorSocket & asSocket, ::rtl::OUString const& aBindIP )
 127         : asAcceptorSocket( asSocket ), aHostIP( aBindIP )
 128     {
 129         bOK = sal_False;
 130     }
 131
 132     sal_Bool isOK() { return bOK; }
 133
 134     ~AcceptorThread( )
 135     {
 136         if ( isRunning( ) )
 137         {
 138             asAcceptorSocket.shutdown();
 139             t_print("# error: Acceptor thread not terminated.\n" );
 140         }
 141     }
 142 };
 143
 144 namespace osl_Socket
 145 {
 146
 147     /** testing the methods:
 148         inline Socket( );
 149         inline Socket( const Socket & socket );
 150         inline Socket( oslSocket socketHandle );
 151         inline Socket( oslSocket socketHandle, __sal_NoAcquire noacquire );
 152     */
 153
 154     /**  test writer's comment:
 155
 156         class Socket can not be initialized by its protected constructor, though the protected
 157         constructor is the most convenient way to create a new socket.
 158         it only allow the method of C function osl_createSocket like:
 159         ::osl::Socket sSocket( osl_createSocket( osl_Socket_FamilyInet, osl_Socket_TypeStream,
 160                                           osl_Socket_ProtocolIp ) );
 161         the use of C method lost some of the transparent of tester using C++ wrapper.
 162     */
 163
 164
 165     class ctors : public CppUnit::TestFixture
 166     {
 167     public:
 168         oslSocket sHandle;
 169         // initialization
 170         void setUp( )
 171         {
 172             sHandle = osl_createSocket( osl_Socket_FamilyInet, osl_Socket_TypeStream, osl_Socket_ProtocolIp );
 173         }
 174
 175         void tearDown( )
 176         {
 177             sHandle = NULL;
 178         }
 179
 180
 181         void ctors_none()
 182         {
 183             /// Socket constructor.
 184             // ::osl::Socket sSocket();
 185
 186             CPPUNIT_ASSERT_MESSAGE( "test for ctors_none constructor function: check if the socket was created successfully, if no exception occured",
 187                                     1 == 1 );
 188         }
 189
 190         void ctors_acquire()
 191         {
 192             /// Socket constructor.
 193             ::osl::Socket sSocket( sHandle );
 194
 195             CPPUNIT_ASSERT_MESSAGE( "test for ctors_acquire constructor function: check if the socket was created successfully",
 196                                     osl_Socket_TypeStream == sSocket.getType( ) );
 197         }
 198
 199         void ctors_no_acquire()
 200         {
 201             /// Socket constructor.
 202             ::osl::Socket sSocket( sHandle, SAL_NO_ACQUIRE );
 203
 204             CPPUNIT_ASSERT_MESSAGE(" test for ctors_no_acquire constructor function: check if the socket was created successfully",
 205                                     osl_Socket_TypeStream == sSocket.getType( ) );
 206         }
 207
 208         void ctors_copy_ctor()
 209         {
 210             ::osl::Socket sSocket( sHandle );
 211             /// Socket copy constructor.
 212             ::osl::Socket copySocket( sSocket );
 213
 214             CPPUNIT_ASSERT_MESSAGE(" test for ctors_copy_ctor constructor function: create new Socket instance using copy constructor",
 215                                     osl_Socket_TypeStream == copySocket.getType( ) );
 216         }
 217
 218         void ctors_TypeRaw()
 219         {
 220 #ifdef WNT
 221             oslSocket sHandleRaw = osl_createSocket( osl_Socket_FamilyInet, osl_Socket_TypeRaw, osl_Socket_ProtocolIp );
 222 // LLA: ?                       ::osl::Socket sSocket( sHandleRaw );
 223             CPPUNIT_ASSERT_MESSAGE( " type osl_Socket_TypeRaw socket create failed on UNX ", sHandleRaw != NULL);
 224 #else
 225             oslSocket sHandleRaw = osl_createSocket( osl_Socket_FamilyInet, osl_Socket_TypeRaw, osl_Socket_ProtocolIp );
 226             CPPUNIT_ASSERT_MESSAGE( " can't create socket with type osl_Socket_TypeRaw within UNX is ok.", sHandleRaw == NULL);
 227 #endif
 228         }
 229
 230         void ctors_family_Ipx()
 231         {
 232             oslSocket sHandleIpx = osl_createSocket( osl_Socket_FamilyIpx, osl_Socket_TypeStream, osl_Socket_ProtocolIp );
 233             CPPUNIT_ASSERT_MESSAGE( " family osl_Socket_FamilyIpx socket create failed! ", sHandleIpx != NULL);
 234             ::osl::Socket sSocket( sHandleIpx );                //, SAL_NO_ACQUIRE );
 235             t_print("#Type is %d \n", sSocket.getType( ) );
 236
 237             CPPUNIT_ASSERT_MESSAGE(" test for create new Socket instance that family is osl_Socket_FamilyIpx",
 238                                     osl_Socket_TypeStream == sSocket.getType( ) );
 239         }
 240
 241
 242
 243         CPPUNIT_TEST_SUITE( ctors );
 244         CPPUNIT_TEST( ctors_none );
 245         CPPUNIT_TEST( ctors_acquire );
 246         CPPUNIT_TEST( ctors_no_acquire );
 247         CPPUNIT_TEST( ctors_copy_ctor );
 248         CPPUNIT_TEST( ctors_TypeRaw );
 249         CPPUNIT_TEST( ctors_family_Ipx );
 250         CPPUNIT_TEST_SUITE_END();
 251
 252     }; // class ctors
 253
 254
 255     /** testing the methods:
 256         inline Socket& SAL_CALL operator= ( oslSocket socketHandle);
 257         inline Socket& SAL_CALL operator= (const Socket& sock);
 258         inline sal_Bool SAL_CALL operator==( const Socket& rSocket ) const ;
 259         inline sal_Bool SAL_CALL operator==( const oslSocket socketHandle ) const;
 260     */
 261
 262     class operators : public CppUnit::TestFixture
 263     {
 264     public:
 265         oslSocket sHandle;
 266         // initialization
 267         void setUp( )
 268         {
 269             sHandle = osl_createSocket( osl_Socket_FamilyInet, osl_Socket_TypeStream, osl_Socket_ProtocolIp );
 270         }
 271
 272         void tearDown( )
 273         {
 274             sHandle = NULL;
 275         }
 276
 277
 278     /**  test writer's comment:
 279
 280         the assignment operator does not support direct assinment like:
 281         ::osl::Socket sSocket = sHandle.
 282     */
 283         void operators_assignment_handle()
 284         {
 285             ::osl::Socket sSocket(sHandle);
 286             ::osl::Socket assignSocket = sSocket.getHandle();
 287
 288             CPPUNIT_ASSERT_MESSAGE( "test for operators_assignment_handle function: test the assignment operator.",
 289                                     osl_Socket_TypeStream == assignSocket.getType( )  );
 290         }
 291
 292         void operators_assignment()
 293         {
 294             ::osl::Socket sSocket( sHandle );
 295             ::osl::Socket assignSocket = sSocket;
 296
 297             CPPUNIT_ASSERT_MESSAGE( "test for operators_assignment function: assignment operator",
 298                                     osl_Socket_TypeStream == assignSocket.getType( ) );
 299         }
 300
 301         void operators_equal_handle_001()
 302         {
 303             /// Socket constructor.
 304             ::osl::Socket sSocket( sHandle );
 305             ::osl::Socket equalSocket = sSocket;
 306
 307             CPPUNIT_ASSERT_MESSAGE(" test for operators_equal_handle_001 function: check equal.",
 308                                     equalSocket == sHandle );
 309         }
 310
 311         void operators_equal_handle_002()
 312         {
 313             /// Socket constructor.
 314             ::osl::Socket equalSocket( osl_createSocket( osl_Socket_FamilyInet, osl_Socket_TypeDgram, osl_Socket_ProtocolIp ) );
 315
 316             CPPUNIT_ASSERT_MESSAGE(" test for operators_equal_handle_001 function: check unequal.",
 317                                     !( equalSocket == sHandle ) );
 318         }
 319
 320         void operators_equal_001()
 321         {
 322             ::osl::Socket sSocket( sHandle );
 323             /// Socket copy constructor.
 324             ::osl::Socket equalSocket( sSocket );
 325
 326             CPPUNIT_ASSERT_MESSAGE(" test for operators_equal function: check equal.",
 327                                     equalSocket == sSocket );
 328         }
 329
 330         void operators_equal_002()
 331         {
 332             ::osl::Socket sSocket( sHandle );
 333             /// Socket copy constructor.
 334             ::osl::Socket equalSocket( osl_createSocket( osl_Socket_FamilyInet, osl_Socket_TypeDgram, osl_Socket_ProtocolIp ) );
 335
 336             CPPUNIT_ASSERT_MESSAGE(" test for operators_equal_002 function: check unequal.",
 337                                     !( equalSocket == sSocket ) );
 338         }
 339
 340         CPPUNIT_TEST_SUITE( operators );
 341         CPPUNIT_TEST( operators_assignment_handle );
 342         CPPUNIT_TEST( operators_assignment );
 343         CPPUNIT_TEST( operators_equal_handle_001 );
 344         CPPUNIT_TEST( operators_equal_handle_002 );
 345         CPPUNIT_TEST( operators_equal_001 );
 346         CPPUNIT_TEST( operators_equal_002 );
 347         CPPUNIT_TEST_SUITE_END();
 348
 349     }; // class operators
 350
 351
 352     /** testing the methods:
 353         inline void SAL_CALL shutdown( oslSocketDirection Direction = osl_Socket_DirReadWrite );
 354         inline void SAL_CALL close();
 355     */
 356
 357     class close : public CppUnit::TestFixture
 358     {
 359     public:
 360         oslSocket sHandle;
 361         // initialization
 362         void setUp( )
 363         {
 364             sHandle = osl_createSocket( osl_Socket_FamilyInet, osl_Socket_TypeStream, osl_Socket_ProtocolIp );
 365         }
 366
 367         void tearDown( )
 368         {
 369             sHandle = NULL;
 370         }
 371
 372
 373         void close_001()
 374         {
 375             ::osl::Socket sSocket(sHandle);
 376             sSocket.close();
 377
 378             CPPUNIT_ASSERT_MESSAGE( "test for close_001 function: this function is reserved for test.",
 379                                     sSocket.getHandle() == sHandle );
 380         }
 381
 382         void close_002()
 383         {
 384 //#if defined(LINUX)
 385             ::osl::AcceptorSocket asSocket( osl_Socket_FamilyInet, osl_Socket_ProtocolIp, osl_Socket_TypeStream );
 386             AcceptorThread myAcceptorThread( asSocket, rtl::OUString::createFromAscii("127.0.0.1") );
 387             myAcceptorThread.create();
 388
 389             thread_sleep( 1 );
 390             //when accepting, close the socket, the thread will not block for accepting
 391             //man close:Any locks held on the file it was associated with, and owned by the process, are removed
 392             asSocket.close();
 393             //thread_sleep( 2 );
 394             myAcceptorThread.join();
 395
 396             CPPUNIT_ASSERT_MESSAGE( "test for close when is accepting: the socket will quit accepting status.",
 397                                 myAcceptorThread.isOK() == sal_True );
 398 //#endif
 399         }
 400
 401         // to cover "if ( pSockAddrIn->sin_addr.s_addr == htonl(INADDR_ANY) )" in osl_closeSocket( )
 402         void close_003()
 403         {
 404             ::osl::AcceptorSocket asSocket( osl_Socket_FamilyInet, osl_Socket_ProtocolIp, osl_Socket_TypeStream );
 405             AcceptorThread myAcceptorThread( asSocket, rtl::OUString::createFromAscii("0.0.0.0") );
 406             myAcceptorThread.create();
 407
 408             thread_sleep( 1 );
 409             asSocket.close();
 410             myAcceptorThread.join();
 411
 412             CPPUNIT_ASSERT_MESSAGE( "test for close when is accepting: the socket will quit accepting status.",
 413                                 myAcceptorThread.isOK() == sal_True );
 414         }
 415
 416         CPPUNIT_TEST_SUITE( close );
 417         CPPUNIT_TEST( close_001 );
 418         CPPUNIT_TEST( close_002 );
 419         CPPUNIT_TEST( close_003 );
 420         CPPUNIT_TEST_SUITE_END();
 421
 422     }; // class close
 423
 424     /** testing the method:
 425         inline void SAL_CALL getLocalAddr( SocketAddr &Addr ) const;
 426     */
 427
 428     class getLocalAddr : public CppUnit::TestFixture
 429     {
 430     public:
 431         oslSocket sHandle;
 432         // initialization
 433         void setUp( )
 434         {
 435             sHandle = osl_createSocket( osl_Socket_FamilyInet, osl_Socket_TypeStream, osl_Socket_ProtocolIp );
 436         }
 437
 438         void tearDown( )
 439         {
 440             sHandle = NULL;
 441         }
 442
 443         // get the Address of the local end of the socket
 444         void getLocalAddr_001()
 445         {
 446             ::osl::Socket sSocket(sHandle);
 447             ::osl::SocketAddr saBindSocketAddr( rtl::OUString::createFromAscii("127.0.0.1"), IP_PORT_MYPORT8 );
 448             ::osl::SocketAddr saLocalSocketAddr;
 449
 450             sSocket.setOption( osl_Socket_OptionReuseAddr, 1 ); //sal_True);
 451
 452             sal_Bool bOK1 = sSocket.bind( saBindSocketAddr );
 453             ::rtl::OUString suError1 = ::rtl::OUString::createFromAscii("Socket bind fail:") + sSocket.getErrorAsString();
 454             CPPUNIT_ASSERT_MESSAGE( suError1, sal_True == bOK1 );
 455
 456             sSocket.getLocalAddr( saLocalSocketAddr );
 457
 458             sal_Bool bOK = compareUString( saLocalSocketAddr.getHostname( 0 ), sSocket.getLocalHost() ) ;
 459
 460             CPPUNIT_ASSERT_MESSAGE( "test for getLocalAddr function: first create a new socket, then a socket address, bind them, and check the address.",
 461                                     sal_True == bOK );
 462         }
 463
 464
 465         CPPUNIT_TEST_SUITE( getLocalAddr );
 466         CPPUNIT_TEST( getLocalAddr_001 );
 467         CPPUNIT_TEST_SUITE_END();
 468
 469     }; // class getLocalAddr
 470
 471
 472     /** testing the method:
 473         inline sal_Int32        SAL_CALL getLocalPort() const;
 474     */
 475
 476     class getLocalPort : public CppUnit::TestFixture
 477     {
 478     public:
 479         oslSocket sHandle;
 480         // initialization
 481         void setUp( )
 482         {
 483             sHandle = osl_createSocket( osl_Socket_FamilyInet, osl_Socket_TypeStream, osl_Socket_ProtocolIp );
 484         }
 485
 486         void tearDown( )
 487         {
 488             sHandle = NULL;
 489         }
 490
 491
 492         void getLocalPort_001()
 493         {
 494             ::osl::Socket sSocket(sHandle);
 495             ::osl::SocketAddr saBindSocketAddr( rtl::OUString::createFromAscii("127.0.0.1"), IP_PORT_MYPORT7 );  // aHostIp1 localhost
 496             ::osl::SocketAddr saLocalSocketAddr;
 497
 498             sSocket.setOption( osl_Socket_OptionReuseAddr, 1 ); //sal_True);
 499
 500             sal_Bool bOK1 = sSocket.bind( saBindSocketAddr );
 501             ::rtl::OUString suError1 = ::rtl::OUString::createFromAscii("Socket bind fail:") + sSocket.getErrorAsString();
 502             CPPUNIT_ASSERT_MESSAGE( suError1, sal_True == bOK1 );
 503             sal_Bool bOK = ( IP_PORT_MYPORT7 == sSocket.getLocalPort( )  );
 504
 505             CPPUNIT_ASSERT_MESSAGE( "test for getLocalPort function: first create a new socket, then a socket address, bind them, and check the port.",
 506                                     sal_True == bOK );
 507         }
 508
 509     /**  test writer's comment:
 510
 511         the invalid port number can not be set by giving invalid port number
 512         such as 99999 or -1, it will convert to ( x mod 65535 ), so it will always be
 513         valid,  the only instance that the getLocalPort returns OSL_INVALID_PORT
 514         is when saSocketAddr itself is an invalid one, that is , the IP or host name
 515         can not be found, then the created socket address is not valid.
 516     */
 517         void getLocalPort_002()
 518         {
 519             ::osl::SocketAddr saBindSocketAddr( rtl::OUString::createFromAscii("123.45.67.89"), IP_PORT_TELNET);
 520 #ifdef WNT
 521             ::osl::Socket sSocket(sHandle);
 522             sSocket.setOption( osl_Socket_OptionReuseAddr, 1 ); // sal_True);
 523             sSocket.bind( saBindSocketAddr );
 524             //Invalid IP, so bind should fail
 525             ::rtl::OUString suError = outputError(::rtl::OUString::valueOf(sSocket.getLocalPort( )),
 526                 ::rtl::OUString::valueOf((sal_Int32)OSL_INVALID_PORT),
 527                 "test for getLocalPort function: first create a new socket, then an invalid socket address, bind them, and check the port assigned.");
 528             sal_Bool bOK = ( OSL_INVALID_PORT == sSocket.getLocalPort( ) );
 529             (void)bOK;
 530 #else
 531             //on Unix, if Addr is not an address of type osl_Socket_FamilyInet, it returns OSL_INVALID_PORT
 532             ::rtl::OUString suError = ::rtl::OUString::createFromAscii( "on Unix, if Addr is not an address of type osl_Socket_FamilyInet, it returns OSL_INVALID_PORT, but can not create Addr of that case");
 533 #endif
 534             CPPUNIT_ASSERT_MESSAGE( suError, sal_False );
 535
 536         }
 537
 538         void getLocalPort_003()
 539         {
 540             ::osl::Socket sSocket(sHandle);
 541             ::osl::SocketAddr saBindSocketAddr( getLocalIP(), IP_PORT_INVAL);
 542
 543             sSocket.setOption( osl_Socket_OptionReuseAddr, 1 ); //sal_True);
 544
 545             sal_Bool bOK1 = sSocket.bind( saBindSocketAddr );
 546             ::rtl::OUString suError1 = ::rtl::OUString::createFromAscii("Socket bind fail:") + sSocket.getErrorAsString();
 547             CPPUNIT_ASSERT_MESSAGE( suError1, sal_True == bOK1 );
 548             ::rtl::OUString suError = outputError(::rtl::OUString::valueOf(sSocket.getLocalPort( )),
 549                 ::rtl::OUString::createFromAscii("34463"),
 550                 "test for getLocalPort function: first create a new socket, then an invalid socket address, bind them, and check the port assigned");
 551             sal_Bool bOK = ( sSocket.getLocalPort( ) >= 1 &&  sSocket.getLocalPort( ) <= 65535);
 552
 553             CPPUNIT_ASSERT_MESSAGE( suError, sal_True == bOK );
 554         }
 555
 556         CPPUNIT_TEST_SUITE( getLocalPort );
 557         CPPUNIT_TEST( getLocalPort_001 );
 558 // LLA:         CPPUNIT_TEST( getLocalPort_002 );
 559         CPPUNIT_TEST( getLocalPort_003 );
 560         CPPUNIT_TEST_SUITE_END();
 561
 562     }; // class getLocalPort
 563
 564
 565     /** testing the method:
 566         inline ::rtl::OUString SAL_CALL getLocalHost() const;
 567
 568         Mindyliu: on Linux, at first it will check the binded in /etc/hosts, if it has the binded IP, it will return the hostname in it;
 569         else if the binded IP is "127.0.0.1", it will return "localhost", if it's the machine's ethernet ip such as "129.158.217.90", it
 570         will return hostname of current processor such as "aegean.PRC.Sun.COM"
 571     */
 572
 573     class getLocalHost : public CppUnit::TestFixture
 574     {
 575     public:
 576         oslSocket sHandle;
 577         // initialization
 578         void setUp( )
 579         {
 580             sHandle = osl_createSocket( osl_Socket_FamilyInet, osl_Socket_TypeStream, osl_Socket_ProtocolIp );
 581         }
 582
 583         void tearDown( )
 584         {
 585             sHandle = NULL;
 586         }
 587
 588
 589         void getLocalHost_001()
 590         {
 591             ::osl::Socket sSocket(sHandle);
 592             //port number from IP_PORT_HTTP1 to IP_PORT_MYPORT6, mindyliu
 593             ::osl::SocketAddr saBindSocketAddr( rtl::OUString::createFromAscii("127.0.0.1"), IP_PORT_MYPORT6 );
 594
 595             sSocket.setOption( osl_Socket_OptionReuseAddr, 1 ); //sal_True);
 596
 597             sal_Bool bOK1 = sSocket.bind( saBindSocketAddr );
 598             ::rtl::OUString suError1 = ::rtl::OUString::createFromAscii("Socket bind fail:") + sSocket.getErrorAsString();
 599             CPPUNIT_ASSERT_MESSAGE( suError1, sal_True == bOK1 );
 600             sal_Bool bOK;
 601             ::rtl::OUString suError;
 602 #ifdef WNT
 603             bOK = compareUString( sSocket.getLocalHost( ), getThisHostname( ) ) ;
 604             suError = outputError(sSocket.getLocalHost( ), getThisHostname( ),
 605 "test for getLocalHost function: create localhost socket and check name");
 606 #else
 607             ::rtl::OUString aUString = ::rtl::OUString::createFromAscii( (const sal_Char *) "localhost" );
 608             sal_Bool bRes1, bRes2;
 609             bRes1 = compareUString( sSocket.getLocalHost( ), aUString ) ;
 610             bRes2 = compareUString( sSocket.getLocalHost( ), saBindSocketAddr.getHostname(0) ) ;
 611             bOK = bRes1 || bRes2;
 612             suError = outputError(sSocket.getLocalHost( ), aUString, "test for getLocalHost function: create localhost socket and check name");
 613 #endif
 614             CPPUNIT_ASSERT_MESSAGE( suError, sal_True == bOK );
 615         }
 616
 617         void getLocalHost_002()
 618         {
 619             ::osl::Socket sSocket(sHandle);
 620             ::osl::SocketAddr saBindSocketAddr( rtl::OUString::createFromAscii("123.45.67.89"), IP_PORT_POP3);
 621             ::osl::SocketAddr saLocalSocketAddr;
 622
 623             sSocket.setOption( osl_Socket_OptionReuseAddr, 1 ); //sal_True);
 624             sSocket.bind( saBindSocketAddr );
 625             //Invalid IP, so bind should fail
 626             sal_Bool bOK = compareUString( sSocket.getLocalHost( ), rtl::OUString::createFromAscii("") ) ;
 627             ::rtl::OUString suError = outputError(sSocket.getLocalHost( ), rtl::OUString::createFromAscii(""), "test for getLocalHost function: getLocalHost with invalid SocketAddr");
 628
 629             CPPUNIT_ASSERT_MESSAGE( suError, sal_True == bOK );
 630         }
 631
 632         CPPUNIT_TEST_SUITE( getLocalHost );
 633         CPPUNIT_TEST( getLocalHost_001 );
 634         CPPUNIT_TEST( getLocalHost_002 );
 635         CPPUNIT_TEST_SUITE_END();
 636
 637     }; // class getLocalHost
 638
 639
 640     /** testing the methods:
 641         inline void SAL_CALL getPeerAddr( SocketAddr & Addr) const;
 642         inline sal_Int32        SAL_CALL getPeerPort() const;
 643         inline ::rtl::OUString SAL_CALL getPeerHost() const;
 644     */
 645     class getPeer : public CppUnit::TestFixture
 646     {
 647     public:
 648         oslSocket sHandle;
 649         TimeValue *pTimeout;
 650         ::osl::AcceptorSocket asAcceptorSocket;
 651         ::osl::ConnectorSocket csConnectorSocket;
 652
 653
 654         // initialization
 655         void setUp( )
 656         {
 657             pTimeout  = ( TimeValue* )malloc( sizeof( TimeValue ) );
 658             pTimeout->Seconds = 3;
 659             pTimeout->Nanosec = 0;
 660             sHandle = osl_createSocket( osl_Socket_FamilyInet, osl_Socket_TypeStream, osl_Socket_ProtocolIp );
 661         }
 662
 663         void tearDown( )
 664         {
 665             free( pTimeout );
 666             sHandle = NULL;
 667             asAcceptorSocket.close( );
 668             csConnectorSocket.close( );
 669         }
 670
 671
 672         void getPeer_001()
 673         {
 674             ::osl::SocketAddr saLocalSocketAddr( rtl::OUString::createFromAscii("127.0.0.1"), IP_PORT_MYPORT );
 675             ::osl::SocketAddr saTargetSocketAddr( rtl::OUString::createFromAscii("127.0.0.1"), IP_PORT_MYPORT );
 676             ::osl::SocketAddr saPeerSocketAddr( rtl::OUString::createFromAscii("129.158.217.202"), IP_PORT_FTP );
 677             ::osl::StreamSocket ssConnection;
 678             asAcceptorSocket.setOption( osl_Socket_OptionReuseAddr, 1 ); //sal_True);
 679             /// launch server socket
 680             sal_Bool bOK1 = asAcceptorSocket.bind( saLocalSocketAddr );
 681             CPPUNIT_ASSERT_MESSAGE( "AcceptorSocket bind '127.0.0.1' address failed.", sal_True == bOK1 );
 682             sal_Bool bOK2 = asAcceptorSocket.listen( 1 );
 683             CPPUNIT_ASSERT_MESSAGE( "AcceptorSocket listen failed.",  sal_True == bOK2 );
 684
 685             asAcceptorSocket.enableNonBlockingMode( sal_True );
 686             asAcceptorSocket.acceptConnection(ssConnection); /// waiting for incoming connection...
 687
 688             /// launch client socket
 689             csConnectorSocket.connect( saTargetSocketAddr, pTimeout );   /// connecting to server...
 690
 691             /// get peer information
 692             csConnectorSocket.getPeerAddr( saPeerSocketAddr );/// connected.
 693             sal_Int32 peerPort = csConnectorSocket.getPeerPort( );
 694             ::rtl::OUString peerHost = csConnectorSocket.getPeerHost( );
 695
 696             CPPUNIT_ASSERT_MESSAGE( "test for getPeer function: setup a connection and then get the peer address, port and host from client side.",
 697                                     ( sal_True == compareSocketAddr( saPeerSocketAddr, saLocalSocketAddr ) )&&
 698                                     ( sal_True == compareUString( peerHost, saLocalSocketAddr.getHostname( 0 ) ) ) &&
 699                                     ( peerPort == saLocalSocketAddr.getPort( ) ));
 700         }
 701
 702
 703         CPPUNIT_TEST_SUITE( getPeer );
 704         CPPUNIT_TEST( getPeer_001 );
 705         CPPUNIT_TEST_SUITE_END();
 706
 707     }; // class getPeer
 708
 709
 710     /** testing the methods:
 711         inline sal_Bool SAL_CALL bind(const SocketAddr& LocalInterface);
 712     */
 713
 714
 715     class bind : public CppUnit::TestFixture
 716     {
 717     public:
 718         oslSocket sHandle;
 719         // initialization
 720         void setUp( )
 721         {
 722             sHandle = osl_createSocket( osl_Socket_FamilyInet, osl_Socket_TypeStream, osl_Socket_ProtocolIp );
 723         }
 724
 725         void tearDown( )
 726         {
 727             sHandle = NULL;
 728         }
 729
 730
 731         void bind_001()
 732         {
 733             ::osl::Socket sSocket(sHandle);
 734             //bind must use local IP address ---mindyliu
 735             ::osl::SocketAddr saBindSocketAddr( getLocalIP(), IP_PORT_MYPORT5 );
 736
 737             sSocket.setOption( osl_Socket_OptionReuseAddr, 1 ); //sal_True);
 738             sal_Bool bOK1 = sSocket.bind( saBindSocketAddr );
 739             CPPUNIT_ASSERT_MESSAGE( "Socket bind fail.", sal_True == bOK1 );
 740
 741             sal_Bool bOK2 = compareUString( sSocket.getLocalHost( ), saBindSocketAddr.getHostname( ) ) ;
 742
 743             sSocket.close();
 744             CPPUNIT_ASSERT_MESSAGE( "test for bind function: bind a valid address.", sal_True == bOK2 );
 745         }
 746
 747         void bind_002()
 748         {
 749             ::osl::Socket sSocket(sHandle);
 750             ::osl::SocketAddr saBindSocketAddr( rtl::OUString::createFromAscii("123.45.67.89"), IP_PORT_NETBIOS );
 751             ::osl::SocketAddr saLocalSocketAddr;
 752
 753             sSocket.setOption( osl_Socket_OptionReuseAddr, 1); // sal_True);
 754             sal_Bool bOK1 = sSocket.bind( saBindSocketAddr );
 755             sal_Bool bOK2 = compareUString( sSocket.getLocalHost( ), getThisHostname( ) ) ;
 756
 757             CPPUNIT_ASSERT_MESSAGE( "test for bind function: bind a valid address.",
 758                                     ( sal_False == bOK1 ) && ( sal_False == bOK2 ) );
 759         }
 760
 761         CPPUNIT_TEST_SUITE( bind );
 762         CPPUNIT_TEST( bind_001 );
 763         CPPUNIT_TEST( bind_002 );
 764         CPPUNIT_TEST_SUITE_END();
 765
 766     }; // class bind
 767
 768
 769     /** testing the methods:
 770         inline sal_Bool SAL_CALL isRecvReady(const TimeValue *pTimeout = 0) const;
 771
 772     */
 773     class isRecvReady : public CppUnit::TestFixture
 774     {
 775     public:
 776         oslSocket sHandle;
 777         TimeValue *pTimeout;
 778         ::osl::AcceptorSocket asAcceptorSocket;
 779         ::osl::ConnectorSocket csConnectorSocket;
 780
 781
 782         // initialization
 783         void setUp( )
 784         {
 785             pTimeout  = ( TimeValue* )malloc( sizeof( TimeValue ) );
 786             pTimeout->Seconds = 3;
 787             pTimeout->Nanosec = 0;
 788             sHandle = osl_createSocket( osl_Socket_FamilyInet, osl_Socket_TypeStream, osl_Socket_ProtocolIp );
 789         }
 790
 791         void tearDown( )
 792         {
 793             free( pTimeout );
 794             sHandle = NULL;
 795             asAcceptorSocket.close( );
 796             csConnectorSocket.close( );
 797         }
 798
 799
 800         void isRecvReady_001()
 801         {
 802             ::osl::SocketAddr saLocalSocketAddr( rtl::OUString::createFromAscii("127.0.0.1"), IP_PORT_MYPORT1 );
 803             ::osl::SocketAddr saTargetSocketAddr( rtl::OUString::createFromAscii("127.0.0.1"), IP_PORT_MYPORT1 );
 804             ::osl::SocketAddr saPeerSocketAddr( rtl::OUString::createFromAscii("129.158.217.202"), IP_PORT_FTP );
 805             ::osl::StreamSocket ssConnection;
 806             /// launch server socket
 807             asAcceptorSocket.setOption( osl_Socket_OptionReuseAddr, 1 ); // sal_True);
 808             sal_Bool bOK1 = asAcceptorSocket.bind( saLocalSocketAddr );
 809             CPPUNIT_ASSERT_MESSAGE( "AcceptorSocket bind address failed.", sal_True == bOK1 );
 810             sal_Bool bOK2 = asAcceptorSocket.listen( 1 );
 811             CPPUNIT_ASSERT_MESSAGE( "AcceptorSocket listen failed.",  sal_True == bOK2 );
 812             asAcceptorSocket.enableNonBlockingMode( sal_True );
 813             asAcceptorSocket.acceptConnection(ssConnection); /// waiting for incoming connection...
 814
 815             /// launch client socket
 816             csConnectorSocket.connect( saTargetSocketAddr, pTimeout );   /// connecting to server...
 817
 818             /// is receive ready?
 819             sal_Bool bOK3 = asAcceptorSocket.isRecvReady( pTimeout );
 820
 821             CPPUNIT_ASSERT_MESSAGE( "test for isRecvReady function: setup a connection and then check if it can transmit data.",
 822                                       ( sal_True == bOK3 ) );
 823         }
 824
 825
 826         CPPUNIT_TEST_SUITE( isRecvReady );
 827         CPPUNIT_TEST( isRecvReady_001 );
 828         CPPUNIT_TEST_SUITE_END();
 829
 830     }; // class isRecvReady
 831
 832
 833     /** testing the methods:
 834         inline sal_Bool SAL_CALL isSendReady(const TimeValue *pTimeout = 0) const;
 835     */
 836     class isSendReady : public CppUnit::TestFixture
 837     {
 838     public:
 839         oslSocket sHandle;
 840         TimeValue *pTimeout;
 841         ::osl::AcceptorSocket asAcceptorSocket;
 842         ::osl::ConnectorSocket csConnectorSocket;
 843
 844
 845         // initialization
 846         void setUp( )
 847         {
 848             pTimeout  = ( TimeValue* )malloc( sizeof( TimeValue ) );
 849             pTimeout->Seconds = 3;
 850             pTimeout->Nanosec = 0;
 851             sHandle = osl_createSocket( osl_Socket_FamilyInet, osl_Socket_TypeStream, osl_Socket_ProtocolIp );
 852         }
 853
 854         void tearDown( )
 855         {
 856             free( pTimeout );
 857             sHandle = NULL;
 858             asAcceptorSocket.close( );
 859             csConnectorSocket.close( );
 860         }
 861
 862
 863         void isSendReady_001()
 864         {
 865             ::osl::SocketAddr saLocalSocketAddr( rtl::OUString::createFromAscii("127.0.0.1"), IP_PORT_MYPORT );
 866             ::osl::SocketAddr saTargetSocketAddr( rtl::OUString::createFromAscii("127.0.0.1"), IP_PORT_MYPORT );
 867             ::osl::SocketAddr saPeerSocketAddr( rtl::OUString::createFromAscii("129.158.217.202"), IP_PORT_FTP );
 868             ::osl::StreamSocket ssConnection;
 869
 870             /// launch server socket
 871             asAcceptorSocket.setOption( osl_Socket_OptionReuseAddr, 1 ); //sal_True);
 872             sal_Bool bOK1 = asAcceptorSocket.bind( saLocalSocketAddr );
 873             CPPUNIT_ASSERT_MESSAGE( "AcceptorSocket bind address failed.", sal_True == bOK1 );
 874             sal_Bool bOK2 = asAcceptorSocket.listen( 1 );
 875             CPPUNIT_ASSERT_MESSAGE( "AcceptorSocket listen failed.",  sal_True == bOK2 );
 876             asAcceptorSocket.enableNonBlockingMode( sal_True );
 877             asAcceptorSocket.acceptConnection(ssConnection); /// waiting for incoming connection...
 878
 879             /// launch client socket
 880             csConnectorSocket.connect( saTargetSocketAddr, pTimeout );   /// connecting to server...
 881
 882             /// is send ready?
 883             sal_Bool bOK3 = csConnectorSocket.isSendReady( pTimeout );
 884
 885             CPPUNIT_ASSERT_MESSAGE( "test for isSendReady function: setup a connection and then check if it can transmit data.",
 886                                       ( sal_True == bOK3 ) );
 887         }
 888
 889
 890         CPPUNIT_TEST_SUITE( isSendReady );
 891         CPPUNIT_TEST( isSendReady_001 );
 892         CPPUNIT_TEST_SUITE_END();
 893
 894     }; // class isSendReady
 895
 896
 897     /** testing the methods:
 898         inline oslSocketType    SAL_CALL getType() const;
 899
 900     */
 901
 902     class getType : public CppUnit::TestFixture
 903     {
 904     public:
 905         oslSocket sHandle;
 906         // initialization
 907         void setUp( )
 908         {
 909
 910         }
 911
 912         void tearDown( )
 913         {
 914             sHandle = NULL;
 915         }
 916
 917
 918         void getType_001()
 919         {
 920             sHandle = osl_createSocket( osl_Socket_FamilyInet, osl_Socket_TypeStream, osl_Socket_ProtocolIp );
 921             ::osl::Socket sSocket(sHandle);
 922
 923             CPPUNIT_ASSERT_MESSAGE( "test for getType function: get type of socket.",
 924                                     osl_Socket_TypeStream ==  sSocket.getType( ) );
 925         }
 926
 927         void getType_002()
 928         {
 929             sHandle = osl_createSocket( osl_Socket_FamilyInet, osl_Socket_TypeDgram, osl_Socket_ProtocolIp );
 930             ::osl::Socket sSocket(sHandle);
 931
 932             CPPUNIT_ASSERT_MESSAGE( "test for getType function: get type of socket.",
 933                                     osl_Socket_TypeDgram ==  sSocket.getType( ) );
 934         }
 935
 936 #ifdef UNX
 937         // mindy: since on LINUX and SOLARIS, Raw type socket can not be created, so do not test getType() here
 938         // mindy: and add one test case to test creating Raw type socket--> ctors_TypeRaw()
 939         void getType_003()
 940         {
 941             CPPUNIT_ASSERT_MESSAGE( "test for getType function: get type of socket.this is not passed in (LINUX, SOLARIS), the osl_Socket_TypeRaw, type socket can not be created.",
 942                                     sal_True);
 943         }
 944 #else
 945         void getType_003()
 946         {
 947             sHandle = osl_createSocket( osl_Socket_FamilyInet, osl_Socket_TypeRaw, osl_Socket_ProtocolIp );
 948             ::osl::Socket sSocket(sHandle);
 949
 950             CPPUNIT_ASSERT_MESSAGE( "test for getType function: get type of socket.",
 951                                     osl_Socket_TypeRaw ==  sSocket.getType( ) );
 952         }
 953 #endif
 954
 955         CPPUNIT_TEST_SUITE( getType );
 956         CPPUNIT_TEST( getType_001 );
 957         CPPUNIT_TEST( getType_002 );
 958         CPPUNIT_TEST( getType_003 );
 959         CPPUNIT_TEST_SUITE_END();
 960
 961     }; // class getType
 962
 963
 964
 965     /** testing the methods:
 966         inline sal_Int32 SAL_CALL getOption(
 967             oslSocketOption Option,
 968             void* pBuffer,
 969             sal_uInt32 BufferLen,
 970             oslSocketOptionLevel Level= osl_Socket_LevelSocket) const;
 971
 972         inline sal_Int32 getOption( oslSocketOption option ) const;
 973
 974     */
 975
 976     class getOption : public CppUnit::TestFixture
 977     {
 978     public:
 979         oslSocket sHandle;
 980         // initialization
 981         void setUp( )
 982         {
 983
 984         }
 985
 986         void tearDown( )
 987         {
 988             sHandle = NULL;
 989         }
 990
 991         /**  test writer's comment:
 992
 993             in oslSocketOption, the osl_Socket_OptionType denote 1 as osl_Socket_TypeStream.
 994             2 as osl_Socket_TypeDgram, etc which is not mapping the oslSocketType enum. differ
 995             in 1.
 996         */
 997
 998         void getOption_001()
 999         {
1000             sHandle = osl_createSocket( osl_Socket_FamilyInet, osl_Socket_TypeStream, osl_Socket_ProtocolIp );
1001             ::osl::Socket sSocket(sHandle);
1002             sal_Int32 * pType = ( sal_Int32 * )malloc( sizeof ( sal_Int32 ) );
1003             *pType = 0;
1004             sSocket.getOption( osl_Socket_OptionType,  pType, sizeof ( sal_Int32 ) );
1005             sal_Bool bOK = ( SOCK_STREAM ==  *pType );
1006             // there is a TypeMap(socket.c) which map osl_Socket_TypeStream to SOCK_STREAM on UNX, and SOCK_STREAM != osl_Socket_TypeStream
1007             //sal_Bool bOK = ( TYPE_TO_NATIVE(osl_Socket_TypeStream) ==  *pType );
1008             free( pType );
1009
1010             CPPUNIT_ASSERT_MESSAGE( "test for getOption function: get type option of socket.",
1011                                     sal_True == bOK );
1012         }
1013
1014         // getsockopt error
1015         void getOption_004()
1016         {
1017             sHandle = osl_createSocket( osl_Socket_FamilyInet, osl_Socket_TypeDgram, osl_Socket_ProtocolIp );
1018             ::osl::Socket sSocket(sHandle);
1019
1020             sal_Bool * pbDontRoute = ( sal_Bool * )malloc( sizeof ( sal_Bool ) );
1021             sal_Int32 nRes = sSocket.getOption( osl_Socket_OptionInvalid,  pbDontRoute, sizeof ( sal_Bool ) );
1022             free( pbDontRoute );
1023
1024             CPPUNIT_ASSERT_MESSAGE( "test for getOption function: get invalid option of socket, should return -1.",
1025                                      nRes  ==  -1 );
1026         }
1027
1028         void getOption_simple_001()
1029         {
1030             sHandle = osl_createSocket( osl_Socket_FamilyInet, osl_Socket_TypeDgram, osl_Socket_ProtocolIp );
1031             ::osl::Socket sSocket(sHandle);
1032
1033             sal_Bool bOK = ( sal_False  ==  sSocket.getOption( osl_Socket_OptionDontRoute ) );
1034
1035             CPPUNIT_ASSERT_MESSAGE( "test for getOption function: get debug option of socket.",
1036                                     sal_True == bOK );
1037         }
1038
1039         void getOption_simple_002()
1040         {
1041             sHandle = osl_createSocket( osl_Socket_FamilyInet, osl_Socket_TypeDgram, osl_Socket_ProtocolIp );
1042             ::osl::Socket sSocket(sHandle);
1043
1044             sal_Bool bOK = ( sal_False  ==  sSocket.getOption( osl_Socket_OptionDebug ) );
1045
1046             CPPUNIT_ASSERT_MESSAGE( "test for getOption function: get debug option of socket.",
1047                                     sal_True == bOK );
1048         }
1049
1050         CPPUNIT_TEST_SUITE( getOption );
1051         CPPUNIT_TEST( getOption_001 );
1052         CPPUNIT_TEST( getOption_004 );
1053         CPPUNIT_TEST( getOption_simple_001 );
1054         CPPUNIT_TEST( getOption_simple_002 );
1055         CPPUNIT_TEST_SUITE_END();
1056
1057     }; // class getOption
1058
1059
1060     /** testing the methods:
1061         inline sal_Bool SAL_CALL setOption( oslSocketOption Option,
1062                                             void* pBuffer,
1063                                             sal_uInt32 BufferLen,
1064                                             oslSocketOptionLevel Level= osl_Socket_LevelSocket ) const;
1065     */
1066
1067     class setOption : public CppUnit::TestFixture
1068     {
1069     public:
1070         TimeValue *pTimeout;
1071 // LLA: maybe there is an error in the source,
1072 //      as long as I remember, if a derived class do not overload all ctors there is a problem.
1073
1074         ::osl::AcceptorSocket asAcceptorSocket;
1075
1076         void setUp( )
1077         {
1078
1079         }
1080
1081         void tearDown( )
1082         {
1083             asAcceptorSocket.close( );
1084         }
1085
1086
1087         // LLA:
1088         // getSocketOption returns BufferLen, or -1 if something failed
1089
1090         // setSocketOption returns sal_True, if option could stored
1091         // else sal_False
1092
1093         void setOption_001()
1094         {
1095             /// set and get option.
1096             int nBufferLen = sizeof ( sal_Int32);
1097             // LLA: SO_DONTROUTE expect an integer boolean, what ever it is, it's not sal_Bool!
1098
1099             sal_Int32 * pbDontRouteSet = ( sal_Int32 * )malloc( sizeof ( sal_Int32 ) );
1100             *pbDontRouteSet = 1; // sal_True;
1101
1102             sal_Int32 * pGetBuffer = ( sal_Int32 * )malloc( sizeof ( sal_Int32 ) );
1103             *pGetBuffer = 0;
1104
1105             // maybe asAcceptorSocket is not right initialized
1106             sal_Bool  b1 = asAcceptorSocket.setOption( osl_Socket_OptionDontRoute,  pbDontRouteSet, nBufferLen );
1107             CPPUNIT_ASSERT_MESSAGE( "setOption function failed.", ( sal_True == b1 ) );
1108             sal_Int32 n2 = asAcceptorSocket.getOption( osl_Socket_OptionDontRoute,  pGetBuffer, nBufferLen );
1109             CPPUNIT_ASSERT_MESSAGE( "getOption function failed.", ( n2 == nBufferLen ) );
1110
1111             // on Linux, the value of option is 1, on Solaris, it's 16, but it's not important the exact value,
1112             // just judge it is zero or not!
1113             sal_Bool bOK = ( 0  !=  *pGetBuffer );
1114             t_print("#setOption_001: getOption is %d \n", *pGetBuffer);
1115
1116             // toggle check, set to 0
1117             *pbDontRouteSet = 0;
1118
1119             sal_Bool  b3 = asAcceptorSocket.setOption( osl_Socket_OptionDontRoute,  pbDontRouteSet, sizeof ( sal_Int32 ) );
1120             CPPUNIT_ASSERT_MESSAGE( "setOption function failed.", ( sal_True == b3 ) );
1121             sal_Int32 n4 = asAcceptorSocket.getOption( osl_Socket_OptionDontRoute,  pGetBuffer, nBufferLen );
1122             CPPUNIT_ASSERT_MESSAGE( "getOption (DONTROUTE) function failed.", ( n4 == nBufferLen ) );
1123
1124             sal_Bool bOK2 = ( 0  ==  *pGetBuffer );
1125
1126             t_print("#setOption_001: getOption is %d \n", *pGetBuffer);
1127
1128 // LLA:                         sal_Bool * pbDontTouteSet = ( sal_Bool * )malloc( sizeof ( sal_Bool ) );
1129 // LLA:                         *pbDontTouteSet = sal_True;
1130 // LLA:                         sal_Bool * pbDontTouteGet = ( sal_Bool * )malloc( sizeof ( sal_Bool ) );
1131 // LLA:                         *pbDontTouteGet = sal_False;
1132 // LLA:                         asAcceptorSocket.setOption( osl_Socket_OptionDontRoute,  pbDontTouteSet, sizeof ( sal_Bool ) );
1133 // LLA:                         asAcceptorSocket.getOption( osl_Socket_OptionDontRoute,  pbDontTouteGet, sizeof ( sal_Bool ) );
1134 // LLA:                         ::rtl::OUString suError = outputError(::rtl::OUString::valueOf((sal_Int32)*pbDontTouteGet),
1135 // LLA:                                 ::rtl::OUString::valueOf((sal_Int32)*pbDontTouteSet),
1136 // LLA:                                 "test for setOption function: set osl_Socket_OptionDontRoute and then check");
1137 // LLA:
1138 // LLA:                         sal_Bool bOK = ( sal_True  ==  *pbDontTouteGet );
1139 // LLA:                         free( pbDontTouteSet );
1140 // LLA:                         free( pbDontTouteGet );
1141
1142             CPPUNIT_ASSERT_MESSAGE( "test for setOption function: set option of a socket and then check.",
1143                                       ( sal_True == bOK ) && (sal_True == bOK2) );
1144
1145             free( pbDontRouteSet );
1146             free( pGetBuffer );
1147 // LLA:                         CPPUNIT_ASSERT_MESSAGE( suError, sal_True == bOK );
1148         }
1149
1150         void setOption_002()
1151         {
1152             /// set and get option.
1153
1154             // sal_Int32 * pbLingerSet = ( sal_Int32 * )malloc( nBufferLen );
1155             // *pbLingerSet = 7;
1156             // sal_Int32 * pbLingerGet = ( sal_Int32 * )malloc( nBufferLen );
1157                     /* struct */linger aLingerSet;
1158                     sal_Int32 nBufferLen = sizeof( struct linger );
1159                     aLingerSet.l_onoff = 1;
1160                     aLingerSet.l_linger = 7;
1161
1162                    linger aLingerGet;
1163
1164             asAcceptorSocket.setOption( osl_Socket_OptionLinger,  &aLingerSet, nBufferLen );
1165
1166             sal_Int32 n1 = asAcceptorSocket.getOption( osl_Socket_OptionLinger,  &aLingerGet, nBufferLen );
1167                     CPPUNIT_ASSERT_MESSAGE( "getOption (SO_LINGER) function failed.", ( n1 == nBufferLen ) );
1168
1169             //t_print("#setOption_002: getOption is %d \n", aLingerGet.l_linger);
1170             sal_Bool bOK = ( 7  ==  aLingerGet.l_linger );
1171             CPPUNIT_ASSERT_MESSAGE( "test for setOption function: set option of a socket and then check. ",
1172                 sal_True == bOK );
1173
1174         }
1175
1176         void setOption_003()
1177         {
1178             linger aLingerSet;
1179                 aLingerSet.l_onoff = 1;
1180                     aLingerSet.l_linger = 7;
1181
1182             sal_Bool b1 = asAcceptorSocket.setOption( osl_Socket_OptionLinger,  &aLingerSet, 0 );
1183                     printUString( asAcceptorSocket.getErrorAsString( ) );
1184             CPPUNIT_ASSERT_MESSAGE( "setOption (SO_LINGER) function failed for optlen is 0.",
1185                 ( b1 == sal_False ) );
1186         }
1187
1188         void setOption_simple_001()
1189         {
1190             /// set and get option.
1191             asAcceptorSocket.setOption( osl_Socket_OptionDontRoute, 1 ); //sal_True );
1192             sal_Bool bOK = ( 0  !=  asAcceptorSocket.getOption( osl_Socket_OptionDontRoute ) );
1193
1194             t_print("setOption_simple_001(): getoption is %d \n", asAcceptorSocket.getOption( osl_Socket_OptionDontRoute ) );
1195             CPPUNIT_ASSERT_MESSAGE( "test for setOption function: set option of a socket and then check.",
1196                                       ( sal_True == bOK ) );
1197         }
1198
1199         void setOption_simple_002()
1200         {
1201             /// set and get option.
1202             // LLA: this does not work, due to the fact that SO_LINGER is a structure
1203 // LLA:                 asAcceptorSocket.setOption( osl_Socket_OptionLinger,  7 );
1204 // LLA:                 sal_Bool bOK = ( 7  ==  asAcceptorSocket.getOption( osl_Socket_OptionLinger ) );
1205
1206 // LLA:                 CPPUNIT_ASSERT_MESSAGE( "test for setOption function: set option of a socket and then check.",
1207 // LLA:                                                                         ( sal_True == bOK ) );
1208         }
1209
1210         CPPUNIT_TEST_SUITE( setOption );
1211         CPPUNIT_TEST( setOption_001 );
1212         CPPUNIT_TEST( setOption_002 );
1213         CPPUNIT_TEST( setOption_003 );
1214         CPPUNIT_TEST( setOption_simple_001 );
1215 // LLA:         CPPUNIT_TEST( setOption_simple_002 );
1216         CPPUNIT_TEST_SUITE_END();
1217
1218     }; // class setOption
1219
1220
1221
1222     /** testing the method:
1223         inline sal_Bool SAL_CALL enableNonBlockingMode( sal_Bool bNonBlockingMode);
1224     */
1225     class enableNonBlockingMode : public CppUnit::TestFixture
1226     {
1227     public:
1228         ::osl::AcceptorSocket asAcceptorSocket;
1229
1230         void enableNonBlockingMode_001()
1231         {
1232             ::osl::SocketAddr saLocalSocketAddr( rtl::OUString::createFromAscii("127.0.0.1"), IP_PORT_MYPORT );
1233             ::osl::StreamSocket ssConnection;
1234
1235             /// launch server socket
1236             asAcceptorSocket.setOption( osl_Socket_OptionReuseAddr, 1 ); //sal_True);
1237             sal_Bool bOK1 = asAcceptorSocket.bind( saLocalSocketAddr );
1238             CPPUNIT_ASSERT_MESSAGE( "AcceptorSocket bind address failed.", sal_True == bOK1 );
1239             sal_Bool bOK2 = asAcceptorSocket.listen( 1 );
1240             CPPUNIT_ASSERT_MESSAGE( "AcceptorSocket listen failed.",  sal_True == bOK2 );
1241             asAcceptorSocket.enableNonBlockingMode( sal_True );
1242             asAcceptorSocket.acceptConnection(ssConnection); /// waiting for incoming connection...
1243
1244             /// if reach this statement, it is non-blocking mode, since acceptConnection will blocked by default.
1245             sal_Bool bOK  = sal_True;
1246             asAcceptorSocket.close( );
1247
1248             CPPUNIT_ASSERT_MESSAGE( "test for enableNonBlockingMode function: launch a server socket and make it non blocking. if it can pass the acceptConnection statement, it is non-blocking",
1249                                       ( sal_True == bOK  ) );
1250         }
1251
1252
1253         CPPUNIT_TEST_SUITE( enableNonBlockingMode );
1254         CPPUNIT_TEST( enableNonBlockingMode_001 );
1255         CPPUNIT_TEST_SUITE_END();
1256
1257     }; // class enableNonBlockingMode
1258
1259
1260     /** testing the method:
1261         inline sal_Bool SAL_CALL isNonBlockingMode() const;
1262     */
1263     class isNonBlockingMode : public CppUnit::TestFixture
1264     {
1265     public:
1266         ::osl::AcceptorSocket asAcceptorSocket;
1267
1268         void isNonBlockingMode_001()
1269         {
1270             ::osl::SocketAddr saLocalSocketAddr( rtl::OUString::createFromAscii("127.0.0.1"), IP_PORT_MYPORT );
1271             ::osl::StreamSocket ssConnection;
1272
1273             /// launch server socket
1274             asAcceptorSocket.setOption( osl_Socket_OptionReuseAddr, 1 ); // sal_True);
1275             sal_Bool bOK1 = asAcceptorSocket.bind( saLocalSocketAddr );
1276             CPPUNIT_ASSERT_MESSAGE( "AcceptorSocket bind address failed.", sal_True == bOK1 );
1277             sal_Bool bOK2 = asAcceptorSocket.listen( 1 );
1278             CPPUNIT_ASSERT_MESSAGE( "AcceptorSocket listen failed.",  sal_True == bOK2 );
1279
1280             sal_Bool bOK3 = asAcceptorSocket.isNonBlockingMode( );
1281             asAcceptorSocket.enableNonBlockingMode( sal_True );
1282              asAcceptorSocket.acceptConnection(ssConnection); /// waiting for incoming connection...
1283
1284             /// if reach this statement, it is non-blocking mode, since acceptConnection will blocked by default.
1285             sal_Bool bOK4 = asAcceptorSocket.isNonBlockingMode( );
1286             asAcceptorSocket.close( );
1287
1288             CPPUNIT_ASSERT_MESSAGE( "test for isNonBlockingMode function: launch a server socket and make it non blocking. it is expected to change from blocking mode to non-blocking mode.",
1289                                       ( sal_False == bOK3 ) && ( sal_True == bOK4 ) );
1290         }
1291
1292
1293         CPPUNIT_TEST_SUITE( isNonBlockingMode );
1294         CPPUNIT_TEST( isNonBlockingMode_001 );
1295         CPPUNIT_TEST_SUITE_END();
1296
1297     }; // class isNonBlockingMode
1298
1299     /** testing the method:
1300         inline void     SAL_CALL clearError() const;
1301     */
1302     class clearError : public CppUnit::TestFixture
1303     {
1304     public:
1305         oslSocket sHandle;
1306         // initialization
1307         void setUp( )
1308         {
1309             sHandle = osl_createSocket( osl_Socket_FamilyInet, osl_Socket_TypeStream, osl_Socket_ProtocolIp );
1310         }
1311
1312         void tearDown( )
1313         {
1314             sHandle = NULL;
1315         }
1316
1317
1318         void clearError_001()
1319         {
1320             ::osl::Socket sSocket(sHandle);
1321             ::osl::SocketAddr saBindSocketAddr( rtl::OUString::createFromAscii("123.45.67.89"), IP_PORT_HTTP2 );
1322             ::osl::SocketAddr saLocalSocketAddr;
1323             sSocket.setOption( osl_Socket_OptionReuseAddr, 1 ); //sal_True);
1324             sSocket.bind( saBindSocketAddr );//build an error "osl_Socket_E_AddrNotAvail"
1325             oslSocketError seBind = sSocket.getError( );
1326             sSocket.clearError( );
1327
1328             CPPUNIT_ASSERT_MESSAGE( "test for clearError function: trick an error called sSocket.getError( ), and then clear the error states, check the result.",
1329                                     osl_Socket_E_None == sSocket.getError( ) && seBind != osl_Socket_E_None  );
1330         }
1331
1332
1333         CPPUNIT_TEST_SUITE( clearError );
1334         CPPUNIT_TEST( clearError_001 );
1335         CPPUNIT_TEST_SUITE_END();
1336
1337     }; // class clearError
1338
1339
1340     /** testing the methods:
1341         inline oslSocketError getError() const;
1342         inline ::rtl::OUString getErrorAsString( ) const;
1343     */
1344     class getError : public CppUnit::TestFixture
1345     {
1346     public:
1347         oslSocket sHandle;
1348         // initialization
1349         void setUp( )
1350         {
1351             sHandle = osl_createSocket( osl_Socket_FamilyInet, osl_Socket_TypeStream, osl_Socket_ProtocolIp );
1352         }
1353
1354         void tearDown( )
1355         {
1356             sHandle = NULL;
1357         }
1358
1359
1360         void getError_001()
1361         {
1362             ::osl::Socket sSocket(sHandle);
1363             ::osl::SocketAddr saBindSocketAddr( rtl::OUString::createFromAscii("127.0.0.1"), IP_PORT_FTP );
1364             ::osl::SocketAddr saLocalSocketAddr;
1365
1366             CPPUNIT_ASSERT_MESSAGE( "test for getError function: should get no error.",
1367                                     osl_Socket_E_None == sSocket.getError( )  );
1368         }
1369
1370         void getError_002()
1371         {
1372             ::osl::Socket sSocket(sHandle);
1373             ::osl::SocketAddr saBindSocketAddr( rtl::OUString::createFromAscii("123.45.67.89"), IP_PORT_FTP );
1374             ::osl::SocketAddr saLocalSocketAddr;
1375             sSocket.setOption( osl_Socket_OptionReuseAddr, 1 ); //sal_True);
1376             sSocket.bind( saBindSocketAddr );//build an error "osl_Socket_E_AddrNotAvail"
1377             //on Solaris, the error no is EACCES, but it has no mapped value, so getError() returned osl_Socket_E_InvalidError.
1378 #if defined(SOLARIS)
1379             CPPUNIT_ASSERT_MESSAGE( "trick an error called sSocket.getError( ), check the getError result.Failed on Solaris, returned osl_Socket_E_InvalidError because no entry to map the errno EACCES. ",
1380                                     osl_Socket_E_InvalidError == sSocket.getError( )  );
1381 #else
1382             //while on Linux & Win32, the errno is EADDRNOTAVAIL, getError returned osl_Socket_E_AddrNotAvail.
1383
1384             CPPUNIT_ASSERT_MESSAGE( "trick an error called sSocket.getError( ), check the getError result.Failed on Solaris, returned osl_Socket_E_InvalidError because no entry to map the errno EACCES. Passed on Linux & Win32",
1385                                     osl_Socket_E_AddrNotAvail == sSocket.getError( )  );
1386 #endif
1387         }
1388
1389         CPPUNIT_TEST_SUITE( getError );
1390         CPPUNIT_TEST( getError_001 );
1391         CPPUNIT_TEST( getError_002 );
1392         CPPUNIT_TEST_SUITE_END();
1393
1394     }; // class getError
1395
1396
1397
1398     /** testing the methods:
1399         inline oslSocket getHandle() const;
1400     */
1401
1402     class getHandle : public CppUnit::TestFixture
1403     {
1404     public:
1405         oslSocket sHandle;
1406         // initialization
1407         void setUp( )
1408         {
1409             sHandle = osl_createSocket( osl_Socket_FamilyInet, osl_Socket_TypeStream, osl_Socket_ProtocolIp );
1410         }
1411
1412         void tearDown( )
1413         {
1414             sHandle = NULL;
1415         }
1416
1417         void getHandle_001()
1418         {
1419             ::osl::Socket sSocket(sHandle);
1420             ::osl::Socket assignSocket = sSocket.getHandle();
1421
1422             CPPUNIT_ASSERT_MESSAGE( "test for operators_assignment_handle function: test the assignment operator.",
1423                                     osl_Socket_TypeStream == assignSocket.getType( )  );
1424         }
1425
1426         void getHandle_002()
1427         {
1428             ::osl::Socket sSocket( sHandle );
1429             ::osl::Socket assignSocket ( sSocket.getHandle( ) );
1430
1431             CPPUNIT_ASSERT_MESSAGE( "test for operators_assignment function: assignment operator",
1432                                     osl_Socket_TypeStream == assignSocket.getType( ) );
1433         }
1434
1435         CPPUNIT_TEST_SUITE( getHandle );
1436         CPPUNIT_TEST( getHandle_001 );
1437         CPPUNIT_TEST( getHandle_002 );
1438         CPPUNIT_TEST_SUITE_END();
1439
1440     }; // class getHandle
1441
1442
1443 // -----------------------------------------------------------------------------
1444
1445
1446 CPPUNIT_TEST_SUITE_NAMED_REGISTRATION(osl_Socket::ctors, "osl_Socket");
1447 CPPUNIT_TEST_SUITE_NAMED_REGISTRATION(osl_Socket::operators, "osl_Socket");
1448 CPPUNIT_TEST_SUITE_NAMED_REGISTRATION(osl_Socket::close, "osl_Socket");
1449 CPPUNIT_TEST_SUITE_NAMED_REGISTRATION(osl_Socket::getLocalAddr, "osl_Socket");
1450 CPPUNIT_TEST_SUITE_NAMED_REGISTRATION(osl_Socket::getLocalPort, "osl_Socket");
1451 CPPUNIT_TEST_SUITE_NAMED_REGISTRATION(osl_Socket::getLocalHost, "osl_Socket");
1452 CPPUNIT_TEST_SUITE_NAMED_REGISTRATION(osl_Socket::getPeer, "osl_Socket");
1453 CPPUNIT_TEST_SUITE_NAMED_REGISTRATION(osl_Socket::bind, "osl_Socket");
1454 CPPUNIT_TEST_SUITE_NAMED_REGISTRATION(osl_Socket::isRecvReady, "osl_Socket");
1455 CPPUNIT_TEST_SUITE_NAMED_REGISTRATION(osl_Socket::isSendReady, "osl_Socket");
1456 CPPUNIT_TEST_SUITE_NAMED_REGISTRATION(osl_Socket::getType, "osl_Socket");
1457 CPPUNIT_TEST_SUITE_NAMED_REGISTRATION(osl_Socket::getOption, "osl_Socket");
1458 CPPUNIT_TEST_SUITE_NAMED_REGISTRATION(osl_Socket::setOption, "osl_Socket");
1459 CPPUNIT_TEST_SUITE_NAMED_REGISTRATION(osl_Socket::enableNonBlockingMode, "osl_Socket");
1460 CPPUNIT_TEST_SUITE_NAMED_REGISTRATION(osl_Socket::isNonBlockingMode, "osl_Socket");
1461 CPPUNIT_TEST_SUITE_NAMED_REGISTRATION(osl_Socket::clearError, "osl_Socket");
1462 CPPUNIT_TEST_SUITE_NAMED_REGISTRATION(osl_Socket::getError, "osl_Socket");
1463 CPPUNIT_TEST_SUITE_NAMED_REGISTRATION(osl_Socket::getHandle, "osl_Socket");
1464
1465 } // namespace osl_Socket
1466
1467 // -----------------------------------------------------------------------------
1468
1469 // this macro creates an empty function, which will called by the RegisterAllFunctions()
1470 // to let the user the possibility to also register some functions by hand.
1471 NOADDITIONAL;