24 //

    25 // \brief The base class for all ns3 applicationes

    26 //

    27 // Class Application is the base class for all ns3 applications.

    28 // Applications are associated with individual nodes, and are created

    29 // using the AddApplication method in the ApplicationManager capability.

    30 // 

    31 // Conceptually, an application has zero or more Socket

    32 // objects associated with it, that are created using the Socket

    33 // creation API of the Kernel capability.  The Socket object

    34 // API is modeled after the

    35 // well-known BSD sockets interface, although it is somewhat 

    36 // simplified for use with ns3.  Further, any socket call that

    37 // would normally "block" in normal sockets will return immediately

    38 // in ns3.  A set of "upcalls" are defined that will be called when

    39 // the previous blocking call would normally exit.  THis is documented

    40 // in more detail Socket class in socket.h.

    41 // 

    42 // There is a second application class in ns3, called "ThreadedApplication"

    43 // that implements a true sockets interface, which should be used

    44 // when porting existing sockets code to ns3.  The true

    45 // sockets approach is significantly

    46 // less memory--efficient using private stacks for each defined application,

    47 // so that approach should be used with care.  The design and implementation

    48 // of the ThreadedApplication are still being discussed.

    49