ipw.1 3.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166
  1. .\" Sorry for my English
  2. .\" --Artyom A Anikeev <anikeev@ut.mephi.ru> 0xB5385841
  3. .\"
  4. .TH IPW 1 "APRIL 2014" Linux "User Manuals"
  5. .SH NAME
  6. ipw \- simple network interface configuration
  7. .SH SYNOPSIS
  8. .B ipw [ ... ]
  9. .SH DESCRIPTION
  10. .B ipw
  11. provides bonding, bridging and .1q tagging using sysfs and the
  12. .BR ip
  13. (8) utility.
  14. Simple configurational files are supported.
  15. .SH COMMAND SYNTAX
  16. .B fix
  17. .RS 8
  18. fixes current network state to configurational one.
  19. .B ipw
  20. tries to keep interfaces up during reconfiguretion, if possible.
  21. .PP
  22. .RE
  23. .B down
  24. .RS 8
  25. bringes all interfaces down, deletes bondings and bridges.
  26. .PP
  27. .RE
  28. .\" .B add1qif
  29. .\" $BONDING $SLAVE
  30. .\" .RS 8
  31. .\" changes
  32. .\" .I /etc/ipw/conf
  33. .\" by enslaving the $SLAVE interface into the $BONDING.
  34. .\" .PP
  35. .\" .RE
  36. .\" .B del1qif
  37. .\" $BONDING $SLAVE
  38. .\" .RS 8
  39. .\" changes
  40. .\" .I /etc/ipw.conf
  41. .\" by setting nomaster for the $SLAVE.
  42. .\" .PP
  43. .\" .RE
  44. .\" .B addbrif
  45. .\" $BONDING $VLAN.$SUBVLAN $BRIDGE
  46. .\" .RS 8
  47. .\" changes
  48. .\" .I /etc/ipw.conf
  49. .\" by adding bridged vlan into the bonding. If $BRIDGE variable is not
  50. .\" set, then "vlan$VLAN.$SUBVLAN"/"vlan$VLAN" is used as bridge name.
  51. .\" \.$SUBVLAN should be used in case of QinQ interfaces for a daughter
  52. .\" (inner tag) vlan (see 802.1ad).
  53. .\" .PP
  54. .\" .RE
  55. .SH EXAMPLES
  56. TODO
  57. .RE
  58. .SH FILES
  59. .I /etc/ipw.conf
  60. .RS 8
  61. definition of network interfaces.
  62. Lines starting with `#' are ignored. Note that end-of-line comments
  63. are NOT supported, comments must be on a line of their own.
  64. A line may be extended across multiple lines by making the last
  65. character a backslash.
  66. The file consists of D1Q_IFACES,
  67. .BR $NAME _SLAVES,
  68. .BR $NAME _MODE,
  69. .BR $NAME _VLAN_N_BRIDGES,
  70. .BR $NAME _IP
  71. variables. Here is an example.
  72. #This is a comment
  73. D1Q_IFACES=(bond0 bond1)
  74. bond0_SLAVES=(eth0 eth1)
  75. bond1_SLAVES=(eth2)
  76. bond0_MODE=balance-rr
  77. bond0_VLAN_N_BRIDGES=(
  78. 10.2:thor.ext
  79. 10.3:cps
  80. 10.4
  81. 50
  82. 12:
  83. :cps.int
  84. )
  85. bond1_VLAN_N_BRIDGES=(
  86. 441
  87. :cps.int
  88. )
  89. thor_ext_IP=(
  90. "addr add 10.10.2.2/24"
  91. "route add default via 10.10.2.1"
  92. )
  93. vlan10_5_IP=(
  94. "addr add 10.10.5.0/24"
  95. )
  96. .B VARIABLES
  97. .HP
  98. D1Q_IFACES
  99. are required to identify bonging master names.
  100. .HP
  101. .BR $NAME _SLAVES
  102. specifies slave interfaces for each master.
  103. .HP
  104. .BR $NAME _MODE
  105. specifies bonding mode for each master. Default is 802.3ad.
  106. .HP
  107. .BR $NAME _VLAN_N_BRIDGES
  108. specifies vlans and bridges for each master. Syntax is as foolow:
  109. vlan.subvlan:bridge-name. Subvlan means daughter (inner tag) vlan
  110. for QinQ vlan (outer tag) interfaces (see 802.1ad).
  111. Symbol `.' in bridge name is not a special symbol.
  112. If :bridge is not set then "vlan$VLAN.$SUBVLAN"/"vlan$VLAN" is
  113. used as bridge name
  114. If bridge is set to "" then vlan inetrface is created without
  115. creating a bridge to be enslaved by
  116. If vlan.subvlan is set to "" then bridge is created without creating
  117. and enslaving the vlan interface
  118. .HP
  119. .BR $NAME _IP
  120. specifies commands for
  121. .B ip
  122. (8) uility for each interface, if required.
  123. .PP
  124. .RE
  125. .SH AUTHOR
  126. Artyom A Anikeev <anikeev@ut.mephi.ru> 0xB5385841
  127. .RE
  128. Dmitry Yu Okunev <dyokunev@ut.mephi.ru> 0x8E30679C
  129. .SH SUPPORT
  130. TODO
  131. .SH "SEE ALSO"
  132. .BR ip (8).