26 #include "ns3/command-line.h"
27 #include "ns3/config.h"
28 #include "ns3/global-value.h"
30 #include "ns3/node-container.h"
31 #include "ns3/object-vector.h"
32 #include "ns3/object.h"
33 #include "ns3/pointer.h"
34 #include "ns3/simple-channel.h"
35 #include "ns3/string.h"
36 #include "ns3/system-path.h"
108 std::map<std::string, ns3::TypeId::AttributeInformation>
111 std::map<std::string, ns3::TypeId::AttributeInformation> index;
115 index[info.
name] = info;
126 std::map<std::string, ns3::TypeId::TraceSourceInformation>
129 std::map<std::string, ns3::TypeId::TraceSourceInformation> index;
133 index[info.
name] = info;
160 commentStart =
"===============================================================\n";
163 file =
"File: introspected-doxygen.txt";
255 void RecordAggregationInfo(std::string a, std::string b);
272 std::vector<std::string> Get(
TypeId tid)
const;
277 std::vector<std::string> GetNoTypeIds()
const;
283 std::string GetCurrentPath()
const;
289 void DoGather(
TypeId tid);
295 void RecordOutput(
TypeId tid);
301 bool HasAlreadyBeenProcessed(
TypeId tid)
const;
305 std::vector<std::pair<TypeId, std::string>>
m_output;
336 m_noTids.push_back(a);
343 m_noTids.push_back(b);
347 m_aggregates.emplace_back(aTid, bTid);
354 for (
const auto& item : m_output)
356 std::cout << item.first.GetName() <<
" -> " << item.second << std::endl;
364 std::ostringstream oss;
365 for (
const auto& item : m_currentPath)
376 m_output.emplace_back(tid, GetCurrentPath());
383 for (
const auto& it : m_alreadyProcessed)
393 std::vector<std::string>
397 std::vector<std::string> paths;
398 for (
const auto& item : m_output)
400 if (item.first == tid)
402 paths.push_back(item.second);
423 template <
typename T>
427 std::sort(t.begin(), t.end());
428 t.erase(std::unique(t.begin(), t.end()), t.end());
431 std::vector<std::string>
451 if (HasAlreadyBeenProcessed(tid))
460 if (ptrChecker !=
nullptr)
462 TypeId pointee = ptrChecker->GetPointeeTypeId();
466 TypeId objectTypeId =
object->GetTypeId();
467 if (objectTypeId == pointee)
476 m_currentPath.push_back(info.
name);
477 m_alreadyProcessed.push_back(tid);
479 m_alreadyProcessed.pop_back();
480 m_currentPath.pop_back();
484 const auto vectorChecker =
486 if (vectorChecker !=
nullptr)
488 TypeId item = vectorChecker->GetItemTypeId();
489 m_currentPath.push_back(info.
name +
"/[i]");
490 m_alreadyProcessed.push_back(tid);
492 m_alreadyProcessed.pop_back();
493 m_currentPath.pop_back();
502 std::string childName =
"$" + child.
GetName();
503 m_currentPath.push_back(childName);
504 m_alreadyProcessed.push_back(tid);
506 m_alreadyProcessed.pop_back();
507 m_currentPath.pop_back();
510 for (
const auto& item : m_aggregates)
512 if (item.first == tid || item.second == tid)
515 if (item.first == tid)
519 if (item.second == tid)
523 std::string name =
"$" + other.
GetName();
524 m_currentPath.push_back(name);
525 m_alreadyProcessed.push_back(tid);
527 m_alreadyProcessed.pop_back();
528 m_currentPath.pop_back();
543 static bool mapped =
false;
584 simpleChannel = CreateObject<SimpleChannel>();
597 typedef std::map<std::string, int32_t>
NameMap;
612 static bool mapped =
false;
636 std::string name = tid.
GetName();
637 std::transform(name.begin(), name.end(), name.begin(), ::toupper);
645 for (
const auto& item : noTids)
671 os <<
"Introspection did not find any typical Config paths." <<
breakBoth << std::endl;
677 os << tid.
GetName() <<
" is accessible through the following paths"
678 <<
" with Config::Set and Config::Connect:" << std::endl;
680 for (
const auto& path : paths)
705 for (
const auto& [name, info] : index)
710 << info.checker->GetValueTypeName() <<
listLineStop << std::endl;
712 std::string underType;
713 if (info.checker->HasUnderlyingTypeInformation())
717 std::string valType = info.checker->GetValueTypeName();
718 underType = info.checker->GetUnderlyingTypeInformation();
719 bool handled =
false;
720 if ((valType !=
"ns3::EnumValue") && (underType !=
"std::string"))
723 if (valType ==
"ns3::PointerValue")
725 const auto ptrChecker =
727 if (ptrChecker !=
nullptr)
730 <<
"< " <<
reference << ptrChecker->GetPointeeTypeId().GetName() <<
">";
734 else if (valType ==
"ns3::ObjectPtrContainerValue")
736 const auto ptrChecker =
738 if (ptrChecker !=
nullptr)
741 <<
"< " <<
reference << ptrChecker->GetItemTypeId().GetName() <<
">";
747 auto match = [&uType = std::as_const(underType)](
const std::string& s) {
748 return uType.rfind(s, 0) == 0;
751 if (match(
"bool") || match(
"double") || match(
"int8_t") || match(
"uint8_t") ||
752 match(
"int16_t") || match(
"uint16_t") || match(
"int32_t") ||
753 match(
"uint32_t") || match(
"int64_t") || match(
"uint64_t"))
767 std::string
value = info.initialValue->SerializeToString(info.checker);
768 if (underType ==
"std::string" &&
value.empty())
775 bool moreFlags{
false};
814 os <<
"No Attributes are defined for this type." <<
breakBoth << std::endl;
853 for (
const auto& [name, info] : index)
861 os <<
"Callback signature: " << info.callback << std::endl;
883 os <<
"No TraceSources are defined for this type." <<
breakBoth << std::endl;
918 std::size_t arch = (
sizeof(
void*) * CHAR_BIT);
921 << arch <<
"-bit architecture)." << std::endl;
938 for (
const auto& item : nameMap)
947 std::string name = tid.
GetName();
952 std::cout << std::endl;
977 os <<
commentStart <<
page <<
"TypeIdList All ns3::TypeId's\n" << std::endl;
978 os <<
"This is a list of all" <<
reference <<
"ns3::TypeId's.\n"
979 <<
"For more information see the" <<
reference <<
"ns3::TypeId "
980 <<
"section of this API documentation and the" <<
referenceNo <<
"TypeId section "
981 <<
"in the Configuration and " <<
referenceNo <<
"Attributes chapter of the Manual.\n"
989 for (
const auto& item : nameMap)
1019 os <<
commentStart <<
page <<
"AttributeList All Attributes\n" << std::endl;
1020 os <<
"This is a list of all" <<
reference <<
"attributes classes. "
1021 <<
"For more information see the" <<
reference <<
"attributes "
1022 <<
"section of this API documentation and the Attributes sections "
1023 <<
"in the Tutorial and Manual.\n"
1029 for (
const auto& item : nameMap)
1032 if (item.second < 0)
1048 for (
const auto& [name, info] : index)
1068 os <<
commentStart <<
page <<
"GlobalValueList All GlobalValues\n" << std::endl;
1069 os <<
"This is a list of all" <<
reference <<
"ns3::GlobalValue instances.\n"
1070 <<
"See ns3::GlobalValue for how to set these." << std::endl;
1076 (*i)->GetValue(val);
1079 << (*i)->GetHelp() <<
". Default value: " << val.
Get() <<
"." <<
listLineStop
1096 os <<
commentStart <<
page <<
"LogComponentList All LogComponents\n" << std::endl;
1097 os <<
"This is a list of all" <<
reference <<
"ns3::LogComponent instances.\n" << std::endl;
1105 std::size_t widthL = std::string(
"Log Component").size();
1106 std::size_t widthR = std::string(
"file").size();
1107 for (
const auto& it : (*logs))
1109 widthL =
std::max(widthL, it.first.size());
1110 std::string
file = it.second->File();
1113 while (
file.find(
"../") == 0)
1119 const std::string tLeft(
"| ");
1120 const std::string tMid(
" | ");
1121 const std::string tRight(
" |");
1124 os << tLeft << std::setw(widthL) << std::left <<
"Log Component" << tMid << std::setw(widthR)
1125 << std::left <<
"File" << tRight << std::endl;
1126 os << tLeft <<
":" << std::string(widthL - 1,
'-') << tMid <<
":"
1127 << std::string(widthR - 1,
'-') << tRight << std::endl;
1129 for (
const auto& it : (*logs))
1131 std::string
file = it.second->File();
1134 while (
file.find(
"../") == 0)
1139 os << tLeft << std::setw(widthL) << std::left << it.first << tMid << std::setw(widthR)
1140 <<
file << tRight << std::endl;
1142 os << std::right << std::endl;
1158 os <<
commentStart <<
page <<
"TraceSourceList All TraceSources\n" << std::endl;
1159 os <<
"This is a list of all" <<
reference <<
"tracing sources. "
1160 <<
"For more information see the " <<
reference <<
"tracing "
1161 <<
"section of this API documentation and the Tracing sections "
1162 <<
"in the Tutorial and Manual.\n"
1169 for (
const auto& item : nameMap)
1172 if (item.second < 0)
1189 for (
const auto& [name, info] : index)
1221 std::string section =
"attribute_" + name;
1226 <<
subSectionStart <<
"attribute_" << name <<
" " << name <<
" Attribute\n"
1227 <<
"AttributeValue implementation for " << name <<
"\n";
1231 if (name !=
"IeMeshId")
1233 os <<
seeAlso <<
"ns3::" << name <<
"\n";
1237 os <<
seeAlso <<
"ns3::dot11s::" << name <<
"\n";
1256 const std::string& name,
1257 const std::string&
type,
1258 const std::string& header)
1261 std::string sectAttr =
sectionStart +
"attribute_" + name;
1265 std::string valClass = name +
"Value";
1266 std::string qualClass =
" ns3::" + valClass;
1269 os <<
classStart << qualClass <<
" \"" << header <<
"\"" << std::endl;
1270 os <<
"AttributeValue implementation for " << name <<
"." << std::endl;
1271 os <<
seeAlso <<
"AttributeValue" << std::endl;
1276 if ((name ==
"EmptyAttribute") || (name ==
"ObjectPtrContainer"))
1284 os <<
"(const " <<
type <<
" & value)\n"
1285 <<
"Copy constructor.\n"
1286 <<
argument <<
"[in] value The " << name <<
" value to copy.\n";
1292 <<
returns <<
"The " << name <<
" value.\n"
1297 <<
"::GetAccessor (T & value) const\n"
1298 <<
"Access the " << name <<
" value as type " <<
codeWord <<
"T.\n"
1300 <<
argument <<
"[out] value The " << name <<
" value, as type " <<
codeWord <<
"T.\n"
1305 if (
type !=
"Callback")
1309 <<
"Set the value.\n"
1310 <<
argument <<
"[in] value The value to adopt.\n"
1316 <<
"The stored " << name <<
" instance.\n"
1333 std::string sectAttr =
sectionStart +
"attribute_" + name +
"\n";
1334 std::string make =
"ns3::Make" + name +
"Accessor ";
1339 << make <<
"(T1 a1)\n"
1340 <<
copyDoc <<
"ns3::MakeAccessorHelper(T1)\n"
1341 <<
seeAlso <<
"AttributeAccessor\n"
1347 << make <<
"(T1 a1, T2 a2)\n"
1348 <<
copyDoc <<
"ns3::MakeAccessorHelper(T1,T2)\n"
1349 <<
seeAlso <<
"AttributeAccessor\n"
1366 std::string sectAttr =
sectionStart +
"attribute_" + name +
"\n";
1367 std::string make =
"ns3::Make" + name +
"Checker ";
1372 os <<
classStart <<
" ns3::" << name <<
"Checker"
1373 <<
" \"" << header <<
"\"" << std::endl;
1374 os <<
"AttributeChecker implementation for " << name <<
"Value." << std::endl;
1375 os <<
seeAlso <<
"AttributeChecker" << std::endl;
1382 <<
returns <<
"The AttributeChecker.\n"
1383 <<
seeAlso <<
"AttributeChecker\n"
1429 {
"Address",
"Address",
true,
"address.h" },
1430 {
"Box",
"Box",
true,
"box.h" },
1431 {
"DataRate",
"DataRate",
true,
"data-rate.h" },
1432 {
"Length",
"Length",
true,
"length.h" },
1433 {
"IeMeshId",
"IeMeshId",
true,
"ie-dot11s-id.h" },
1434 {
"Ipv4Address",
"Ipv4Address",
true,
"ipv4-address.h" },
1435 {
"Ipv4Mask",
"Ipv4Mask",
true,
"ipv4-address.h" },
1436 {
"Ipv6Address",
"Ipv6Address",
true,
"ipv6-address.h" },
1437 {
"Ipv6Prefix",
"Ipv6Prefix",
true,
"ipv6-address.h" },
1438 {
"Mac16Address",
"Mac16Address",
true,
"mac16-address.h" },
1439 {
"Mac48Address",
"Mac48Address",
true,
"mac48-address.h" },
1440 {
"Mac64Address",
"Mac64Address",
true,
"mac64-address.h" },
1441 {
"ObjectFactory",
"ObjectFactory",
true,
"object-factory.h" },
1442 {
"OrganizationIdentifier",
1443 "OrganizationIdentifier",
1444 true,
"vendor-specific-action.h" },
1445 {
"Priomap",
"Priomap",
true,
"prio-queue-disc.h" },
1446 {
"QueueSize",
"QueueSize",
true,
"queue-size.h" },
1447 {
"Rectangle",
"Rectangle",
true,
"rectangle.h" },
1448 {
"Ssid",
"Ssid",
true,
"ssid.h" },
1449 {
"TypeId",
"TypeId",
true,
"type-id.h" },
1450 {
"UanModesList",
"UanModesList",
true,
"uan-tx-mode.h" },
1451 {
"ValueClassTest",
"ValueClassTest",
false,
"attribute-test-suite.cc" },
1452 {
"Vector",
"Vector",
true,
"vector.h" },
1453 {
"Vector2D",
"Vector2D",
true,
"vector.h" },
1454 {
"Vector3D",
"Vector3D",
true,
"vector.h" },
1455 {
"Waypoint",
"Waypoint",
true,
"waypoint.h" },
1456 {
"WifiMode",
"WifiMode",
true,
"wifi-mode.h" },
1459 {
"Boolean",
"bool",
false,
"boolean.h" },
1460 {
"Callback",
"Callback",
true,
"callback.h" },
1461 {
"Double",
"double",
false,
"double.h" },
1462 {
"Enum",
"int",
false,
"enum.h" },
1463 {
"Integer",
"int64_t",
false,
"integer.h" },
1464 {
"Pointer",
"Pointer",
false,
"pointer.h" },
1465 {
"String",
"std::string",
false,
"string.h" },
1466 {
"Time",
"Time",
true,
"nstime.h" },
1467 {
"Uinteger",
"uint64_t",
false,
"uinteger.h" },
1468 {
"",
"",
false,
"last placeholder" }
1473 while (!attributes[i].m_name.empty())
1485 "ObjectPtrContainer",
1486 "ObjectPtrContainer",
1487 "object-ptr-container.h");
1518 main(
int argc,
char* argv[])
1523 cmd.Usage(
"Generate documentation for all ns-3 registered types, "
1524 "trace sources, attributes and global variables.");
1525 cmd.AddValue(
"output-text",
"format output as plain text",
outputText);
1526 cmd.Parse(argc, argv);
1534 std::cout << std::endl;
1537 <<
"Doxygen docs generated from the TypeId database.\n"
1538 <<
note <<
"This file is automatically generated by " <<
codeWord
1539 <<
"print-introspected-doxygen.cc. Do not edit this file! "
1540 <<
"Edit that file instead.\n"
Parse command-line arguments.
static Iterator Begin()
The Begin iterator.
static Iterator End()
The End iterator.
static ComponentList * GetComponentList()
Get the list of LogComponents.
std::unordered_map< std::string, LogComponent * > ComponentList
LogComponent name map.
keep track of a set of node pointers.
void Create(uint32_t n)
Create n nodes and append pointers to them to the end of this NodeContainer.
Hold variables of type string.
a unique identifier for an interface.
bool IsChildOf(TypeId other) const
Check if this TypeId is a child of another.
std::size_t GetTraceSourceN() const
Get the number of Trace sources.
bool MustHideFromDocumentation() const
Check if this TypeId should not be listed in documentation.
@ ATTR_GET
The attribute can be read.
@ ATTR_SET
The attribute can be written.
@ ATTR_CONSTRUCT
The attribute can be written at construction-time.
TypeId::TraceSourceInformation GetTraceSource(std::size_t i) const
Get the trace source by index.
static uint16_t GetRegisteredN()
Get the number of registered TypeIds.
std::size_t GetAttributeN() const
Get the number of attributes.
TypeId GetParent() const
Get the parent of this TypeId.
static TypeId GetRegistered(uint16_t i)
Get a TypeId by index.
std::size_t GetSize() const
Get the size of this object.
TypeId::AttributeInformation GetAttribute(std::size_t i) const
Get Attribute information by index.
static bool LookupByNameFailSafe(std::string name, TypeId *tid)
Get a TypeId by name.
std::string GetName() const
Get the name.
#define NS_ASSERT_MSG(condition, message)
At runtime, in debugging builds, if this condition is not true, the program prints the message to out...
Ptr< Object > GetRootNamespaceObject(uint32_t i)
std::size_t GetRootNamespaceObjectN()
#define NS_LOG_COMPONENT_DEFINE(name)
Define a Log component with a specific name.
#define NS_LOG_FUNCTION_NOARGS()
Output the name of the function.
#define NS_LOG_FUNCTION(parameters)
If log level LOG_FUNCTION is enabled, this macro will output all input parameters separated by ",...
void Print(ComponentCarrier cc)
std::string functionStart
start of a method/function
std::string hrefStop
end of a link
std::string referenceNo
block automatic references
std::string anchor
Markup tokens.
std::string argument
function argument
std::string functionStop
end of a method/function
std::string headingStart
start of section heading (h3)
std::string headingStop
end of section heading (h3)
std::string copyDoc
copy (or refer) to docs elsewhere
std::string breakBoth
linebreak
std::string listLineStart
start unordered list item
std::string templateArgument
template argument
std::string returns
the return value
std::string breakHtmlOnly
linebreak for html output only
std::string templArgExplicit
template argument required
std::string hrefStart
start of a link
std::string subSectionStart
start a new subsection
std::string hrefMid
middle part of a link
std::string commentStart
start of code comment
bool outputText
Are we generating text or Doxygen?
std::string page
start a separate page
std::string seeAlso
Reference to other docs.
std::string commentStop
end of code comment
std::string indentHtmlOnly
small indent
std::string codeWord
format next word as source code
std::string note
start a note section
std::map< std::string, ns3::TypeId::AttributeInformation > SortedAttributeInfo(const TypeId tid)
Alphabetize the AttributeInformation for a TypeId by the Attribute name.
std::string listLineStop
end unordered list item
std::string listStop
end unordered list
std::string classStop
end of a class
std::string breakTextOnly
linebreak for text output only
std::string brief
brief tag
std::string reference
reference tag
std::string flagSpanStop
end of Attribute flag value
std::string variable
variable or class member
std::string boldStart
start of bold span
std::string boldStop
end of bold span
std::string classStart
start of a class
std::string sectionStart
start of a section or group
std::string listStart
start unordered list
std::string flagSpanStart
start of Attribute flag value
std::string templArgDeduced
template argument deduced from function
std::map< std::string, ns3::TypeId::TraceSourceInformation > SortedTraceSourceInfo(const TypeId tid)
Alphabetize the TraceSourceInformation for a TypeId by the TraceSource name.
Every class exported by the ns3 library is enclosed in the ns3 namespace.
U * PeekPointer(const Ptr< U > &p)
StaticInformation GetTypicalAggregations()
Register aggregation relationships that are not automatically detected by this introspection program.
void PrintTraceSourcesTid(std::ostream &os, const TypeId tid)
Print direct Trace sources for this TypeId.
std::map< std::string, int32_t > NameMap
Map from TypeId name to tid.
void PrintMakeAccessors(std::ostream &os, const std::string &name)
Print the AttributeValue MakeAccessor documentation for a class.
void PrintAllTraceSources(std::ostream &os)
Print the list of all Trace sources.
void PrintAllLogComponents(std::ostream &os)
Print the list of all LogComponents.
void PrintAttributeHelper(std::ostream &os, const AttributeDescriptor &attr)
Print documentation corresponding to use of the ATTRIBUTE_HELPER_HEADER macro or ATTRIBUTE_VALUE_DEFI...
void PrintTypeIdBlocks(std::ostream &os)
Print the doxy block for each TypeId.
void PrintAllAttributes(std::ostream &os)
Print the list of all Attributes.
void PrintAttributeValueWithName(std::ostream &os, const std::string &name, const std::string &type, const std::string &header)
Print the AttributeValue documentation for a class.
void PrintSize(std::ostream &os, const TypeId tid)
Print the size of the type represented by this tid.
void Uniquefy(T t)
Helper to keep only the unique items in a container.
void PrintAttributeImplementations(std::ostream &os)
Print documentation for Attribute implementations.
NameMap GetNameMap()
Create a map from the class names to their index in the vector of TypeId's so that the names will end...
void PrintTraceSources(std::ostream &os, const TypeId tid)
Print the Trace sources block for tid, including Trace sources declared in base classes.
void SetMarkup()
Initialize the markup strings, for either doxygen or text.
NameMap::const_iterator NameMapIterator
NameMap iterator.
void PrintConfigPaths(std::ostream &os, const TypeId tid)
Print config paths.
void PrintAllTypeIds(std::ostream &os)
Print the list of all TypeIds.
void PrintAttributes(std::ostream &os, const TypeId tid)
Print the Attributes block for tid, including Attributes declared in base classes.
void PrintAllGlobals(std::ostream &os)
Print the list of all global variables.
void PrintMakeChecker(std::ostream &os, const std::string &name, const std::string &header)
Print the AttributeValue MakeChecker documentation for a class.
void PrintAttributeValueSection(std::ostream &os, const std::string &name, const bool seeBase=true)
Print the section definition for an AttributeValue.
void PrintAttributesTid(std::ostream &os, const TypeId tid)
Print direct Attributes for this TypeId.
Descriptor for an AttributeValue.
const std::string m_header
The header file name.
const std::string m_type
The name of the underlying type.
const std::string m_name
The base name of the resulting AttributeValue type.
const bool m_seeBase
Print a "see also" pointing to the base class.