blob: 20ac72cdcbf5e4d500c45267a5560643375433fa (plain)

ofs	hex dump	ascii
0000	de 12 04 95 00 00 00 00 db 01 00 00 1c 00 00 00 f4 0e 00 00 81 02 00 00 cc 1d 00 00 00 00 00 00	................................
0020	d0 27 00 00 77 00 00 00 d1 27 00 00 03 00 00 00 49 28 00 00 35 00 00 00 4d 28 00 00 1c 00 00 00	.'..w....'......I(..5...M(......
0040	83 28 00 00 34 00 00 00 a0 28 00 00 44 00 00 00 d5 28 00 00 44 00 00 00 1a 29 00 00 25 00 00 00	.(..4....(..D....(..D....)..%...
0060	5f 29 00 00 42 00 00 00 85 29 00 00 21 00 00 00 c8 29 00 00 15 00 00 00 ea 29 00 00 25 00 00 00	_)..B....)..!....).......)..%...
0080	00 2a 00 00 5b 00 00 00 26 2a 00 00 1e 00 00 00 82 2a 00 00 50 00 00 00 a1 2a 00 00 87 00 00 00	.*..[...&*.......*..P....*......
00a0	f2 2a 00 00 9c 00 00 00 7a 2b 00 00 51 01 00 00 17 2c 00 00 f5 00 00 00 69 2d 00 00 92 01 00 00	.*......z+..Q....,......i-......
00c0	5f 2e 00 00 3b 01 00 00 f2 2f 00 00 33 00 00 00 2e 31 00 00 09 00 00 00 62 31 00 00 55 00 00 00	_...;..../..3....1......b1..U...
00e0	6c 31 00 00 5f 00 00 00 c2 31 00 00 1c 00 00 00 22 32 00 00 07 00 00 00 3f 32 00 00 64 00 00 00	l1.._....1......"2......?2..d...
0100	47 32 00 00 e7 00 00 00 ac 32 00 00 8b 00 00 00 94 33 00 00 75 00 00 00 20 34 00 00 47 00 00 00	G2.......2.......3..u....4..G...
0120	96 34 00 00 39 01 00 00 de 34 00 00 cd 00 00 00 18 36 00 00 22 00 00 00 e6 36 00 00 b8 00 00 00	.4..9....4.......6.."....6......
0140	09 37 00 00 0d 01 00 00 c2 37 00 00 a0 00 00 00 d0 38 00 00 92 00 00 00 71 39 00 00 f4 00 00 00	.7.......7.......8......q9......
0160	04 3a 00 00 75 00 00 00 f9 3a 00 00 3d 00 00 00 6f 3b 00 00 7b 00 00 00 ad 3b 00 00 ab 00 00 00	.:..u....:..=...o;..{....;......
0180	29 3c 00 00 85 00 00 00 d5 3c 00 00 20 00 00 00 5b 3d 00 00 1f 00 00 00 7c 3d 00 00 1e 00 00 00	)<.......<......[=......|=......
01a0	9c 3d 00 00 21 00 00 00 bb 3d 00 00 1d 00 00 00 dd 3d 00 00 1d 00 00 00 fb 3d 00 00 11 00 00 00	.=..!....=.......=.......=......
01c0	19 3e 00 00 11 00 00 00 2b 3e 00 00 5f 00 00 00 3d 3e 00 00 7f 01 00 00 9d 3e 00 00 7e 01 00 00	.>......+>.._...=>.......>..~...
01e0	1d 40 00 00 0b 00 00 00 9c 41 00 00 10 00 00 00 a8 41 00 00 2d 00 00 00 b9 41 00 00 05 00 00 00	.@.......A.......A..-....A......
0200	e7 41 00 00 0f 00 00 00 ed 41 00 00 09 00 00 00 fd 41 00 00 0a 00 00 00 07 42 00 00 11 00 00 00	.A.......A.......A.......B......
0220	12 42 00 00 1c 00 00 00 24 42 00 00 13 00 00 00 41 42 00 00 74 00 00 00 55 42 00 00 2d 01 00 00	.B......$B......AB..t...UB..-...
0240	ca 42 00 00 66 01 00 00 f8 43 00 00 a7 00 00 00 5f 45 00 00 d9 00 00 00 07 46 00 00 8f 01 00 00	.B..f....C......_E.......F......
0260	e1 46 00 00 10 00 00 00 71 48 00 00 1e 00 00 00 82 48 00 00 72 00 00 00 a1 48 00 00 3f 00 00 00	.F......qH.......H..r....H..?...
0280	14 49 00 00 3a 00 00 00 54 49 00 00 11 00 00 00 8f 49 00 00 d7 00 00 00 a1 49 00 00 95 00 00 00	.I..:...TI.......I.......I......
02a0	79 4a 00 00 11 00 00 00 0f 4b 00 00 18 00 00 00 21 4b 00 00 22 00 00 00 3a 4b 00 00 2c 00 00 00	yJ.......K......!K.."...:K..,...
02c0	5d 4b 00 00 53 00 00 00 8a 4b 00 00 16 00 00 00 de 4b 00 00 09 00 00 00 f5 4b 00 00 28 00 00 00	]K..S....K.......K.......K..(...
02e0	ff 4b 00 00 74 00 00 00 28 4c 00 00 fa 00 00 00 9d 4c 00 00 26 00 00 00 98 4d 00 00 68 00 00 00	.K..t...(L.......L..&....M..h...
0300	bf 4d 00 00 26 00 00 00 28 4e 00 00 49 00 00 00 4f 4e 00 00 25 00 00 00 99 4e 00 00 21 00 00 00	.M..&...(N..I...ON..%....N..!...
0320	bf 4e 00 00 1b 01 00 00 e1 4e 00 00 09 00 00 00 fd 4f 00 00 1e 00 00 00 07 50 00 00 0b 00 00 00	.N.......N.......O.......P......
0340	26 50 00 00 1a 00 00 00 32 50 00 00 0b 00 00 00 4d 50 00 00 50 00 00 00 59 50 00 00 06 00 00 00	&P......2P......MP..P...YP......
0360	aa 50 00 00 09 00 00 00 b1 50 00 00 c0 00 00 00 bb 50 00 00 65 00 00 00 7c 51 00 00 50 00 00 00	.P.......P.......P..e...|Q..P...
0380	e2 51 00 00 28 01 00 00 33 52 00 00 14 01 00 00 5c 53 00 00 8b 00 00 00 71 54 00 00 10 00 00 00	.Q..(...3R......\S......qT......
03a0	fd 54 00 00 22 00 00 00 0e 55 00 00 fc 00 00 00 31 55 00 00 08 00 00 00 2e 56 00 00 09 00 00 00	.T.."....U......1U.......V......
03c0	37 56 00 00 9b 01 00 00 41 56 00 00 8f 00 00 00 dd 57 00 00 76 00 00 00 6d 58 00 00 03 00 00 00	7V......AV.......W..v...mX......
03e0	e4 58 00 00 0f 00 00 00 e8 58 00 00 10 00 00 00 f8 58 00 00 51 00 00 00 09 59 00 00 08 00 00 00	.X.......X.......X..Q....Y......
0400	5b 59 00 00 4e 00 00 00 64 59 00 00 fb 00 00 00 b3 59 00 00 3b 00 00 00 af 5a 00 00 ae 00 00 00	[Y..N...dY.......Y..;....Z......
0420	eb 5a 00 00 b2 00 00 00 9a 5b 00 00 86 00 00 00 4d 5c 00 00 57 00 00 00 d4 5c 00 00 b4 00 00 00	.Z.......[......M\..W....\......
0440	2c 5d 00 00 20 00 00 00 e1 5d 00 00 45 00 00 00 02 5e 00 00 74 01 00 00 48 5e 00 00 0a 00 00 00	,].......]..E....^..t...H^......
0460	bd 5f 00 00 10 00 00 00 c8 5f 00 00 2e 00 00 00 d9 5f 00 00 0a 00 00 00 08 60 00 00 1f 00 00 00	._......._......._.......`......
0480	13 60 00 00 1e 00 00 00 33 60 00 00 1e 00 00 00 52 60 00 00 12 00 00 00 71 60 00 00 44 00 00 00	.`......3`......R`......q`..D...
04a0	84 60 00 00 0a 00 00 00 c9 60 00 00 0b 00 00 00 d4 60 00 00 9b 00 00 00 e0 60 00 00 22 00 00 00	.`.......`.......`.......`.."...
04c0	7c 61 00 00 23 00 00 00 9f 61 00 00 1e 00 00 00 c3 61 00 00 25 00 00 00 e2 61 00 00 25 00 00 00	|a..#....a.......a..%....a..%...
04e0	08 62 00 00 13 00 00 00 2e 62 00 00 10 00 00 00 42 62 00 00 0f 00 00 00 53 62 00 00 b7 00 00 00	.b.......b......Bb......Sb......
0500	63 62 00 00 fb 00 00 00 1b 63 00 00 f2 00 00 00 17 64 00 00 9f 00 00 00 0a 65 00 00 57 00 00 00	cb.......c.......d.......e..W...
0520	aa 65 00 00 8a 00 00 00 02 66 00 00 8e 00 00 00 8d 66 00 00 9b 01 00 00 1c 67 00 00 9a 00 00 00	.e.......f.......f.......g......
0540	b8 68 00 00 11 01 00 00 53 69 00 00 77 00 00 00 65 6a 00 00 f1 00 00 00 dd 6a 00 00 e4 00 00 00	.h......Si..w...ej.......j......
0560	cf 6b 00 00 08 01 00 00 b4 6c 00 00 11 01 00 00 bd 6d 00 00 0a 01 00 00 cf 6e 00 00 76 00 00 00	.k.......l.......m.......n..v...
0580	da 6f 00 00 0e 00 00 00 51 70 00 00 23 01 00 00 60 70 00 00 07 00 00 00 84 71 00 00 27 00 00 00	.o......Qp..#...`p.......q..'...
05a0	8c 71 00 00 25 00 00 00 b4 71 00 00 7d 00 00 00 da 71 00 00 09 00 00 00 58 72 00 00 11 00 00 00	.q..%....q..}....q......Xr......
05c0	62 72 00 00 09 00 00 00 74 72 00 00 09 00 00 00 7e 72 00 00 15 00 00 00 88 72 00 00 62 00 00 00	br......tr......~r.......r..b...
05e0	9e 72 00 00 4b 00 00 00 01 73 00 00 17 00 00 00 4d 73 00 00 8a 00 00 00 65 73 00 00 8a 00 00 00	.r..K....s......Ms......es......
0600	f0 73 00 00 b4 00 00 00 7b 74 00 00 0a 00 00 00 30 75 00 00 2a 00 00 00 3b 75 00 00 61 00 00 00	.s......{t......0u..*...;u..a...
0620	66 75 00 00 77 00 00 00 c8 75 00 00 06 00 00 00 40 76 00 00 29 00 00 00 47 76 00 00 39 00 00 00	fu..w....u......@v..)...Gv..9...
0640	71 76 00 00 fb 00 00 00 ab 76 00 00 9b 00 00 00 a7 77 00 00 5a 01 00 00 43 78 00 00 07 00 00 00	qv.......v.......w..Z...Cx......
0660	9e 79 00 00 0c 00 00 00 a6 79 00 00 0b 00 00 00 b3 79 00 00 08 00 00 00 bf 79 00 00 72 00 00 00	.y.......y.......y.......y..r...
0680	c8 79 00 00 14 00 00 00 3b 7a 00 00 17 00 00 00 50 7a 00 00 74 00 00 00 68 7a 00 00 0d 00 00 00	.y......;z......Pz..t...hz......
06a0	dd 7a 00 00 11 00 00 00 eb 7a 00 00 1e 00 00 00 fd 7a 00 00 0c 00 00 00 1c 7b 00 00 0a 00 00 00	.z.......z.......z.......{......
06c0	29 7b 00 00 21 00 00 00 34 7b 00 00 17 00 00 00 56 7b 00 00 20 00 00 00 6e 7b 00 00 27 00 00 00	){..!...4{......V{......n{..'...
06e0	8f 7b 00 00 04 00 00 00 b7 7b 00 00 05 00 00 00 bc 7b 00 00 66 00 00 00 c2 7b 00 00 d9 00 00 00	.{.......{.......{..f....{......
0700	29 7c 00 00 6e 00 00 00 03 7d 00 00 2d 01 00 00 72 7d 00 00 8e 00 00 00 a0 7e 00 00 12 00 00 00	)|..n....}..-...r}.......~......
0720	2f 7f 00 00 9a 00 00 00 42 7f 00 00 70 00 00 00 dd 7f 00 00 69 00 00 00 4e 80 00 00 7a 00 00 00	/.......B...p.......i...N...z...
0740	b8 80 00 00 37 01 00 00 33 81 00 00 38 01 00 00 6b 82 00 00 1d 00 00 00 a4 83 00 00 2b 01 00 00	....7...3...8...k...........+...
0760	c2 83 00 00 2f 00 00 00 ee 84 00 00 fd 00 00 00 1e 85 00 00 fe 00 00 00 1c 86 00 00 43 02 00 00	..../.......................C...
0780	1b 87 00 00 d5 00 00 00 5f 89 00 00 fe 00 00 00 35 8a 00 00 08 00 00 00 34 8b 00 00 cb 00 00 00	........_.......5.......4.......
07a0	3d 8b 00 00 1f 00 00 00 09 8c 00 00 66 00 00 00 29 8c 00 00 9d 00 00 00 90 8c 00 00 a0 00 00 00	=...........f...)...............
07c0	2e 8d 00 00 a1 00 00 00 cf 8d 00 00 10 00 00 00 71 8e 00 00 0c 00 00 00 82 8e 00 00 12 00 00 00	................q...............
07e0	8f 8e 00 00 14 00 00 00 a2 8e 00 00 2b 00 00 00 b7 8e 00 00 0d 00 00 00 e3 8e 00 00 0a 00 00 00	............+...................
0800	f1 8e 00 00 91 00 00 00 fc 8e 00 00 26 00 00 00 8e 8f 00 00 06 00 00 00 b5 8f 00 00 d2 00 00 00	............&...................
0820	bc 8f 00 00 95 00 00 00 8f 90 00 00 4e 00 00 00 25 91 00 00 04 00 00 00 74 91 00 00 6b 00 00 00	............N...%.......t...k...
0840	79 91 00 00 c9 00 00 00 e5 91 00 00 0c 00 00 00 af 92 00 00 37 00 00 00 bc 92 00 00 38 00 00 00	y...................7.......8...
0860	f4 92 00 00 41 00 00 00 2d 93 00 00 9d 00 00 00 6f 93 00 00 0a 00 00 00 0d 94 00 00 93 00 00 00	....A...-.......o...............
0880	18 94 00 00 9a 00 00 00 ac 94 00 00 99 00 00 00 47 95 00 00 b4 01 00 00 e1 95 00 00 04 01 00 00	................G...............
08a0	96 97 00 00 51 01 00 00 9b 98 00 00 85 00 00 00 ed 99 00 00 10 00 00 00 73 9a 00 00 24 01 00 00	....Q...................s...$...
08c0	84 9a 00 00 0e 00 00 00 a9 9b 00 00 41 00 00 00 b8 9b 00 00 07 00 00 00 fa 9b 00 00 fd 00 00 00	............A...................
08e0	02 9c 00 00 0e 00 00 00 00 9d 00 00 11 00 00 00 0f 9d 00 00 db 00 00 00 21 9d 00 00 32 01 00 00	........................!...2...
0900	fd 9d 00 00 07 00 00 00 30 9f 00 00 0f 00 00 00 38 9f 00 00 f7 00 00 00 48 9f 00 00 7d 00 00 00	........0.......8.......H...}...
0920	40 a0 00 00 9f 00 00 00 be a0 00 00 40 01 00 00 5e a1 00 00 a3 00 00 00 9f a2 00 00 47 00 00 00	@...........@...^...........G...
0940	43 a3 00 00 ab 01 00 00 8b a3 00 00 d2 02 00 00 37 a5 00 00 49 00 00 00 0a a8 00 00 11 02 00 00	C...............7...I...........
0960	54 a8 00 00 97 00 00 00 66 aa 00 00 3b 02 00 00 fe aa 00 00 96 01 00 00 3a ad 00 00 d1 00 00 00	T.......f...;...........:.......
0980	d1 ae 00 00 18 01 00 00 a3 af 00 00 02 01 00 00 bc b0 00 00 35 00 00 00 bf b1 00 00 54 01 00 00	....................5.......T...
09a0	f5 b1 00 00 38 00 00 00 4a b3 00 00 a7 00 00 00 83 b3 00 00 f8 00 00 00 2b b4 00 00 8d 00 00 00	....8...J...............+.......
09c0	24 b5 00 00 77 00 00 00 b2 b5 00 00 4c 00 00 00 2a b6 00 00 8e 00 00 00 77 b6 00 00 00 02 00 00	$...w.......L...*.......w.......
09e0	06 b7 00 00 26 00 00 00 07 b9 00 00 a0 00 00 00 2e b9 00 00 22 00 00 00 cf b9 00 00 3b 00 00 00	....&...............".......;...
0a00	f2 b9 00 00 26 01 00 00 2e ba 00 00 78 01 00 00 55 bb 00 00 24 00 00 00 ce bc 00 00 15 01 00 00	....&.......x...U...$...........
0a20	f3 bc 00 00 15 01 00 00 09 be 00 00 5d 00 00 00 1f bf 00 00 7f 00 00 00 7d bf 00 00 62 00 00 00	............]...........}...b...
0a40	fd bf 00 00 38 00 00 00 60 c0 00 00 3d 00 00 00 99 c0 00 00 a0 00 00 00 d7 c0 00 00 b4 00 00 00	....8...`...=...................
0a60	78 c1 00 00 10 01 00 00 2d c2 00 00 2c 00 00 00 3e c3 00 00 19 01 00 00 6b c3 00 00 b6 00 00 00	x.......-...,...>.......k.......
0a80	85 c4 00 00 84 00 00 00 3c c5 00 00 97 00 00 00 c1 c5 00 00 46 00 00 00 59 c6 00 00 f6 00 00 00	........<...........F...Y.......
0aa0	a0 c6 00 00 07 01 00 00 97 c7 00 00 47 00 00 00 9f c8 00 00 bf 00 00 00 e7 c8 00 00 68 00 00 00	............G...............h...
0ac0	a7 c9 00 00 6e 00 00 00 10 ca 00 00 dd 00 00 00 7f ca 00 00 a6 00 00 00 5d cb 00 00 a3 00 00 00	....n...................].......
0ae0	04 cc 00 00 60 00 00 00 a8 cc 00 00 23 00 00 00 09 cd 00 00 0f 00 00 00 2d cd 00 00 a1 00 00 00	....`.......#...........-.......
0b00	3d cd 00 00 71 00 00 00 df cd 00 00 5f 01 00 00 51 ce 00 00 b8 00 00 00 b1 cf 00 00 d3 00 00 00	=...q......._...Q...............
0b20	6a d0 00 00 d2 00 00 00 3e d1 00 00 84 00 00 00 11 d2 00 00 83 00 00 00 96 d2 00 00 3d 00 00 00	j.......>...................=...
0b40	1a d3 00 00 74 00 00 00 58 d3 00 00 6c 00 00 00 cd d3 00 00 60 01 00 00 3a d4 00 00 37 00 00 00	....t...X...l.......`...:...7...
0b60	9b d5 00 00 35 00 00 00 d3 d5 00 00 a5 00 00 00 09 d6 00 00 0f 00 00 00 af d6 00 00 0a 02 00 00	....5...........................
0b80	bf d6 00 00 11 00 00 00 ca d8 00 00 21 00 00 00 dc d8 00 00 0e 00 00 00 fe d8 00 00 d5 00 00 00	............!...................
0ba0	0d d9 00 00 0c 00 00 00 e3 d9 00 00 09 00 00 00 f0 d9 00 00 14 00 00 00 fa d9 00 00 17 00 00 00	................................
0bc0	0f da 00 00 1f 00 00 00 27 da 00 00 06 00 00 00 47 da 00 00 3f 00 00 00 4e da 00 00 47 00 00 00	........'.......G...?...N...G...
0be0	8e da 00 00 18 00 00 00 d6 da 00 00 67 01 00 00 ef da 00 00 68 01 00 00 57 dc 00 00 af 00 00 00	............g.......h...W.......
0c00	c0 dd 00 00 09 01 00 00 70 de 00 00 dd 00 00 00 7a df 00 00 6d 00 00 00 58 e0 00 00 19 00 00 00	........p.......z...m...X.......
0c20	c6 e0 00 00 c8 00 00 00 e0 e0 00 00 8b 00 00 00 a9 e1 00 00 38 00 00 00 35 e2 00 00 db 00 00 00	....................8...5.......
0c40	6e e2 00 00 70 00 00 00 4a e3 00 00 47 00 00 00 bb e3 00 00 2f 00 00 00 03 e4 00 00 24 00 00 00	n...p...J...G......./.......$...
0c60	33 e4 00 00 64 00 00 00 58 e4 00 00 b5 00 00 00 bd e4 00 00 81 00 00 00 73 e5 00 00 58 00 00 00	3...d...X...............s...X...
0c80	f5 e5 00 00 88 00 00 00 4e e6 00 00 a4 00 00 00 d7 e6 00 00 94 00 00 00 7c e7 00 00 9f 01 00 00	........N...............|.......
0ca0	11 e8 00 00 9e 01 00 00 b1 e9 00 00 73 00 00 00 50 eb 00 00 47 01 00 00 c4 eb 00 00 39 00 00 00	............s...P...G.......9...
0cc0	0c ed 00 00 09 00 00 00 46 ed 00 00 1c 00 00 00 50 ed 00 00 1e 00 00 00 6d ed 00 00 ba 00 00 00	........F.......P.......m.......
0ce0	8c ed 00 00 14 01 00 00 47 ee 00 00 4b 00 00 00 5c ef 00 00 9e 00 00 00 a8 ef 00 00 b4 00 00 00	........G...K...\...............
0d00	47 f0 00 00 81 00 00 00 fc f0 00 00 5d 01 00 00 7e f1 00 00 66 01 00 00 dc f2 00 00 b1 00 00 00	G...........]...~...f...........
0d20	43 f4 00 00 b2 00 00 00 f5 f4 00 00 cb 00 00 00 a8 f5 00 00 28 00 00 00 74 f6 00 00 78 00 00 00	C...................(...t...x...
0d40	9d f6 00 00 2d 00 00 00 16 f7 00 00 78 00 00 00 44 f7 00 00 59 00 00 00 bd f7 00 00 19 01 00 00	....-.......x...D...Y...........
0d60	17 f8 00 00 22 00 00 00 31 f9 00 00 2d 00 00 00 54 f9 00 00 20 00 00 00 82 f9 00 00 19 00 00 00	...."...1...-...T...............
0d80	a3 f9 00 00 18 00 00 00 bd f9 00 00 3b 00 00 00 d6 f9 00 00 84 00 00 00 12 fa 00 00 0a 00 00 00	............;...................
0da0	97 fa 00 00 34 00 00 00 a2 fa 00 00 ac 01 00 00 d7 fa 00 00 85 00 00 00 84 fc 00 00 d6 00 00 00	....4...........................
0dc0	0a fd 00 00 07 00 00 00 e1 fd 00 00 6c 00 00 00 e9 fd 00 00 b2 01 00 00 56 fe 00 00 72 01 00 00	............l...........V...r...
0de0	09 00 01 00 26 00 00 00 7c 01 01 00 14 00 00 00 a3 01 01 00 06 00 00 00 b8 01 01 00 3d 00 00 00	....&...|...................=...
0e00	bf 01 01 00 18 00 00 00 fd 01 01 00 34 00 00 00 16 02 01 00 15 00 00 00 4b 02 01 00 16 00 00 00	............4...........K.......
0e20	61 02 01 00 12 00 00 00 78 02 01 00 20 00 00 00 8b 02 01 00 21 00 00 00 ac 02 01 00 08 00 00 00	a.......x...........!...........
0e40	ce 02 01 00 23 00 00 00 d7 02 01 00 1c 00 00 00 fb 02 01 00 0d 00 00 00 18 03 01 00 59 00 00 00	....#.......................Y...
0e60	26 03 01 00 4f 00 00 00 80 03 01 00 4e 00 00 00 d0 03 01 00 06 00 00 00 1f 04 01 00 0a 00 00 00	&...O.......N...................
0e80	26 04 01 00 0d 00 00 00 31 04 01 00 06 00 00 00 3f 04 01 00 0f 00 00 00 46 04 01 00 16 00 00 00	&.......1.......?.......F.......
0ea0	56 04 01 00 0d 00 00 00 6d 04 01 00 0a 00 00 00 7b 04 01 00 49 00 00 00 86 04 01 00 31 00 00 00	V.......m.......{...I.......1...
0ec0	d0 04 01 00 2a 00 00 00 02 05 01 00 1b 00 00 00 2d 05 01 00 1a 00 00 00 49 05 01 00 13 00 00 00	....*...........-.......I.......
0ee0	64 05 01 00 1f 00 00 00 78 05 01 00 0c 00 00 00 98 05 01 00 e2 00 00 00 a5 05 01 00 77 00 00 00	d.......x...................w...
0f00	88 06 01 00 03 00 00 00 00 07 01 00 35 00 00 00 04 07 01 00 1c 00 00 00 3a 07 01 00 34 00 00 00	............5...........:...4...
0f20	57 07 01 00 44 00 00 00 8c 07 01 00 44 00 00 00 d1 07 01 00 25 00 00 00 16 08 01 00 42 00 00 00	W...D.......D.......%.......B...
0f40	3c 08 01 00 21 00 00 00 7f 08 01 00 15 00 00 00 a1 08 01 00 25 00 00 00 b7 08 01 00 5b 00 00 00	<...!...............%.......[...
0f60	dd 08 01 00 1e 00 00 00 39 09 01 00 50 00 00 00 58 09 01 00 87 00 00 00 a9 09 01 00 9c 00 00 00	........9...P...X...............
0f80	31 0a 01 00 51 01 00 00 ce 0a 01 00 f5 00 00 00 20 0c 01 00 92 01 00 00 16 0d 01 00 3b 01 00 00	1...Q.......................;...
0fa0	a9 0e 01 00 33 00 00 00 e5 0f 01 00 09 00 00 00 19 10 01 00 55 00 00 00 23 10 01 00 5f 00 00 00	....3...............U...#..._...
0fc0	79 10 01 00 1c 00 00 00 d9 10 01 00 07 00 00 00 f6 10 01 00 64 00 00 00 fe 10 01 00 e7 00 00 00	y...................d...........
0fe0	63 11 01 00 8b 00 00 00 4b 12 01 00 75 00 00 00 d7 12 01 00 47 00 00 00 4d 13 01 00 39 01 00 00	c.......K...u.......G...M...9...
1000	95 13 01 00 cd 00 00 00 cf 14 01 00 22 00 00 00 9d 15 01 00 b8 00 00 00 c0 15 01 00 0d 01 00 00	............"...................
1020	79 16 01 00 a0 00 00 00 87 17 01 00 92 00 00 00 28 18 01 00 f4 00 00 00 bb 18 01 00 75 00 00 00	y...............(...........u...
1040	b0 19 01 00 3d 00 00 00 26 1a 01 00 7b 00 00 00 64 1a 01 00 ab 00 00 00 e0 1a 01 00 85 00 00 00	....=...&...{...d...............
1060	8c 1b 01 00 20 00 00 00 12 1c 01 00 1f 00 00 00 33 1c 01 00 1e 00 00 00 53 1c 01 00 21 00 00 00	................3.......S...!...
1080	72 1c 01 00 1d 00 00 00 94 1c 01 00 1d 00 00 00 b2 1c 01 00 11 00 00 00 d0 1c 01 00 11 00 00 00	r...............................
10a0	e2 1c 01 00 5f 00 00 00 f4 1c 01 00 7f 01 00 00 54 1d 01 00 7e 01 00 00 d4 1e 01 00 0b 00 00 00	...._...........T...~...........
10c0	53 20 01 00 10 00 00 00 5f 20 01 00 2d 00 00 00 70 20 01 00 05 00 00 00 9e 20 01 00 0f 00 00 00	S......._...-...p...............
10e0	a4 20 01 00 09 00 00 00 b4 20 01 00 0a 00 00 00 be 20 01 00 11 00 00 00 c9 20 01 00 1c 00 00 00	................................
1100	db 20 01 00 13 00 00 00 f8 20 01 00 74 00 00 00 0c 21 01 00 2d 01 00 00 81 21 01 00 66 01 00 00	............t....!..-....!..f...
1120	af 22 01 00 a7 00 00 00 16 24 01 00 d9 00 00 00 be 24 01 00 8f 01 00 00 98 25 01 00 10 00 00 00	.".......$.......$.......%......
1140	28 27 01 00 1e 00 00 00 39 27 01 00 72 00 00 00 58 27 01 00 3f 00 00 00 cb 27 01 00 3a 00 00 00	('......9'..r...X'..?....'..:...
1160	0b 28 01 00 11 00 00 00 46 28 01 00 d7 00 00 00 58 28 01 00 95 00 00 00 30 29 01 00 11 00 00 00	.(......F(......X(......0)......
1180	c6 29 01 00 18 00 00 00 d8 29 01 00 22 00 00 00 f1 29 01 00 2c 00 00 00 14 2a 01 00 53 00 00 00	.).......).."....)..,....*..S...
11a0	41 2a 01 00 16 00 00 00 95 2a 01 00 09 00 00 00 ac 2a 01 00 28 00 00 00 b6 2a 01 00 74 00 00 00	A*.......*.......*..(....*..t...
11c0	df 2a 01 00 fa 00 00 00 54 2b 01 00 26 00 00 00 4f 2c 01 00 68 00 00 00 76 2c 01 00 26 00 00 00	.*......T+..&...O,..h...v,..&...
11e0	df 2c 01 00 49 00 00 00 06 2d 01 00 25 00 00 00 50 2d 01 00 21 00 00 00 76 2d 01 00 1b 01 00 00	.,..I....-..%...P-..!...v-......
1200	98 2d 01 00 09 00 00 00 b4 2e 01 00 1e 00 00 00 be 2e 01 00 0b 00 00 00 dd 2e 01 00 1a 00 00 00	.-..............................
1220	e9 2e 01 00 0b 00 00 00 04 2f 01 00 50 00 00 00 10 2f 01 00 06 00 00 00 61 2f 01 00 09 00 00 00	........./..P..../......a/......
1240	68 2f 01 00 c0 00 00 00 72 2f 01 00 65 00 00 00 33 30 01 00 50 00 00 00 99 30 01 00 28 01 00 00	h/......r/..e...30..P....0..(...
1260	ea 30 01 00 14 01 00 00 13 32 01 00 8b 00 00 00 28 33 01 00 10 00 00 00 b4 33 01 00 22 00 00 00	.0.......2......(3.......3.."...
1280	c5 33 01 00 fc 00 00 00 e8 33 01 00 08 00 00 00 e5 34 01 00 09 00 00 00 ee 34 01 00 9b 01 00 00	.3.......3.......4.......4......
12a0	f8 34 01 00 8f 00 00 00 94 36 01 00 76 00 00 00 24 37 01 00 03 00 00 00 9b 37 01 00 0f 00 00 00	.4.......6..v...$7.......7......
12c0	9f 37 01 00 10 00 00 00 af 37 01 00 51 00 00 00 c0 37 01 00 08 00 00 00 12 38 01 00 4e 00 00 00	.7.......7..Q....7.......8..N...
12e0	1b 38 01 00 fb 00 00 00 6a 38 01 00 3b 00 00 00 66 39 01 00 ae 00 00 00 a2 39 01 00 b2 00 00 00	.8......j8..;...f9.......9......
1300	51 3a 01 00 86 00 00 00 04 3b 01 00 57 00 00 00 8b 3b 01 00 b4 00 00 00 e3 3b 01 00 20 00 00 00	Q:.......;..W....;.......;......
1320	98 3c 01 00 45 00 00 00 b9 3c 01 00 74 01 00 00 ff 3c 01 00 0a 00 00 00 74 3e 01 00 10 00 00 00	.<..E....<..t....<......t>......
1340	7f 3e 01 00 2e 00 00 00 90 3e 01 00 0a 00 00 00 bf 3e 01 00 1f 00 00 00 ca 3e 01 00 1e 00 00 00	.>.......>.......>.......>......
1360	ea 3e 01 00 1e 00 00 00 09 3f 01 00 12 00 00 00 28 3f 01 00 44 00 00 00 3b 3f 01 00 0a 00 00 00	.>.......?......(?..D...;?......
1380	80 3f 01 00 0b 00 00 00 8b 3f 01 00 9b 00 00 00 97 3f 01 00 22 00 00 00 33 40 01 00 23 00 00 00	.?.......?.......?.."...3@..#...
13a0	56 40 01 00 1e 00 00 00 7a 40 01 00 25 00 00 00 99 40 01 00 25 00 00 00 bf 40 01 00 13 00 00 00	V@......z@..%....@..%....@......
13c0	e5 40 01 00 10 00 00 00 f9 40 01 00 0f 00 00 00 0a 41 01 00 b7 00 00 00 1a 41 01 00 fb 00 00 00	.@.......@.......A.......A......
13e0	d2 41 01 00 f2 00 00 00 ce 42 01 00 9f 00 00 00 c1 43 01 00 57 00 00 00 61 44 01 00 8a 00 00 00	.A.......B.......C..W...aD......
1400	b9 44 01 00 8e 00 00 00 44 45 01 00 9b 01 00 00 d3 45 01 00 9a 00 00 00 6f 47 01 00 11 01 00 00	.D......DE.......E......oG......
1420	0a 48 01 00 77 00 00 00 1c 49 01 00 f1 00 00 00 94 49 01 00 e4 00 00 00 86 4a 01 00 08 01 00 00	.H..w....I.......I.......J......
1440	6b 4b 01 00 11 01 00 00 74 4c 01 00 0a 01 00 00 86 4d 01 00 76 00 00 00 91 4e 01 00 0e 00 00 00	kK......tL.......M..v....N......
1460	08 4f 01 00 23 01 00 00 17 4f 01 00 07 00 00 00 3b 50 01 00 27 00 00 00 43 50 01 00 25 00 00 00	.O..#....O......;P..'...CP..%...
1480	6b 50 01 00 7d 00 00 00 91 50 01 00 09 00 00 00 0f 51 01 00 11 00 00 00 19 51 01 00 09 00 00 00	kP..}....P.......Q.......Q......
14a0	2b 51 01 00 09 00 00 00 35 51 01 00 15 00 00 00 3f 51 01 00 62 00 00 00 55 51 01 00 4b 00 00 00	+Q......5Q......?Q..b...UQ..K...
14c0	b8 51 01 00 17 00 00 00 04 52 01 00 8a 00 00 00 1c 52 01 00 8a 00 00 00 a7 52 01 00 b4 00 00 00	.Q.......R.......R.......R......
14e0	32 53 01 00 0a 00 00 00 e7 53 01 00 2a 00 00 00 f2 53 01 00 61 00 00 00 1d 54 01 00 77 00 00 00	2S.......S..*....S..a....T..w...
1500	7f 54 01 00 06 00 00 00 f7 54 01 00 29 00 00 00 fe 54 01 00 39 00 00 00 28 55 01 00 fb 00 00 00	.T.......T..)....T..9...(U......
1520	62 55 01 00 9b 00 00 00 5e 56 01 00 5a 01 00 00 fa 56 01 00 07 00 00 00 55 58 01 00 0c 00 00 00	bU......^V..Z....V......UX......
1540	5d 58 01 00 0b 00 00 00 6a 58 01 00 08 00 00 00 76 58 01 00 72 00 00 00 7f 58 01 00 14 00 00 00	]X......jX......vX..r....X......
1560	f2 58 01 00 17 00 00 00 07 59 01 00 74 00 00 00 1f 59 01 00 0d 00 00 00 94 59 01 00 11 00 00 00	.X.......Y..t....Y.......Y......
1580	a2 59 01 00 1e 00 00 00 b4 59 01 00 0c 00 00 00 d3 59 01 00 0a 00 00 00 e0 59 01 00 21 00 00 00	.Y.......Y.......Y.......Y..!...
15a0	eb 59 01 00 17 00 00 00 0d 5a 01 00 20 00 00 00 25 5a 01 00 27 00 00 00 46 5a 01 00 04 00 00 00	.Y.......Z......%Z..'...FZ......
15c0	6e 5a 01 00 05 00 00 00 73 5a 01 00 66 00 00 00 79 5a 01 00 d9 00 00 00 e0 5a 01 00 6e 00 00 00	nZ......sZ..f...yZ.......Z..n...
15e0	ba 5b 01 00 2d 01 00 00 29 5c 01 00 8e 00 00 00 57 5d 01 00 12 00 00 00 e6 5d 01 00 9a 00 00 00	.[..-...)\......W].......]......
1600	f9 5d 01 00 70 00 00 00 94 5e 01 00 69 00 00 00 05 5f 01 00 7a 00 00 00 6f 5f 01 00 37 01 00 00	.]..p....^..i...._..z...o_..7...
1620	ea 5f 01 00 38 01 00 00 22 61 01 00 1d 00 00 00 5b 62 01 00 2b 01 00 00 79 62 01 00 2f 00 00 00	._..8..."a......[b..+...yb../...
1640	a5 63 01 00 fd 00 00 00 d5 63 01 00 fe 00 00 00 d3 64 01 00 43 02 00 00 d2 65 01 00 d5 00 00 00	.c.......c.......d..C....e......
1660	16 68 01 00 fe 00 00 00 ec 68 01 00 08 00 00 00 eb 69 01 00 cb 00 00 00 f4 69 01 00 1f 00 00 00	.h.......h.......i.......i......
1680	c0 6a 01 00 66 00 00 00 e0 6a 01 00 9d 00 00 00 47 6b 01 00 a0 00 00 00 e5 6b 01 00 a1 00 00 00	.j..f....j......Gk.......k......
16a0	86 6c 01 00 10 00 00 00 28 6d 01 00 0c 00 00 00 39 6d 01 00 12 00 00 00 46 6d 01 00 14 00 00 00	.l......(m......9m......Fm......
16c0	59 6d 01 00 2b 00 00 00 6e 6d 01 00 0d 00 00 00 9a 6d 01 00 0a 00 00 00 a8 6d 01 00 91 00 00 00	Ym..+...nm.......m.......m......
16e0	b3 6d 01 00 26 00 00 00 45 6e 01 00 06 00 00 00 6c 6e 01 00 d2 00 00 00 73 6e 01 00 95 00 00 00	.m..&...En......ln......sn......
1700	46 6f 01 00 4e 00 00 00 dc 6f 01 00 04 00 00 00 2b 70 01 00 6b 00 00 00 30 70 01 00 c9 00 00 00	Fo..N....o......+p..k...0p......
1720	9c 70 01 00 0c 00 00 00 66 71 01 00 37 00 00 00 73 71 01 00 38 00 00 00 ab 71 01 00 41 00 00 00	.p......fq..7...sq..8....q..A...
1740	e4 71 01 00 9d 00 00 00 26 72 01 00 0a 00 00 00 c4 72 01 00 93 00 00 00 cf 72 01 00 9a 00 00 00	.q......&r.......r.......r......
1760	63 73 01 00 99 00 00 00 fe 73 01 00 b4 01 00 00 98 74 01 00 04 01 00 00 4d 76 01 00 51 01 00 00	cs.......s.......t......Mv..Q...
1780	52 77 01 00 85 00 00 00 a4 78 01 00 10 00 00 00 2a 79 01 00 24 01 00 00 3b 79 01 00 0e 00 00 00	Rw.......x......*y..$...;y......
17a0	60 7a 01 00 41 00 00 00 6f 7a 01 00 07 00 00 00 b1 7a 01 00 fd 00 00 00 b9 7a 01 00 0e 00 00 00	`z..A...oz.......z.......z......
17c0	b7 7b 01 00 11 00 00 00 c6 7b 01 00 db 00 00 00 d8 7b 01 00 32 01 00 00 b4 7c 01 00 07 00 00 00	.{.......{.......{..2....|......
17e0	e7 7d 01 00 0f 00 00 00 ef 7d 01 00 f7 00 00 00 ff 7d 01 00 7d 00 00 00 f7 7e 01 00 9f 00 00 00	.}.......}.......}..}....~......
1800	75 7f 01 00 40 01 00 00 15 80 01 00 a3 00 00 00 56 81 01 00 47 00 00 00 fa 81 01 00 ab 01 00 00	u...@...........V...G...........
1820	42 82 01 00 d2 02 00 00 ee 83 01 00 49 00 00 00 c1 86 01 00 11 02 00 00 0b 87 01 00 97 00 00 00	B...........I...................
1840	1d 89 01 00 3b 02 00 00 b5 89 01 00 96 01 00 00 f1 8b 01 00 d1 00 00 00 88 8d 01 00 18 01 00 00	....;...........................
1860	5a 8e 01 00 02 01 00 00 73 8f 01 00 35 00 00 00 76 90 01 00 54 01 00 00 ac 90 01 00 38 00 00 00	Z.......s...5...v...T.......8...
1880	01 92 01 00 a7 00 00 00 3a 92 01 00 f8 00 00 00 e2 92 01 00 8d 00 00 00 db 93 01 00 77 00 00 00	........:...................w...
18a0	69 94 01 00 4c 00 00 00 e1 94 01 00 8e 00 00 00 2e 95 01 00 00 02 00 00 bd 95 01 00 26 00 00 00	i...L.......................&...
18c0	be 97 01 00 a0 00 00 00 e5 97 01 00 22 00 00 00 86 98 01 00 3b 00 00 00 a9 98 01 00 26 01 00 00	............".......;.......&...
18e0	e5 98 01 00 78 01 00 00 0c 9a 01 00 24 00 00 00 85 9b 01 00 15 01 00 00 aa 9b 01 00 15 01 00 00	....x.......$...................
1900	c0 9c 01 00 5d 00 00 00 d6 9d 01 00 7f 00 00 00 34 9e 01 00 62 00 00 00 b4 9e 01 00 38 00 00 00	....]...........4...b.......8...
1920	17 9f 01 00 3d 00 00 00 50 9f 01 00 a0 00 00 00 8e 9f 01 00 b4 00 00 00 2f a0 01 00 10 01 00 00	....=...P.............../.......
1940	e4 a0 01 00 2c 00 00 00 f5 a1 01 00 19 01 00 00 22 a2 01 00 b6 00 00 00 3c a3 01 00 84 00 00 00	....,...........".......<.......
1960	f3 a3 01 00 97 00 00 00 78 a4 01 00 46 00 00 00 10 a5 01 00 f6 00 00 00 57 a5 01 00 07 01 00 00	........x...F...........W.......
1980	4e a6 01 00 47 00 00 00 56 a7 01 00 bf 00 00 00 9e a7 01 00 68 00 00 00 5e a8 01 00 6e 00 00 00	N...G...V...........h...^...n...
19a0	c7 a8 01 00 dd 00 00 00 36 a9 01 00 a6 00 00 00 14 aa 01 00 a3 00 00 00 bb aa 01 00 60 00 00 00	........6...................`...
19c0	5f ab 01 00 23 00 00 00 c0 ab 01 00 0f 00 00 00 e4 ab 01 00 a1 00 00 00 f4 ab 01 00 71 00 00 00	_...#.......................q...
19e0	96 ac 01 00 5f 01 00 00 08 ad 01 00 b8 00 00 00 68 ae 01 00 d3 00 00 00 21 af 01 00 d2 00 00 00	...._...........h.......!.......
1a00	f5 af 01 00 84 00 00 00 c8 b0 01 00 83 00 00 00 4d b1 01 00 3d 00 00 00 d1 b1 01 00 74 00 00 00	................M...=.......t...
1a20	0f b2 01 00 6c 00 00 00 84 b2 01 00 60 01 00 00 f1 b2 01 00 37 00 00 00 52 b4 01 00 35 00 00 00	....l.......`.......7...R...5...
1a40	8a b4 01 00 a5 00 00 00 c0 b4 01 00 0f 00 00 00 66 b5 01 00 0a 02 00 00 76 b5 01 00 11 00 00 00	................f.......v.......
1a60	81 b7 01 00 21 00 00 00 93 b7 01 00 0e 00 00 00 b5 b7 01 00 d5 00 00 00 c4 b7 01 00 0c 00 00 00	....!...........................
1a80	9a b8 01 00 09 00 00 00 a7 b8 01 00 14 00 00 00 b1 b8 01 00 17 00 00 00 c6 b8 01 00 1f 00 00 00	................................
1aa0	de b8 01 00 06 00 00 00 fe b8 01 00 3f 00 00 00 05 b9 01 00 47 00 00 00 45 b9 01 00 18 00 00 00	............?.......G...E.......
1ac0	8d b9 01 00 67 01 00 00 a6 b9 01 00 68 01 00 00 0e bb 01 00 af 00 00 00 77 bc 01 00 09 01 00 00	....g.......h...........w.......
1ae0	27 bd 01 00 dd 00 00 00 31 be 01 00 6d 00 00 00 0f bf 01 00 19 00 00 00 7d bf 01 00 c8 00 00 00	'.......1...m...........}.......
1b00	97 bf 01 00 8b 00 00 00 60 c0 01 00 38 00 00 00 ec c0 01 00 db 00 00 00 25 c1 01 00 70 00 00 00	........`...8...........%...p...
1b20	01 c2 01 00 47 00 00 00 72 c2 01 00 2f 00 00 00 ba c2 01 00 24 00 00 00 ea c2 01 00 64 00 00 00	....G...r.../.......$.......d...
1b40	0f c3 01 00 b5 00 00 00 74 c3 01 00 81 00 00 00 2a c4 01 00 58 00 00 00 ac c4 01 00 88 00 00 00	........t.......*...X...........
1b60	05 c5 01 00 a4 00 00 00 8e c5 01 00 94 00 00 00 33 c6 01 00 9f 01 00 00 c8 c6 01 00 9e 01 00 00	................3...............
1b80	68 c8 01 00 73 00 00 00 07 ca 01 00 47 01 00 00 7b ca 01 00 39 00 00 00 c3 cb 01 00 09 00 00 00	h...s.......G...{...9...........
1ba0	fd cb 01 00 1c 00 00 00 07 cc 01 00 1e 00 00 00 24 cc 01 00 ba 00 00 00 43 cc 01 00 14 01 00 00	................$.......C.......
1bc0	fe cc 01 00 4b 00 00 00 13 ce 01 00 9e 00 00 00 5f ce 01 00 b4 00 00 00 fe ce 01 00 81 00 00 00	....K..........._...............
1be0	b3 cf 01 00 5d 01 00 00 35 d0 01 00 66 01 00 00 93 d1 01 00 b1 00 00 00 fa d2 01 00 b2 00 00 00	....]...5...f...................
1c00	ac d3 01 00 cb 00 00 00 5f d4 01 00 28 00 00 00 2b d5 01 00 78 00 00 00 54 d5 01 00 2d 00 00 00	........_...(...+...x...T...-...
1c20	cd d5 01 00 78 00 00 00 fb d5 01 00 59 00 00 00 74 d6 01 00 19 01 00 00 ce d6 01 00 22 00 00 00	....x.......Y...t..........."...
1c40	e8 d7 01 00 2d 00 00 00 0b d8 01 00 20 00 00 00 39 d8 01 00 19 00 00 00 5a d8 01 00 18 00 00 00	....-...........9.......Z.......
1c60	74 d8 01 00 3b 00 00 00 8d d8 01 00 84 00 00 00 c9 d8 01 00 0a 00 00 00 4e d9 01 00 34 00 00 00	t...;...................N...4...
1c80	59 d9 01 00 ac 01 00 00 8e d9 01 00 85 00 00 00 3b db 01 00 d6 00 00 00 c1 db 01 00 07 00 00 00	Y...............;...............
1ca0	98 dc 01 00 6c 00 00 00 a0 dc 01 00 b2 01 00 00 0d dd 01 00 72 01 00 00 c0 de 01 00 26 00 00 00	....l...............r.......&...
1cc0	33 e0 01 00 14 00 00 00 5a e0 01 00 06 00 00 00 6f e0 01 00 3d 00 00 00 76 e0 01 00 18 00 00 00	3.......Z.......o...=...v.......
1ce0	b4 e0 01 00 34 00 00 00 cd e0 01 00 15 00 00 00 02 e1 01 00 16 00 00 00 18 e1 01 00 12 00 00 00	....4...........................
1d00	2f e1 01 00 20 00 00 00 42 e1 01 00 21 00 00 00 63 e1 01 00 08 00 00 00 85 e1 01 00 23 00 00 00	/.......B...!...c...........#...
1d20	8e e1 01 00 1c 00 00 00 b2 e1 01 00 0d 00 00 00 cf e1 01 00 59 00 00 00 dd e1 01 00 4f 00 00 00	....................Y.......O...
1d40	37 e2 01 00 4e 00 00 00 87 e2 01 00 06 00 00 00 d6 e2 01 00 0a 00 00 00 dd e2 01 00 0d 00 00 00	7...N...........................
1d60	e8 e2 01 00 06 00 00 00 f6 e2 01 00 0f 00 00 00 fd e2 01 00 16 00 00 00 0d e3 01 00 0d 00 00 00	................................
1d80	24 e3 01 00 0a 00 00 00 32 e3 01 00 49 00 00 00 3d e3 01 00 31 00 00 00 87 e3 01 00 2a 00 00 00	$.......2...I...=...1.......*...
1da0	b9 e3 01 00 1b 00 00 00 e4 e3 01 00 1a 00 00 00 00 e4 01 00 13 00 00 00 1b e4 01 00 1f 00 00 00	................................
1dc0	2f e4 01 00 0c 00 00 00 4f e4 01 00 01 00 00 00 00 00 00 00 60 00 00 00 29 00 00 00 00 00 00 00	/.......O...........`...).......
1de0	b5 01 00 00 74 00 00 00 00 00 00 00 0a 00 00 00 fe 00 00 00 ce 01 00 00 8a 00 00 00 1a 00 00 00	....t...........................
1e00	4c 01 00 00 3a 00 00 00 95 01 00 00 00 00 00 00 b7 01 00 00 6c 01 00 00 83 00 00 00 00 00 00 00	L...:...............l...........
1e20	00 00 00 00 00 00 00 00 00 00 00 00 44 01 00 00 e1 00 00 00 4d 01 00 00 c3 00 00 00 20 01 00 00	............D.......M...........
1e40	00 00 00 00 a1 00 00 00 00 00 00 00 a4 00 00 00 06 01 00 00 96 01 00 00 00 00 00 00 00 00 00 00	................................
1e60	00 00 00 00 5b 00 00 00 85 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 0d 01 00 00 00 00 00 00	....[...........................
1e80	2d 01 00 00 7b 01 00 00 31 00 00 00 dd 00 00 00 69 01 00 00 b6 01 00 00 60 01 00 00 49 00 00 00	-...{...1.......i.......`...I...
1ea0	00 00 00 00 0c 01 00 00 00 00 00 00 00 00 00 00 a8 01 00 00 d0 01 00 00 2d 00 00 00 b9 01 00 00	........................-.......
1ec0	e9 00 00 00 00 00 00 00 4b 00 00 00 9b 00 00 00 13 00 00 00 69 00 00 00 00 00 00 00 a0 00 00 00	........K...........i...........
1ee0	00 00 00 00 83 01 00 00 d6 00 00 00 41 01 00 00 00 00 00 00 e6 00 00 00 04 01 00 00 af 01 00 00	............A...................
1f00	8a 01 00 00 00 00 00 00 59 01 00 00 95 00 00 00 23 00 00 00 07 00 00 00 00 00 00 00 79 00 00 00	........Y.......#...........y...
1f20	93 01 00 00 00 00 00 00 00 00 00 00 65 01 00 00 37 01 00 00 68 00 00 00 00 00 00 00 9a 01 00 00	............e...7...h...........
1f40	c4 01 00 00 b5 00 00 00 6f 01 00 00 8d 01 00 00 70 01 00 00 07 01 00 00 19 01 00 00 00 00 00 00	........o.......p...............
1f60	cc 01 00 00 00 00 00 00 00 00 00 00 d9 00 00 00 21 01 00 00 10 01 00 00 44 00 00 00 64 01 00 00	................!.......D...d...
1f80	10 00 00 00 00 00 00 00 00 00 00 00 27 00 00 00 a9 00 00 00 00 00 00 00 00 00 00 00 b2 00 00 00	............'...................
1fa0	00 00 00 00 b0 01 00 00 00 00 00 00 ad 01 00 00 49 01 00 00 4c 00 00 00 7b 00 00 00 fc 00 00 00	................I...L...{.......
1fc0	50 00 00 00 00 00 00 00 00 00 00 00 6a 00 00 00 00 00 00 00 f8 00 00 00 00 00 00 00 b7 00 00 00	P...........j...................
1fe0	00 00 00 00 8e 01 00 00 6b 00 00 00 0e 00 00 00 00 00 00 00 33 01 00 00 bf 00 00 00 00 00 00 00	........k...........3...........
2000	e3 00 00 00 ee 00 00 00 3f 00 00 00 bd 01 00 00 00 00 00 00 7e 01 00 00 a7 00 00 00 08 00 00 00	........?...........~...........
2020	14 01 00 00 63 00 00 00 00 00 00 00 5f 01 00 00 33 00 00 00 ba 01 00 00 ce 00 00 00 00 00 00 00	....c......._...3...............
2040	b3 00 00 00 00 00 00 00 ae 01 00 00 12 01 00 00 82 00 00 00 db 01 00 00 f1 00 00 00 72 00 00 00	............................r...
2060	bb 00 00 00 d9 01 00 00 00 00 00 00 ff 00 00 00 88 00 00 00 b1 01 00 00 76 01 00 00 00 00 00 00	........................v.......
2080	be 00 00 00 23 01 00 00 15 00 00 00 3d 00 00 00 00 00 00 00 ca 00 00 00 15 01 00 00 00 00 00 00	....#.......=...................
20a0	a9 01 00 00 3b 00 00 00 00 00 00 00 28 00 00 00 00 00 00 00 87 00 00 00 19 00 00 00 ec 00 00 00	....;.......(...................
20c0	00 00 00 00 d7 00 00 00 00 00 00 00 00 00 00 00 bd 00 00 00 bc 01 00 00 55 00 00 00 00 00 00 00	........................U.......
20e0	d2 00 00 00 00 01 00 00 1c 01 00 00 a7 01 00 00 00 00 00 00 c1 01 00 00 34 01 00 00 40 01 00 00	........................4...@...
2100	6d 01 00 00 00 00 00 00 00 00 00 00 92 01 00 00 be 01 00 00 a8 00 00 00 d3 01 00 00 48 00 00 00	m...........................H...
2120	42 01 00 00 42 00 00 00 c8 01 00 00 cd 00 00 00 5f 00 00 00 38 01 00 00 6c 00 00 00 b8 01 00 00	B...B..........._...8...l.......
2140	7d 01 00 00 84 01 00 00 00 00 00 00 00 00 00 00 9d 00 00 00 a3 01 00 00 73 01 00 00 94 01 00 00	}.......................s.......
2160	2e 00 00 00 00 00 00 00 76 00 00 00 d7 01 00 00 a1 01 00 00 97 00 00 00 cf 01 00 00 00 00 00 00	........v.......................
2180	00 00 00 00 26 00 00 00 0a 01 00 00 4a 00 00 00 00 00 00 00 78 01 00 00 66 01 00 00 ac 01 00 00	....&.......J.......x...f.......
21a0	d4 01 00 00 81 00 00 00 d2 01 00 00 f0 00 00 00 4a 01 00 00 00 00 00 00 ea 00 00 00 4e 01 00 00	................J...........N...
21c0	2a 01 00 00 52 00 00 00 00 00 00 00 8f 00 00 00 80 00 00 00 66 00 00 00 5c 00 00 00 ac 00 00 00	*...R...............f...\.......
21e0	00 00 00 00 0b 00 00 00 e4 00 00 00 cb 00 00 00 00 00 00 00 c6 01 00 00 46 01 00 00 f5 00 00 00	........................F.......
2200	00 00 00 00 25 01 00 00 00 00 00 00 00 00 00 00 12 00 00 00 0c 00 00 00 71 00 00 00 00 00 00 00	....%...................q.......
2220	05 00 00 00 d5 00 00 00 f9 00 00 00 00 00 00 00 c5 00 00 00 8e 00 00 00 9e 01 00 00 47 00 00 00	............................G...
2240	8b 01 00 00 99 01 00 00 00 00 00 00 93 00 00 00 13 01 00 00 db 00 00 00 22 01 00 00 c0 00 00 00	........................".......
2260	d3 00 00 00 16 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ab 00 00 00 11 01 00 00 8c 01 00 00	................................
2280	b4 00 00 00 00 00 00 00 4f 00 00 00 3c 01 00 00 61 01 00 00 00 00 00 00 cc 00 00 00 02 01 00 00	........O...<...a...............
22a0	75 01 00 00 0f 01 00 00 62 00 00 00 c7 00 00 00 00 00 00 00 a5 00 00 00 16 01 00 00 6a 01 00 00	u.......b...................j...
22c0	00 00 00 00 20 00 00 00 1d 00 00 00 e2 00 00 00 7a 00 00 00 df 00 00 00 86 00 00 00 73 00 00 00	................z...........s...
22e0	61 00 00 00 29 01 00 00 31 01 00 00 cf 00 00 00 3a 01 00 00 00 00 00 00 0b 01 00 00 09 01 00 00	a...)...1.......:...............
2300	ed 00 00 00 00 00 00 00 2f 00 00 00 7c 01 00 00 f4 00 00 00 89 00 00 00 00 00 00 00 00 00 00 00	......../...|...................
2320	a4 01 00 00 c1 00 00 00 d0 00 00 00 6b 01 00 00 d1 01 00 00 92 00 00 00 d6 01 00 00 c4 00 00 00	............k...................
2340	4b 01 00 00 64 00 00 00 30 01 00 00 57 01 00 00 36 00 00 00 7d 00 00 00 fa 00 00 00 00 00 00 00	K...d...0...W...6...}...........
2360	ef 00 00 00 35 01 00 00 b2 01 00 00 c8 00 00 00 89 01 00 00 00 00 00 00 65 00 00 00 5a 00 00 00	....5...................e...Z...
2380	e5 00 00 00 00 00 00 00 00 00 00 00 3e 01 00 00 7f 01 00 00 7a 01 00 00 78 00 00 00 00 00 00 00	............>.......z...x.......
23a0	06 00 00 00 2a 00 00 00 58 00 00 00 00 00 00 00 00 00 00 00 1e 00 00 00 03 00 00 00 6e 01 00 00	....*...X...................n...
23c0	22 00 00 00 3c 00 00 00 a3 00 00 00 67 00 00 00 14 00 00 00 00 00 00 00 79 01 00 00 18 01 00 00	"...<.......g...........y.......
23e0	30 00 00 00 05 01 00 00 c5 01 00 00 00 00 00 00 99 00 00 00 cd 01 00 00 00 00 00 00 2b 00 00 00	0...........................+...
2400	00 00 00 00 72 01 00 00 8b 00 00 00 00 00 00 00 54 01 00 00 00 00 00 00 1d 01 00 00 7c 00 00 00	....r...........T...........|...
2420	84 00 00 00 3d 01 00 00 00 00 00 00 98 01 00 00 94 00 00 00 2e 01 00 00 85 01 00 00 aa 01 00 00	....=...........................
2440	75 00 00 00 51 00 00 00 37 00 00 00 68 01 00 00 b1 00 00 00 00 00 00 00 fd 00 00 00 da 00 00 00	u...Q...7...h...................
2460	71 01 00 00 de 00 00 00 c7 01 00 00 a2 00 00 00 e8 00 00 00 39 00 00 00 11 00 00 00 6d 00 00 00	q...................9.......m...
2480	9e 00 00 00 a0 01 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 36 01 00 00 1b 00 00 00	........................6.......
24a0	bb 01 00 00 03 01 00 00 01 01 00 00 9c 00 00 00 00 00 00 00 00 00 00 00 02 00 00 00 00 00 00 00	................................
24c0	25 00 00 00 00 00 00 00 00 00 00 00 b4 01 00 00 00 00 00 00 4e 00 00 00 81 01 00 00 b9 00 00 00	%...................N...........
24e0	96 00 00 00 90 00 00 00 50 01 00 00 ad 00 00 00 00 00 00 00 1b 01 00 00 87 01 00 00 24 01 00 00	........P...................$...
2500	ae 00 00 00 00 00 00 00 59 00 00 00 0d 00 00 00 f7 00 00 00 34 00 00 00 8d 00 00 00 2f 01 00 00	........Y...........4......./...
2520	00 00 00 00 00 00 00 00 2c 00 00 00 00 00 00 00 00 00 00 00 09 00 00 00 00 00 00 00 aa 00 00 00	........,.......................
2540	53 00 00 00 00 00 00 00 c2 00 00 00 1a 01 00 00 00 00 00 00 c2 01 00 00 80 01 00 00 8c 00 00 00	S...............................
2560	00 00 00 00 56 00 00 00 00 00 00 00 86 01 00 00 00 00 00 00 b6 00 00 00 54 00 00 00 5c 01 00 00	....V...................T...\...
2580	00 00 00 00 b3 01 00 00 00 00 00 00 5d 01 00 00 40 00 00 00 32 00 00 00 26 01 00 00 24 00 00 00	............]...@...2...&...$...
25a0	63 01 00 00 70 00 00 00 55 01 00 00 da 01 00 00 5a 01 00 00 ba 00 00 00 00 00 00 00 28 01 00 00	c...p...U.......Z...........(...
25c0	98 00 00 00 46 00 00 00 1f 01 00 00 a2 01 00 00 53 01 00 00 00 00 00 00 17 01 00 00 08 01 00 00	....F...........S...............
25e0	5e 00 00 00 0f 00 00 00 00 00 00 00 00 00 00 00 7f 00 00 00 77 00 00 00 9f 01 00 00 00 00 00 00	^...................w...........
2600	6e 00 00 00 00 00 00 00 9a 00 00 00 3f 01 00 00 56 01 00 00 67 01 00 00 00 00 00 00 00 00 00 00	n...........?...V...g...........
2620	00 00 00 00 00 00 00 00 00 00 00 00 ca 01 00 00 00 00 00 00 00 00 00 00 c9 01 00 00 51 01 00 00	............................Q...
2640	00 00 00 00 47 01 00 00 91 00 00 00 45 01 00 00 5b 01 00 00 1e 01 00 00 d1 00 00 00 5d 00 00 00	....G.......E...[...........]...
2660	5e 01 00 00 9c 01 00 00 90 01 00 00 18 00 00 00 00 00 00 00 6f 00 00 00 00 00 00 00 c6 00 00 00	^...................o...........
2680	ab 01 00 00 62 01 00 00 e7 00 00 00 00 00 00 00 21 00 00 00 1c 00 00 00 cb 01 00 00 a5 01 00 00	....b...........!...............
26a0	e0 00 00 00 00 00 00 00 00 00 00 00 91 01 00 00 00 00 00 00 b8 00 00 00 00 00 00 00 f3 00 00 00	................................
26c0	57 00 00 00 17 00 00 00 74 01 00 00 a6 00 00 00 32 01 00 00 3e 00 00 00 88 01 00 00 00 00 00 00	W.......t.......2...>...........
26e0	00 00 00 00 d8 01 00 00 97 01 00 00 b0 00 00 00 00 00 00 00 38 00 00 00 c0 01 00 00 00 00 00 00	....................8...........
2700	9d 01 00 00 f6 00 00 00 41 00 00 00 27 01 00 00 f2 00 00 00 1f 00 00 00 0e 01 00 00 dc 00 00 00	........A...'...................
2720	00 00 00 00 00 00 00 00 7e 00 00 00 43 01 00 00 3b 01 00 00 48 01 00 00 52 01 00 00 9b 01 00 00	........~...C...;...H...R.......
2740	c3 01 00 00 77 01 00 00 4f 01 00 00 8f 01 00 00 00 00 00 00 82 01 00 00 d5 01 00 00 00 00 00 00	....w...O.......................
2760	c9 00 00 00 35 00 00 00 a6 01 00 00 45 00 00 00 00 00 00 00 fb 00 00 00 eb 00 00 00 af 00 00 00	....5.......E...................
2780	2c 01 00 00 4d 00 00 00 9f 00 00 00 39 01 00 00 04 00 00 00 00 00 00 00 58 01 00 00 d8 00 00 00	,...M.......9...........X.......
27a0	00 00 00 00 2b 01 00 00 00 00 00 00 43 00 00 00 00 00 00 00 00 00 00 00 bf 01 00 00 00 00 00 00	....+.......C...................
27c0	d4 00 00 00 bc 00 00 00 00 00 00 00 00 00 00 00 00 22 24 7b 76 79 6f 73 5f 6c 69 62 65 78 65 63	................."${vyos_libexec
27e0	64 69 72 7d 2f 76 61 6c 69 64 61 74 6f 72 73 2f 66 6f 6f 20 62 61 72 20 24 56 41 52 28 40 29 22	dir}/validators/foo.bar.$VAR(@)"
2800	20 77 69 6c 6c 20 62 65 20 65 78 65 63 75 74 65 64 2c 20 3c 63 6f 6e 73 74 72 61 69 6e 74 45 72	.will.be.executed,.<constraintEr
2820	72 6f 72 4d 65 73 73 61 67 65 3e 20 77 69 6c 6c 20 62 65 20 64 69 73 70 6c 61 79 65 64 20 6f 6e	rorMessage>.will.be.displayed.on
2840	20 66 61 69 6c 75 72 65 00 2e 2e 2e 00 3c 63 6f 6e 73 74 72 61 69 6e 74 45 72 72 6f 72 4d 65 73	.failure.....<constraintErrorMes
2860	73 61 67 65 3e 20 77 69 6c 6c 20 62 65 20 64 69 73 70 6c 61 79 65 64 20 6f 6e 20 66 61 69 6c 75	sage>.will.be.displayed.on.failu
2880	72 65 00 3c 6e 6f 64 65 20 6e 61 6d 65 3d 22 6d 79 6e 6f 64 65 22 3e 20 3c 2f 6e 6f 64 65 3e 00	re.<node.name="mynode">.</node>.
28a0	3c 70 72 6f 70 65 72 74 69 65 73 3e 20 3c 63 6f 6d 70 6c 65 74 69 6f 6e 48 65 6c 70 3e 20 3c 6c	<properties>.<completionHelp>.<l
28c0	69 73 74 3e 20 66 6f 6f 20 62 61 72 20 3c 2f 6c 69 73 74 3e 00 3c 70 72 6f 70 65 72 74 69 65 73	ist>.foo.bar.</list>.<properties
28e0	3e 20 3c 63 6f 6d 70 6c 65 74 69 6f 6e 48 65 6c 70 3e 20 3c 70 61 74 68 3e 20 76 70 6e 20 69 70	>.<completionHelp>.<path>.vpn.ip
2900	73 65 63 20 65 73 70 2d 67 72 6f 75 70 20 3c 2f 70 61 74 68 3e 20 2e 2e 2e 00 3c 70 72 6f 70 65	sec.esp-group.</path>.....<prope
2920	72 74 69 65 73 3e 20 3c 63 6f 6d 70 6c 65 74 69 6f 6e 48 65 6c 70 3e 20 3c 73 63 72 69 70 74 3e	rties>.<completionHelp>.<script>
2940	20 2f 70 61 74 68 2f 74 6f 2f 73 63 72 69 70 74 20 3c 2f 73 63 72 69 70 74 3e 20 2e 2e 2e 00 3c	./path/to/script.</script>.....<
2960	70 72 6f 70 65 72 74 69 65 73 3e 20 3c 63 6f 6e 73 74 72 61 69 6e 74 3e 20 3c 72 65 67 65 78 3e	properties>.<constraint>.<regex>
2980	20 2e 2e 2e 00 3c 70 72 6f 70 65 72 74 69 65 73 3e 20 3c 63 6f 6e 73 74 72 61 69 6e 74 3e 20 3c	.....<properties>.<constraint>.<
29a0	76 61 6c 69 64 61 74 6f 72 3e 20 3c 6e 61 6d 65 20 3d 22 66 6f 6f 22 20 61 72 67 75 6d 65 6e 74	validator>.<name.="foo".argument
29c0	3d 22 62 61 72 22 3e 00 3c 70 72 6f 70 65 72 74 69 65 73 3e 20 3c 68 65 6c 70 3e 4d 79 20 6e 6f	="bar">.<properties>.<help>My.no
29e0	64 65 3c 2f 68 65 6c 70 3e 00 3c 70 72 6f 70 65 72 74 69 65 73 3e 20 3c 6d 75 6c 74 69 2f 3e 00	de</help>.<properties>.<multi/>.
2a00	3c 70 72 6f 70 65 72 74 69 65 73 3e 20 3c 70 72 69 6f 72 69 74 79 3e 39 39 39 3c 2f 70 72 69 6f	<properties>.<priority>999</prio
2a20	72 69 74 79 3e 00 3c 70 72 6f 70 65 72 74 69 65 73 3e 20 3c 76 61 6c 75 65 48 65 6c 70 3e 20 3c	rity>.<properties>.<valueHelp>.<
2a40	66 6f 72 6d 61 74 3e 20 66 6f 72 6d 61 74 20 3c 2f 66 6f 72 6d 61 74 3e 20 3c 64 65 73 63 72 69	format>.format.</format>.<descri
2a60	70 74 69 6f 6e 3e 20 73 6f 6d 65 20 73 74 72 69 6e 67 20 3c 2f 64 65 73 63 72 69 70 74 69 6f 6e	ption>.some.string.</description
2a80	3e 00 3c 74 61 67 4e 6f 64 65 20 6e 61 6d 65 3d 22 6d 79 6e 6f 64 65 3e 20 3c 2f 6e 6f 64 65 3e	>.<tagNode.name="mynode>.</node>
2aa0	00 41 20 66 6f 72 6b 20 77 69 74 68 20 70 61 63 6b 61 67 69 6e 67 20 63 68 61 6e 67 65 73 20 66	.A.fork.with.packaging.changes.f
2ac0	6f 72 20 56 79 4f 53 20 69 73 20 6b 65 70 74 20 61 74 20 68 74 74 70 73 3a 2f 2f 67 69 74 68 75	or.VyOS.is.kept.at.https://githu
2ae0	62 2e 63 6f 6d 2f 76 79 6f 73 2f 68 76 69 6e 66 6f 00 41 20 67 6f 6f 64 20 61 70 70 72 6f 61 63	b.com/vyos/hvinfo.A.good.approac
2b00	68 20 66 6f 72 20 77 72 69 74 69 6e 67 20 63 6f 6d 6d 69 74 20 6d 65 73 73 61 67 65 73 20 69 73	h.for.writing.commit.messages.is
2b20	20 61 63 74 75 61 6c 6c 79 20 74 6f 20 68 61 76 65 20 61 20 6c 6f 6f 6b 20 61 74 20 74 68 65 20	.actually.to.have.a.look.at.the.
2b40	66 69 6c 65 28 73 29 20 68 69 73 74 6f 72 79 20 62 79 20 69 6e 76 6f 6b 69 6e 67 20 60 60 67 69	file(s).history.by.invoking.``gi
2b60	74 20 6c 6f 67 20 70 61 74 68 2f 74 6f 2f 66 69 6c 65 2e 74 78 74 60 60 2e 00 41 20 6e 75 6d 62	t.log.path/to/file.txt``..A.numb
2b80	65 72 20 6f 66 20 66 6c 61 67 73 20 63 61 6e 20 62 65 20 73 65 74 20 75 70 20 74 6f 20 63 68 61	er.of.flags.can.be.set.up.to.cha
2ba0	6e 67 65 20 74 68 65 20 62 65 68 61 76 69 6f 75 72 20 6f 66 20 56 79 4f 53 20 61 74 20 72 75 6e	nge.the.behaviour.of.VyOS.at.run
2bc0	74 69 6d 65 2e 20 54 68 65 73 65 20 66 6c 61 67 73 20 63 61 6e 20 62 65 20 74 6f 67 67 6c 65 64	time..These.flags.can.be.toggled
2be0	20 75 73 69 6e 67 20 65 69 74 68 65 72 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 76 61 72 69 61 62	.using.either.environment.variab
2c00	6c 65 73 20 6f 72 20 63 72 65 61 74 69 6e 67 20 66 69 6c 65 73 2e 00 41 20 72 65 61 73 6f 6e 61	les.or.creating.files..A.reasona
2c20	62 6c 79 20 64 65 74 61 69 6c 65 64 20 64 65 73 63 72 69 70 74 69 6f 6e 20 6f 66 20 74 68 65 20	bly.detailed.description.of.the.
2c40	66 65 61 74 75 72 65 3a 20 77 68 61 74 20 69 74 20 69 73 2c 20 68 6f 77 20 69 74 27 73 20 73 75	feature:.what.it.is,.how.it's.su
2c60	70 70 6f 73 65 64 20 74 6f 20 77 6f 72 6b 2c 20 61 6e 64 20 68 6f 77 20 79 6f 75 27 64 20 75 73	pposed.to.work,.and.how.you'd.us
2c80	65 20 69 74 2e 20 54 68 65 20 6d 61 69 6e 74 61 69 6e 65 72 73 20 61 72 65 6e 27 74 20 66 61 6d	e.it..The.maintainers.aren't.fam
2ca0	69 6c 69 61 72 20 77 69 74 68 20 65 76 65 72 79 20 66 65 61 74 75 72 65 20 6f 66 20 65 76 65 72	iliar.with.every.feature.of.ever
2cc0	79 20 70 72 6f 74 6f 63 6f 6c 20 61 6e 64 20 74 6f 6f 6c 2c 20 61 6e 64 20 63 6f 6d 6d 75 6e 69	y.protocol.and.tool,.and.communi
2ce0	74 79 20 63 6f 6e 74 72 69 62 75 74 6f 72 73 20 77 68 6f 20 61 72 65 20 6c 6f 6f 6b 69 6e 67 20	ty.contributors.who.are.looking.
2d00	66 6f 72 20 74 61 73 6b 73 20 74 6f 20 77 6f 72 6b 20 6f 6e 20 77 69 6c 6c 20 61 6c 73 6f 20 61	for.tasks.to.work.on.will.also.a
2d20	70 70 72 65 63 69 61 74 65 20 6d 6f 72 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 74 68 61 74 20	ppreciate.more.information.that.
2d40	68 65 6c 70 73 20 74 68 65 6d 20 69 6d 70 6c 65 6d 65 6e 74 20 61 6e 64 20 74 65 73 74 20 61 20	helps.them.implement.and.test.a.
2d60	66 65 61 74 75 72 65 2e 00 41 20 73 65 71 75 65 6e 63 65 20 6f 66 20 61 63 74 69 6f 6e 73 20 74	feature..A.sequence.of.actions.t
2d80	68 61 74 20 74 72 69 67 67 65 72 73 20 74 68 65 20 62 75 67 2e 20 57 65 20 75 6e 64 65 72 73 74	hat.triggers.the.bug..We.underst
2da0	61 6e 64 20 74 68 61 74 20 69 74 27 73 20 6e 6f 74 20 61 6c 77 61 79 73 20 70 6f 73 73 69 62 6c	and.that.it's.not.always.possibl
2dc0	65 2c 20 62 75 74 20 69 74 20 6d 61 6b 65 73 20 64 65 76 65 6c 6f 70 65 72 27 73 20 6a 6f 62 20	e,.but.it.makes.developer's.job.
2de0	61 20 6c 6f 74 20 65 61 73 69 65 72 20 61 6e 64 20 61 6c 73 6f 20 61 6c 6c 6f 77 73 20 61 6e 79	a.lot.easier.and.also.allows.any
2e00	20 63 6f 6d 6d 75 6e 69 74 79 20 6d 65 6d 62 65 72 20 74 6f 20 69 6e 64 65 70 65 6e 64 65 6e 74	.community.member.to.independent
2e20	6c 79 20 63 6f 6e 66 69 72 6d 20 74 68 61 74 20 74 68 65 20 62 75 67 20 73 74 69 6c 6c 20 65 78	ly.confirm.that.the.bug.still.ex
2e40	69 73 74 73 20 6f 72 20 69 66 20 69 74 27 73 20 61 6c 72 65 61 64 79 20 66 69 78 65 64 2e 00 41	ists.or.if.it's.already.fixed..A
2e60	20 73 65 71 75 65 6e 63 65 20 6f 66 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 63 6f 6d 6d 61	.sequence.of.configuration.comma
2e80	6e 64 73 20 6f 72 20 61 20 63 6f 6d 70 6c 65 74 65 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20	nds.or.a.complete.configuration.
2ea0	66 69 6c 65 20 72 65 71 75 69 72 65 64 20 74 6f 20 72 65 63 72 65 61 74 65 20 61 20 73 65 74 75	file.required.to.recreate.a.setu
2ec0	70 20 77 68 65 72 65 20 74 68 65 20 62 75 67 20 6f 63 63 75 72 73 2e 20 50 6c 65 61 73 65 20 61	p.where.the.bug.occurs..Please.a
2ee0	76 6f 69 64 20 70 61 72 74 69 61 6c 20 63 6f 6e 66 69 67 73 3a 20 61 20 73 65 71 75 65 6e 63 65	void.partial.configs:.a.sequence
2f00	20 6f 66 20 63 6f 6d 6d 61 6e 64 73 20 69 73 20 65 61 73 79 20 74 6f 20 70 61 73 74 65 20 69 6e	.of.commands.is.easy.to.paste.in
2f20	74 6f 20 74 68 65 20 63 6f 6e 73 6f 6c 65 2c 20 61 20 63 6f 6d 70 6c 65 74 65 20 63 6f 6e 66 69	to.the.console,.a.complete.confi
2f40	67 20 69 73 20 65 61 73 79 20 74 6f 20 6c 6f 61 64 20 69 6e 20 61 20 56 4d 2c 20 62 75 74 20 61	g.is.easy.to.load.in.a.VM,.but.a
2f60	20 70 61 72 74 69 61 6c 20 63 6f 6e 66 69 67 20 69 73 20 6e 65 69 74 68 65 72 21 20 41 74 20 6c	.partial.config.is.neither!.At.l
2f80	65 61 73 74 20 6e 6f 74 20 75 6e 74 69 6c 20 77 65 20 69 6d 70 6c 65 6d 65 6e 74 20 61 20 22 6d	east.not.until.we.implement.a."m
2fa0	65 72 67 65 20 66 72 6f 6d 20 74 68 65 20 43 4c 49 22 20 66 65 61 74 75 72 65 20 74 68 61 74 20	erge.from.the.CLI".feature.that.
2fc0	61 6c 6c 6f 77 73 20 70 61 73 74 69 6e 67 20 63 6f 6e 66 69 67 20 66 69 6c 65 20 63 68 75 6e 6b	allows.pasting.config.file.chunk
2fe0	73 20 69 6e 74 6f 20 61 20 73 65 73 73 69 6f 6e 2e 00 41 20 73 69 6e 67 6c 65 2c 20 73 68 6f 72	s.into.a.session..A.single,.shor
3000	74 2c 20 73 75 6d 6d 61 72 79 20 6f 66 20 74 68 65 20 63 6f 6d 6d 69 74 20 28 72 65 63 6f 6d 6d	t,.summary.of.the.commit.(recomm
3020	65 6e 64 65 64 20 35 30 20 63 68 61 72 61 63 74 65 72 73 20 6f 72 20 6c 65 73 73 2c 20 6e 6f 74	ended.50.characters.or.less,.not
3040	20 65 78 63 65 65 64 69 6e 67 20 38 30 20 63 68 61 72 61 63 74 65 72 73 29 20 63 6f 6e 74 61 69	.exceeding.80.characters).contai
3060	6e 69 6e 67 20 61 20 70 72 65 66 69 78 20 6f 66 20 74 68 65 20 63 68 61 6e 67 65 64 20 63 6f 6d	ning.a.prefix.of.the.changed.com
3080	70 6f 6e 65 6e 74 20 61 6e 64 20 74 68 65 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 50 68 61	ponent.and.the.corresponding.Pha
30a0	62 72 69 63 61 74 6f 72 5f 20 72 65 66 65 72 65 6e 63 65 20 65 2e 67 2e 20 60 60 73 6e 6d 70 3a	bricator_.reference.e.g..``snmp:
30c0	20 54 31 31 31 31 3a 60 60 20 6f 72 20 60 60 65 74 68 65 72 6e 65 74 3a 20 54 32 32 32 32 3a 60	.T1111:``.or.``ethernet:.T2222:`
30e0	60 20 2d 20 6d 75 6c 74 69 70 6c 65 20 63 6f 6d 70 6f 6e 65 6e 74 73 20 63 6f 75 6c 64 20 62 65	`.-.multiple.components.could.be
3100	20 63 6f 6e 63 61 74 65 6e 61 74 65 64 20 61 73 20 69 6e 20 60 60 73 6e 6d 70 3a 20 65 74 68 65	.concatenated.as.in.``snmp:.ethe
3120	72 6e 65 74 3a 20 54 33 33 33 33 60 60 00 41 62 62 72 65 76 69 61 74 69 6f 6e 73 20 61 6e 64 20	rnet:.T3333``.Abbreviations.and.
3140	61 63 72 6f 6e 79 6d 73 20 2a 2a 6d 75 73 74 2a 2a 20 62 65 20 63 61 70 69 74 61 6c 69 7a 65 64	acronyms.**must**.be.capitalized
3160	2e 00 41 63 63 65 6c 2d 50 50 50 00 41 63 72 6f 6e 79 6d 73 20 61 6c 73 6f 20 2a 2a 6d 75 73 74	..Accel-PPP.Acronyms.also.**must
3180	2a 2a 20 62 65 20 63 61 70 69 74 61 6c 69 7a 65 64 20 74 6f 20 76 69 73 75 61 6c 6c 79 20 64 69	**.be.capitalized.to.visually.di
31a0	73 74 69 6e 67 75 69 73 68 20 74 68 65 6d 20 66 72 6f 6d 20 6e 6f 72 6d 61 6c 20 77 6f 72 64 73	stinguish.them.from.normal.words
31c0	3a 00 41 64 64 20 66 69 6c 65 20 74 6f 20 47 69 74 20 69 6e 64 65 78 20 75 73 69 6e 67 20 60 60	:.Add.file.to.Git.index.using.``
31e0	67 69 74 20 61 64 64 20 6d 79 66 69 6c 65 60 60 2c 20 6f 72 20 66 6f 72 20 61 20 77 68 6f 6c 65	git.add.myfile``,.or.for.a.whole
3200	20 64 69 72 65 63 74 6f 72 79 3a 20 60 60 67 69 74 20 61 64 64 20 73 6f 6d 65 64 69 72 2f 2a 60	.directory:.``git.add.somedir/*`
3220	60 00 41 64 64 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 49 50 20 61 64 64 72 65 73 73 65 73 00 41	`.Add.one.or.more.IP.addresses.A
3240	64 64 72 65 73 73 00 41 66 74 65 72 20 61 20 6d 69 6e 75 74 65 20 6f 72 20 74 77 6f 20 79 6f 75	ddress.After.a.minute.or.two.you
3260	20 77 69 6c 6c 20 66 69 6e 64 20 74 68 65 20 67 65 6e 65 72 61 74 65 64 20 44 45 42 20 70 61 63	.will.find.the.generated.DEB.pac
3280	6b 61 67 65 73 20 6e 65 78 74 20 74 6f 20 74 68 65 20 76 79 6f 73 2d 31 78 20 73 6f 75 72 63 65	kages.next.to.the.vyos-1x.source
32a0	20 64 69 72 65 63 74 6f 72 79 3a 00 41 66 74 65 72 20 63 6f 6d 70 69 6c 69 6e 67 20 74 68 65 20	.directory:.After.compiling.the.
32c0	70 61 63 6b 61 67 65 73 20 79 6f 75 20 77 69 6c 6c 20 66 69 6e 64 20 79 6f 75 72 73 65 6c 66 20	packages.you.will.find.yourself.
32e0	74 68 65 20 6e 65 77 6c 79 20 67 65 6e 65 72 61 74 65 64 20 60 2a 2e 64 65 62 60 20 62 69 6e 61	the.newly.generated.`*.deb`.bina
3300	72 69 65 73 20 69 6e 20 60 60 76 79 6f 73 2d 62 75 69 6c 64 2f 70 61 63 6b 61 67 65 73 2f 6c 69	ries.in.``vyos-build/packages/li
3320	6e 75 78 2d 6b 65 72 6e 65 6c 60 60 20 66 72 6f 6d 20 77 68 69 63 68 20 79 6f 75 20 63 61 6e 20	nux-kernel``.from.which.you.can.
3340	63 6f 70 79 20 74 68 65 6d 20 74 6f 20 74 68 65 20 60 60 76 79 6f 73 2d 62 75 69 6c 64 2f 70 61	copy.them.to.the.``vyos-build/pa
3360	63 6b 61 67 65 73 60 60 20 66 6f 6c 64 65 72 20 66 6f 72 20 69 6e 63 6c 75 73 69 6f 6e 20 64 75	ckages``.folder.for.inclusion.du
3380	72 69 6e 67 20 74 68 65 20 49 53 4f 20 62 75 69 6c 64 2e 00 41 66 74 65 72 20 69 74 73 20 66 69	ring.the.ISO.build..After.its.fi
33a0	72 73 74 20 62 6f 6f 74 20 69 6e 74 6f 20 74 68 65 20 6e 65 77 6c 79 20 69 6e 73 74 61 6c 6c 65	rst.boot.into.the.newly.installe
33c0	64 20 73 79 73 74 65 6d 20 74 68 65 20 6d 61 69 6e 20 53 6d 6f 6b 65 74 65 73 74 20 73 63 72 69	d.system.the.main.Smoketest.scri
33e0	70 74 20 69 73 20 65 78 65 63 75 74 65 64 2c 20 69 74 20 63 61 6e 20 62 65 20 66 6f 75 6e 64 20	pt.is.executed,.it.can.be.found.
3400	68 65 72 65 3a 20 60 2f 75 73 72 2f 62 69 6e 2f 76 79 6f 73 2d 73 6d 6f 6b 65 74 65 73 74 60 00	here:.`/usr/bin/vyos-smoketest`.
3420	41 6c 6c 20 56 79 4f 53 20 73 6f 75 72 63 65 20 63 6f 64 65 20 69 73 20 68 6f 73 74 65 64 20 6f	All.VyOS.source.code.is.hosted.o
3440	6e 20 47 69 74 48 75 62 20 75 6e 64 65 72 20 74 68 65 20 56 79 4f 53 20 6f 72 67 61 6e 69 7a 61	n.GitHub.under.the.VyOS.organiza
3460	74 69 6f 6e 20 77 68 69 63 68 20 63 61 6e 20 62 65 20 66 6f 75 6e 64 20 68 65 72 65 3a 20 68 74	tion.which.can.be.found.here:.ht
3480	74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 76 79 6f 73 00 41 6c 6c 20 63 6f 6d 6d 69 74	tps://github.com/vyos.All.commit
34a0	20 74 69 6d 65 20 63 68 65 63 6b 73 20 73 68 6f 75 6c 64 20 62 65 20 69 6e 20 74 68 65 20 76 65	.time.checks.should.be.in.the.ve
34c0	72 69 66 79 28 29 20 66 75 6e 63 74 69 6f 6e 20 6f 66 20 74 68 65 20 73 63 72 69 70 74 00 41 6c	rify().function.of.the.script.Al
34e0	6c 20 69 6e 74 65 72 66 61 63 65 20 64 65 66 69 6e 69 74 69 6f 6e 20 58 4d 4c 20 69 6e 70 75 74	l.interface.definition.XML.input
3500	20 66 69 6c 65 73 20 28 2e 69 6e 20 73 75 66 66 69 78 29 20 77 69 6c 6c 20 62 65 20 73 65 6e 74	.files.(.in.suffix).will.be.sent
3520	20 74 6f 20 74 68 65 20 47 43 43 20 70 72 65 70 72 6f 63 65 73 73 20 61 6e 64 20 74 68 65 20 6f	.to.the.GCC.preprocess.and.the.o
3540	75 74 70 75 74 20 69 73 20 73 74 6f 72 65 64 20 69 6e 20 74 68 65 20 60 62 75 69 6c 64 2f 69 6e	utput.is.stored.in.the.`build/in
3560	74 65 72 66 61 63 65 2d 64 65 66 69 6e 69 74 69 6f 6e 73 60 20 66 6f 6c 64 65 72 2e 20 54 68 65	terface-definitions`.folder..The
3580	20 70 72 65 76 69 6f 75 73 6c 79 20 6d 65 6e 74 69 6f 6e 65 64 20 60 73 63 72 69 70 74 73 2f 62	.previously.mentioned.`scripts/b
35a0	75 69 6c 64 2d 63 6f 6d 6d 61 6e 64 2d 74 65 6d 70 6c 61 74 65 73 60 20 73 63 72 69 70 74 20 6f	uild-command-templates`.script.o
35c0	70 65 72 61 74 65 73 20 6f 6e 20 74 68 65 20 60 62 75 69 6c 64 2f 69 6e 74 65 72 66 61 63 65 2d	perates.on.the.`build/interface-
35e0	64 65 66 69 6e 69 74 69 6f 6e 73 60 20 66 6f 6c 64 65 72 20 74 6f 20 67 65 6e 65 72 61 74 65 20	definitions`.folder.to.generate.
3600	61 6c 6c 20 72 65 71 75 69 72 65 64 20 43 4c 49 20 6e 6f 64 65 73 2e 00 41 6c 6c 20 69 73 73 75	all.required.CLI.nodes..All.issu
3620	65 73 20 73 68 6f 75 6c 64 20 62 65 20 72 65 70 6f 72 74 65 64 20 74 6f 20 74 68 65 20 64 65 76	es.should.be.reported.to.the.dev
3640	65 6c 6f 70 65 72 73 2e 20 54 68 69 73 20 6c 65 74 73 20 74 68 65 20 64 65 76 65 6c 6f 70 65 72	elopers..This.lets.the.developer
3660	73 20 6b 6e 6f 77 20 77 68 61 74 20 69 73 20 6e 6f 74 20 77 6f 72 6b 69 6e 67 20 70 72 6f 70 65	s.know.what.is.not.working.prope
3680	72 6c 79 2e 20 57 69 74 68 6f 75 74 20 74 68 69 73 20 73 6f 72 74 20 6f 66 20 66 65 65 64 62 61	rly..Without.this.sort.of.feedba
36a0	63 6b 20 65 76 65 72 79 20 64 65 76 65 6c 6f 70 65 72 20 77 69 6c 6c 20 62 65 6c 69 65 76 65 20	ck.every.developer.will.believe.
36c0	74 68 61 74 20 65 76 65 72 79 74 68 69 6e 67 20 69 73 20 77 6f 72 6b 69 6e 67 20 63 6f 72 72 65	that.everything.is.working.corre
36e0	63 74 6c 79 2e 00 41 6c 6c 20 6c 6f 67 69 63 20 73 68 6f 75 6c 64 20 62 65 20 69 6e 20 74 68 65	ctly..All.logic.should.be.in.the
3700	20 73 63 72 69 70 74 73 00 41 6c 6c 20 74 65 78 74 20 6f 66 20 74 68 65 20 63 6f 6d 6d 69 74 20	.scripts.All.text.of.the.commit.
3720	6d 65 73 73 61 67 65 20 73 68 6f 75 6c 64 20 62 65 20 77 72 61 70 70 65 64 20 61 74 20 37 32 20	message.should.be.wrapped.at.72.
3740	63 68 61 72 61 63 74 65 72 73 20 69 66 20 70 6f 73 73 69 62 6c 65 20 77 68 69 63 68 20 6d 61 6b	characters.if.possible.which.mak
3760	65 73 20 72 65 61 64 69 6e 67 20 63 6f 6d 6d 69 74 20 6c 6f 67 73 20 65 61 73 69 65 72 20 77 69	es.reading.commit.logs.easier.wi
3780	74 68 20 60 60 67 69 74 20 6c 6f 67 60 60 20 6f 6e 20 61 20 73 74 61 6e 64 61 72 64 20 74 65 72	th.``git.log``.on.a.standard.ter
37a0	6d 69 6e 61 6c 20 28 77 68 69 63 68 20 68 61 70 70 65 6e 73 20 74 6f 20 62 65 20 38 30 78 32 35	minal.(which.happens.to.be.80x25
37c0	29 00 41 6c 77 61 79 73 20 75 73 65 20 74 68 65 20 60 60 2d 78 60 60 20 6f 70 74 69 6f 6e 20 74	).Always.use.the.``-x``.option.t
37e0	6f 20 74 68 65 20 60 60 67 69 74 20 63 68 65 72 72 79 2d 70 69 63 6b 60 60 20 63 6f 6d 6d 61 6e	o.the.``git.cherry-pick``.comman
3800	64 20 77 68 65 6e 20 62 61 63 6b 20 6f 72 20 66 6f 72 77 61 72 64 20 70 6f 72 74 69 6e 67 20 61	d.when.back.or.forward.porting.a
3820	6e 20 69 6e 64 69 76 69 64 75 61 6c 20 63 6f 6d 6d 69 74 2e 20 54 68 69 73 20 61 75 74 6f 6d 61	n.individual.commit..This.automa
3840	74 69 63 61 6c 6c 79 20 61 70 70 65 6e 64 73 20 74 68 65 20 6c 69 6e 65 3a 20 60 60 28 63 68 65	tically.appends.the.line:.``(che
3860	72 72 79 20 70 69 63 6b 65 64 20 66 72 6f 6d 20 63 6f 6d 6d 69 74 20 3c 49 44 3e 29 60 60 20 74	rry.picked.from.commit.<ID>)``.t
3880	6f 20 74 68 65 20 6f 72 69 67 69 6e 61 6c 20 61 75 74 68 6f 72 73 20 63 6f 6d 6d 69 74 20 6d 65	o.the.original.authors.commit.me
38a0	73 73 61 67 65 20 6d 61 6b 69 6e 67 20 69 74 20 65 61 73 69 65 72 20 77 68 65 6e 20 62 69 73 65	ssage.making.it.easier.when.bise
38c0	63 74 69 6e 67 20 70 72 6f 62 6c 65 6d 73 2e 00 41 6e 6f 74 68 65 72 20 61 64 76 61 6e 74 61 67	cting.problems..Another.advantag
38e0	65 20 69 73 20 74 65 73 74 61 62 69 6c 69 74 79 20 6f 66 20 74 68 65 20 63 6f 64 65 2e 20 4d 6f	e.is.testability.of.the.code..Mo
3900	63 6b 69 6e 67 20 74 68 65 20 65 6e 74 69 72 65 20 63 6f 6e 66 69 67 20 73 75 62 73 79 73 74 65	cking.the.entire.config.subsyste
3920	6d 20 69 73 20 68 61 72 64 2c 20 77 68 69 6c 65 20 63 6f 6e 73 74 72 75 63 74 69 6e 67 20 61 6e	m.is.hard,.while.constructing.an
3940	20 69 6e 74 65 72 6e 61 6c 20 72 65 70 72 65 73 65 6e 74 61 74 69 6f 6e 20 62 79 20 68 61 6e 64	.internal.representation.by.hand
3960	20 69 73 20 77 61 79 20 73 69 6d 70 6c 65 72 2e 00 41 6e 79 20 22 6d 6f 64 69 66 69 65 64 22 20	.is.way.simpler..Any."modified".
3980	70 61 63 6b 61 67 65 20 6d 61 79 20 72 65 66 65 72 20 74 6f 20 61 6e 20 61 6c 74 65 72 65 64 20	package.may.refer.to.an.altered.
39a0	76 65 72 73 69 6f 6e 20 6f 66 20 65 2e 67 2e 20 76 79 6f 73 2d 31 78 20 70 61 63 6b 61 67 65 20	version.of.e.g..vyos-1x.package.
39c0	74 68 61 74 20 79 6f 75 20 77 6f 75 6c 64 20 6c 69 6b 65 20 74 6f 20 74 65 73 74 20 62 65 66 6f	that.you.would.like.to.test.befo
39e0	72 65 20 66 69 6c 69 6e 67 20 61 20 70 75 6c 6c 20 72 65 71 75 65 73 74 20 6f 6e 20 47 69 74 48	re.filing.a.pull.request.on.GitH
3a00	75 62 2e 00 41 6e 79 20 70 61 63 6b 61 67 65 73 20 69 6e 20 74 68 65 20 70 61 63 6b 61 67 65 73	ub..Any.packages.in.the.packages
3a20	20 64 69 72 65 63 74 6f 72 79 20 77 69 6c 6c 20 62 65 20 61 64 64 65 64 20 74 6f 20 74 68 65 20	.directory.will.be.added.to.the.
3a40	69 73 6f 20 64 75 72 69 6e 67 20 62 75 69 6c 64 2c 20 72 65 70 6c 61 63 69 6e 67 20 74 68 65 20	iso.during.build,.replacing.the.
3a60	75 70 73 74 72 65 61 6d 20 6f 6e 65 73 2e 20 4d 61 6b 65 20 73 75 72 65 20 79 6f 75 20 64 65 6c	upstream.ones..Make.sure.you.del
3a80	65 74 65 20 74 68 65 6d 20 28 62 6f 74 68 20 74 68 65 20 73 6f 75 72 63 65 20 64 69 72 65 63 74	ete.them.(both.the.source.direct
3aa0	6f 72 69 65 73 20 61 6e 64 20 62 75 69 6c 74 20 64 65 62 20 70 61 63 6b 61 67 65 73 29 20 69 66	ories.and.built.deb.packages).if
3ac0	20 79 6f 75 20 77 61 6e 74 20 74 6f 20 62 75 69 6c 64 20 61 6e 20 69 73 6f 20 66 72 6f 6d 20 70	.you.want.to.build.an.iso.from.p
3ae0	75 72 65 6c 79 20 75 70 73 74 72 65 61 6d 20 70 61 63 6b 61 67 65 73 2e 00 41 72 65 20 74 68 65	urely.upstream.packages..Are.the
3b00	72 65 20 61 6e 79 20 61 64 76 65 72 73 65 20 6f 72 20 6e 6f 6e 2d 6f 62 76 69 6f 75 73 20 69 6e	re.any.adverse.or.non-obvious.in
3b20	74 65 72 61 63 74 69 6f 6e 73 20 77 69 74 68 20 6f 74 68 65 72 20 66 65 61 74 75 72 65 73 3f 20	teractions.with.other.features?.
3b40	53 68 6f 75 6c 64 20 69 74 20 62 65 20 6d 75 74 75 61 6c 6c 79 20 65 78 63 6c 75 73 69 76 65 20	Should.it.be.mutually.exclusive.
3b60	77 69 74 68 20 61 6e 79 74 68 69 6e 67 3f 00 41 72 65 20 74 68 65 72 65 20 61 6e 79 20 6c 69 6d	with.anything?.Are.there.any.lim
3b80	69 74 61 74 69 6f 6e 73 20 28 68 61 72 64 77 61 72 65 20 73 75 70 70 6f 72 74 2c 20 72 65 73 6f	itations.(hardware.support,.reso
3ba0	75 72 63 65 20 75 73 61 67 65 29 3f 00 41 73 20 53 6d 6f 6b 65 74 65 73 74 73 20 77 69 6c 6c 20	urce.usage)?.As.Smoketests.will.
3bc0	61 6c 74 65 72 20 74 68 65 20 73 79 73 74 65 6d 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 61	alter.the.system.configuration.a
3be0	6e 64 20 79 6f 75 20 61 72 65 20 6c 6f 67 67 65 64 20 69 6e 20 72 65 6d 6f 74 65 20 79 6f 75 20	nd.you.are.logged.in.remote.you.
3c00	6d 61 79 20 6c 6f 6f 73 65 20 79 6f 75 72 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 74 6f 20 74 68 65	may.loose.your.connection.to.the
3c20	20 73 79 73 74 65 6d 2e 00 41 73 20 74 68 65 20 56 79 4f 53 20 64 6f 63 75 6d 65 6e 74 61 74 69	.system..As.the.VyOS.documentati
3c40	6f 6e 20 69 73 20 6e 6f 74 20 6f 6e 6c 79 20 66 6f 72 20 75 73 65 72 73 20 62 75 74 20 61 6c 73	on.is.not.only.for.users.but.als
3c60	6f 20 66 6f 72 20 74 68 65 20 64 65 76 65 6c 6f 70 65 72 73 20 2d 20 61 6e 64 20 77 65 20 6b 65	o.for.the.developers.-.and.we.ke
3c80	65 70 20 6e 6f 20 73 65 63 72 65 74 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 2d 20 74 68 69	ep.no.secret.documentation.-.thi
3ca0	73 20 73 65 63 74 69 6f 6e 20 64 65 73 63 72 69 62 65 73 20 68 6f 77 20 74 68 65 20 61 75 74 6f	s.section.describes.how.the.auto
3cc0	6d 61 74 65 64 20 74 65 73 74 69 6e 67 20 77 6f 72 6b 73 2e 00 41 73 73 75 6d 65 20 77 65 20 77	mated.testing.works..Assume.we.w
3ce0	61 6e 74 20 74 6f 20 62 75 69 6c 64 20 74 68 65 20 76 79 6f 73 2d 31 78 20 70 61 63 6b 61 67 65	ant.to.build.the.vyos-1x.package
3d00	20 6f 6e 20 6f 75 72 20 6f 77 6e 20 61 6e 64 20 6d 6f 64 69 66 79 20 69 74 20 74 6f 20 6f 75 72	.on.our.own.and.modify.it.to.our
3d20	20 6e 65 65 64 73 2e 20 57 65 20 66 69 72 73 74 20 6e 65 65 64 20 74 6f 20 63 6c 6f 6e 65 20 74	.needs..We.first.need.to.clone.t
3d40	68 65 20 72 65 70 6f 73 69 74 6f 72 79 20 66 72 6f 6d 20 47 69 74 48 75 62 2e 00 41 74 74 61 63	he.repository.from.GitHub..Attac
3d60	68 20 70 61 74 63 68 20 74 6f 20 50 68 61 62 72 69 63 61 74 6f 72 20 74 61 73 6b 00 42 61 64 3a	h.patch.to.Phabricator.task.Bad:
3d80	20 22 44 69 73 61 62 6c 65 73 20 49 50 76 36 20 66 6f 72 77 61 72 64 69 6e 67 22 00 42 61 64 3a	."Disables.IPv6.forwarding".Bad:
3da0	20 22 46 72 6f 62 6e 69 63 61 74 69 6f 6e 20 61 6c 67 6f 72 69 74 68 6d 2e 22 00 42 61 64 3a 20	."Frobnication.algorithm.".Bad:.
3dc0	22 53 65 74 20 54 43 50 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 74 69 6d 65 6f 75 74 22 00 42 61 64	"Set.TCP.connection.timeout".Bad
3de0	3a 20 22 66 72 6f 62 6e 69 63 61 74 69 6f 6e 20 61 6c 67 6f 72 69 74 68 6d 22 00 42 61 64 3a 20	:."frobnication.algorithm".Bad:.
3e00	22 74 63 70 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 74 69 6d 65 6f 75 74 22 00 42 61 64 3a 20 50 50	"tcp.connection.timeout".Bad:.PP
3e20	50 4f 45 2c 20 49 50 53 45 43 00 42 61 64 3a 20 70 70 70 6f 65 2c 20 69 70 73 65 63 00 42 61 64	POE,.IPSEC.Bad:.pppoe,.ipsec.Bad
3e40	3a 20 72 61 64 69 75 73 20 28 75 6e 6c 65 73 73 20 69 74 27 73 20 61 62 6f 75 74 20 74 68 65 20	:.radius.(unless.it's.about.the.
3e60	64 69 73 74 61 6e 63 65 20 62 65 74 77 65 65 6e 20 61 20 63 65 6e 74 65 72 20 6f 66 20 61 20 63	distance.between.a.center.of.a.c
3e80	69 72 63 6c 65 20 61 6e 64 20 61 6e 79 20 6f 66 20 69 74 73 20 70 6f 69 6e 74 73 29 00 42 65 65	ircle.and.any.of.its.points).Bee
3ea0	69 6e 67 20 62 72 61 76 65 20 61 6e 64 20 72 75 6e 6e 69 6e 67 20 74 68 65 20 6c 61 74 65 73 74	ing.brave.and.running.the.latest
3ec0	20 72 6f 6c 6c 69 6e 67 20 72 65 6c 65 61 73 65 73 20 77 69 6c 6c 20 73 6f 6d 65 74 69 6d 65 73	.rolling.releases.will.sometimes
3ee0	20 74 72 69 67 67 65 72 20 62 75 67 73 20 64 75 65 20 74 6f 20 63 6f 72 6e 65 72 20 63 61 73 65	.trigger.bugs.due.to.corner.case
3f00	73 20 77 65 20 6d 69 73 73 65 64 20 69 6e 20 6f 75 72 20 64 65 73 69 67 6e 2e 20 54 68 6f 73 65	s.we.missed.in.our.design..Those
3f20	20 62 75 67 73 20 73 68 6f 75 6c 64 20 62 65 20 66 69 6c 65 64 20 76 69 61 20 50 68 61 62 72 69	.bugs.should.be.filed.via.Phabri
3f40	63 61 74 6f 72 5f 20 62 75 74 20 79 6f 75 20 63 61 6e 20 68 65 6c 70 20 75 73 20 74 6f 20 6e 61	cator_.but.you.can.help.us.to.na
3f60	72 72 6f 77 20 64 6f 65 6e 20 74 68 65 20 69 73 73 75 65 2e 20 4c 6f 67 69 6e 20 74 6f 20 79 6f	rrow.doen.the.issue..Login.to.yo
3f80	75 72 20 56 79 4f 53 20 73 79 73 74 65 6d 20 61 6e 64 20 63 68 61 6e 67 65 20 69 6e 74 6f 20 63	ur.VyOS.system.and.change.into.c
3fa0	6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 6d 6f 64 65 20 62 79 20 74 79 70 69 6e 67 20 60 60 63 6f	onfiguration.mode.by.typing.``co
3fc0	6e 66 69 67 75 72 65 60 60 2e 20 4e 6f 77 20 72 65 2d 6c 6f 61 64 20 79 6f 75 72 20 62 6f 6f 74	nfigure``..Now.re-load.your.boot
3fe0	20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 62 79 20 73 69 6d 70 6c 79 20 74 79 70 69 6e 67 20	.configuration.by.simply.typing.
4000	60 60 6c 6f 61 64 60 60 20 66 6f 6c 6c 6f 77 65 64 20 62 79 20 72 65 74 75 72 6e 2e 00 42 65 69	``load``.followed.by.return..Bei
4020	6e 67 20 62 72 61 76 65 20 61 6e 64 20 72 75 6e 6e 69 6e 67 20 74 68 65 20 6c 61 74 65 73 74 20	ng.brave.and.running.the.latest.
4040	72 6f 6c 6c 69 6e 67 20 72 65 6c 65 61 73 65 73 20 77 69 6c 6c 20 73 6f 6d 65 74 69 6d 65 73 20	rolling.releases.will.sometimes.
4060	74 72 69 67 67 65 72 20 62 75 67 73 20 64 75 65 20 74 6f 20 63 6f 72 6e 65 72 20 63 61 73 65 73	trigger.bugs.due.to.corner.cases
4080	20 77 65 20 6d 69 73 73 65 64 20 69 6e 20 6f 75 72 20 64 65 73 69 67 6e 2e 20 54 68 6f 73 65 20	.we.missed.in.our.design..Those.
40a0	62 75 67 73 20 73 68 6f 75 6c 64 20 62 65 20 66 69 6c 65 64 20 76 69 61 20 50 68 61 62 72 69 63	bugs.should.be.filed.via.Phabric
40c0	61 74 6f 72 5f 20 62 75 74 20 79 6f 75 20 63 61 6e 20 68 65 6c 70 20 75 73 20 74 6f 20 6e 61 72	ator_.but.you.can.help.us.to.nar
40e0	72 6f 77 20 64 6f 77 6e 20 74 68 65 20 69 73 73 75 65 2e 20 4c 6f 67 69 6e 20 74 6f 20 79 6f 75	row.down.the.issue..Login.to.you
4100	72 20 56 79 4f 53 20 73 79 73 74 65 6d 20 61 6e 64 20 63 68 61 6e 67 65 20 69 6e 74 6f 20 63 6f	r.VyOS.system.and.change.into.co
4120	6e 66 69 67 75 72 61 74 69 6f 6e 20 6d 6f 64 65 20 62 79 20 74 79 70 69 6e 67 20 60 60 63 6f 6e	nfiguration.mode.by.typing.``con
4140	66 69 67 75 72 65 60 60 2e 20 4e 6f 77 20 72 65 2d 6c 6f 61 64 20 79 6f 75 72 20 62 6f 6f 74 20	figure``..Now.re-load.your.boot.
4160	63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 62 79 20 73 69 6d 70 6c 79 20 74 79 70 69 6e 67 20 60	configuration.by.simply.typing.`
4180	60 6c 6f 61 64 60 60 20 66 6f 6c 6c 6f 77 65 64 20 62 79 20 72 65 74 75 72 6e 2e 00 42 6f 6f 74	`load``.followed.by.return..Boot
41a0	20 54 69 6d 69 6e 67 00 42 75 67 20 52 65 70 6f 72 74 2f 49 73 73 75 65 00 42 75 67 20 72 65 70	.Timing.Bug.Report/Issue.Bug.rep
41c0	6f 72 74 73 20 74 68 61 74 20 6c 61 63 6b 20 72 65 70 72 6f 64 75 63 69 6e 67 20 70 72 6f 63 65	orts.that.lack.reproducing.proce
41e0	64 75 72 65 73 2e 00 42 75 69 6c 64 00 42 75 69 6c 64 20 43 6f 6e 74 61 69 6e 65 72 00 42 75 69	dures..Build.Build.Container.Bui
4200	6c 64 20 49 53 4f 00 42 75 69 6c 64 20 56 79 4f 53 00 42 75 69 6c 64 20 66 72 6f 6d 20 73 6f 75	ld.ISO.Build.VyOS.Build.from.sou
4220	72 63 65 00 42 75 69 6c 64 69 6e 67 20 4f 75 74 2d 4f 66 2d 54 72 65 65 20 4d 6f 64 75 6c 65 73	rce.Building.Out-Of-Tree.Modules
4240	00 42 75 69 6c 64 69 6e 67 20 54 68 65 20 4b 65 72 6e 65 6c 00 42 75 69 6c 64 69 6e 67 20 56 79	.Building.The.Kernel.Building.Vy
4260	4f 53 20 6f 6e 20 57 69 6e 64 6f 77 73 20 57 53 4c 32 20 77 69 74 68 20 44 6f 63 6b 65 72 20 69	OS.on.Windows.WSL2.with.Docker.i
4280	6e 74 65 67 72 61 74 65 64 20 69 6e 74 6f 20 57 53 4c 32 20 77 69 6c 6c 20 77 6f 72 6b 20 6c 69	ntegrated.into.WSL2.will.work.li
42a0	6b 65 20 61 20 63 68 61 72 6d 2e 20 4e 6f 20 70 72 6f 62 6c 65 6d 73 20 61 72 65 20 6b 6e 6f 77	ke.a.charm..No.problems.are.know
42c0	6e 20 73 6f 20 66 61 72 21 00 42 75 69 6c 64 69 6e 67 20 61 6e 20 49 53 4f 20 77 69 74 68 20 61	n.so.far!.Building.an.ISO.with.a
42e0	6e 79 20 63 75 73 74 6f 6d 69 7a 65 64 20 70 61 63 6b 61 67 65 20 69 73 20 69 6e 20 6e 6f 20 77	ny.customized.package.is.in.no.w
4300	61 79 20 64 69 66 66 65 72 65 6e 74 20 74 68 61 6e 20 62 75 69 6c 64 69 6e 67 20 61 20 72 65 67	ay.different.than.building.a.reg
4320	75 6c 61 72 20 28 63 75 73 74 6f 6d 69 7a 65 64 20 6f 72 20 6e 6f 74 29 20 49 53 4f 20 69 6d 61	ular.(customized.or.not).ISO.ima
4340	67 65 2e 20 53 69 6d 70 6c 79 20 70 6c 61 63 65 20 79 6f 75 72 20 6d 6f 64 69 66 69 65 64 20 60	ge..Simply.place.your.modified.`
4360	2a 2e 64 65 62 60 20 70 61 63 6b 61 67 65 20 69 6e 73 69 64 65 20 74 68 65 20 60 70 61 63 6b 61	*.deb`.package.inside.the.`packa
4380	67 65 73 60 20 66 6f 6c 64 65 72 20 77 69 74 68 69 6e 20 60 76 79 6f 73 2d 62 75 69 6c 64 60 2e	ges`.folder.within.`vyos-build`.
43a0	20 54 68 65 20 62 75 69 6c 64 20 70 72 6f 63 65 73 73 20 77 69 6c 6c 20 74 68 65 6e 20 70 69 63	.The.build.process.will.then.pic
43c0	6b 75 70 20 79 6f 75 72 20 63 75 73 74 6f 6d 20 70 61 63 6b 61 67 65 20 61 6e 64 20 69 6e 74 65	kup.your.custom.package.and.inte
43e0	67 72 61 74 65 20 69 74 20 69 6e 74 6f 20 79 6f 75 72 20 49 53 4f 2e 00 42 75 69 6c 64 69 6e 67	grate.it.into.your.ISO..Building
4400	20 74 68 65 20 6b 65 72 6e 65 6c 20 69 73 20 6f 6e 65 20 70 61 72 74 2c 20 62 75 74 20 6e 6f 77	.the.kernel.is.one.part,.but.now
4420	20 79 6f 75 20 61 6c 73 6f 20 6e 65 65 64 20 74 6f 20 62 75 69 6c 64 20 74 68 65 20 72 65 71 75	.you.also.need.to.build.the.requ
4440	69 72 65 64 20 6f 75 74 2d 6f 66 2d 74 72 65 65 20 6d 6f 64 75 6c 65 73 20 73 6f 20 65 76 65 72	ired.out-of-tree.modules.so.ever
4460	79 74 68 69 6e 67 20 69 73 20 6c 69 6e 65 64 20 75 70 20 61 6e 64 20 74 68 65 20 41 42 49 73 20	ything.is.lined.up.and.the.ABIs.
4480	6d 61 74 63 68 2e 20 54 6f 20 64 6f 20 73 6f 2c 20 79 6f 75 20 63 61 6e 20 61 67 61 69 6e 20 74	match..To.do.so,.you.can.again.t
44a0	61 6b 65 20 61 20 6c 6f 6f 6b 20 61 74 20 60 60 76 79 6f 73 2d 62 75 69 6c 64 2f 70 61 63 6b 61	ake.a.look.at.``vyos-build/packa
44c0	67 65 73 2f 6c 69 6e 75 78 2d 6b 65 72 6e 65 6c 2f 4a 65 6e 6b 69 6e 73 66 69 6c 65 60 60 20 74	ges/linux-kernel/Jenkinsfile``.t
44e0	6f 20 73 65 65 20 61 6c 6c 20 6f 66 20 74 68 65 20 72 65 71 75 69 72 65 64 20 6d 6f 64 75 6c 65	o.see.all.of.the.required.module
4500	73 20 61 6e 64 20 74 68 65 69 72 20 73 65 6c 65 63 74 65 64 20 76 65 72 73 69 6f 6e 73 2e 20 57	s.and.their.selected.versions..W
4520	65 20 77 69 6c 6c 20 73 68 6f 77 20 79 6f 75 20 68 6f 77 20 74 6f 20 62 75 69 6c 64 20 61 6c 6c	e.will.show.you.how.to.build.all
4540	20 74 68 65 20 63 75 72 72 65 6e 74 20 72 65 71 75 69 72 65 64 20 6d 6f 64 75 6c 65 73 2e 00 42	.the.current.required.modules..B
4560	75 69 6c 64 69 6e 67 20 74 68 65 20 6b 65 72 6e 65 6c 20 77 69 6c 6c 20 74 61 6b 65 20 73 6f 6d	uilding.the.kernel.will.take.som
4580	65 20 74 69 6d 65 20 64 65 70 65 6e 64 69 6e 67 20 6f 6e 20 74 68 65 20 73 70 65 65 64 20 61 6e	e.time.depending.on.the.speed.an
45a0	64 20 71 75 61 6e 74 69 74 79 20 6f 66 20 79 6f 75 72 20 43 50 55 2f 63 6f 72 65 73 20 61 6e 64	d.quantity.of.your.CPU/cores.and
45c0	20 64 69 73 6b 20 73 70 65 65 64 2e 20 45 78 70 65 63 74 20 32 30 20 6d 69 6e 75 74 65 73 20 28	.disk.speed..Expect.20.minutes.(
45e0	6f 72 20 65 76 65 6e 20 6c 6f 6e 67 65 72 29 20 6f 6e 20 6c 6f 77 65 72 20 65 6e 64 20 68 61 72	or.even.longer).on.lower.end.har
4600	64 77 61 72 65 2e 00 42 75 69 6c 64 69 6e 67 20 75 73 69 6e 67 20 61 20 3a 72 65 66 3a 60 62 75	dware..Building.using.a.:ref:`bu
4620	69 6c 64 5f 64 6f 63 6b 65 72 60 20 63 6f 6e 74 61 69 6e 65 72 2c 20 61 6c 74 68 6f 75 67 68 20	ild_docker`.container,.although.
4640	6e 6f 74 20 74 68 65 20 6f 6e 6c 79 20 77 61 79 2c 20 69 73 20 74 68 65 20 65 61 73 69 65 73 74	not.the.only.way,.is.the.easiest
4660	20 77 61 79 20 61 73 20 61 6c 6c 20 64 65 70 65 6e 64 65 6e 63 69 65 73 20 61 72 65 20 6d 61 6e	.way.as.all.dependencies.are.man
4680	61 67 65 64 20 66 6f 72 20 79 6f 75 2e 20 48 6f 77 65 76 65 72 2c 20 79 6f 75 20 63 61 6e 20 61	aged.for.you..However,.you.can.a
46a0	6c 73 6f 20 73 65 74 20 75 70 20 79 6f 75 72 20 6f 77 6e 20 62 75 69 6c 64 20 6d 61 63 68 69 6e	lso.set.up.your.own.build.machin
46c0	65 20 61 6e 64 20 72 75 6e 20 61 20 3a 72 65 66 3a 60 62 75 69 6c 64 5f 6e 61 74 69 76 65 60 2e	e.and.run.a.:ref:`build_native`.
46e0	00 42 75 74 20 77 65 20 61 72 65 20 68 65 72 65 20 74 6f 20 61 73 73 69 73 74 20 79 6f 75 20 61	.But.we.are.here.to.assist.you.a
4700	6e 64 20 77 61 6e 74 20 74 6f 20 67 75 69 64 65 20 79 6f 75 20 74 68 72 6f 75 67 68 20 68 6f 77	nd.want.to.guide.you.through.how
4720	20 79 6f 75 20 63 61 6e 20 62 65 63 6f 6d 65 20 61 20 67 6f 6f 64 20 56 79 4f 53 20 63 6f 6e 74	.you.can.become.a.good.VyOS.cont
4740	72 69 62 75 74 6f 72 2e 20 54 68 65 20 72 75 6c 65 73 20 77 65 20 68 61 76 65 20 61 72 65 20 6e	ributor..The.rules.we.have.are.n
4760	6f 74 20 74 68 65 72 65 20 74 6f 20 70 75 6e 69 73 68 20 79 6f 75 20 2d 20 74 68 65 20 72 75 6c	ot.there.to.punish.you.-.the.rul
4780	65 73 20 61 72 65 20 69 6e 20 70 6c 61 63 65 20 74 6f 20 68 65 6c 70 20 75 73 20 61 6c 6c 2e 20	es.are.in.place.to.help.us.all..
47a0	57 68 61 74 20 64 6f 65 73 20 69 74 20 6d 65 61 6e 3f 20 42 79 20 68 61 76 69 6e 67 20 61 20 63	What.does.it.mean?.By.having.a.c
47c0	6f 6e 73 69 73 74 65 6e 74 20 63 6f 64 69 6e 67 20 73 74 79 6c 65 20 69 74 20 62 65 63 6f 6d 65	onsistent.coding.style.it.become
47e0	73 20 76 65 72 79 20 65 61 73 79 20 66 6f 72 20 6e 65 77 20 63 6f 6e 74 72 69 62 75 74 6f 72 73	s.very.easy.for.new.contributors
4800	20 61 6e 64 20 61 6c 73 6f 20 6c 6f 6e 67 74 69 6d 65 20 63 6f 6e 74 72 69 62 75 74 6f 72 73 20	.and.also.longtime.contributors.
4820	74 6f 20 6e 61 76 69 67 61 74 65 20 74 68 72 6f 75 67 68 20 74 68 65 20 73 6f 75 72 63 65 73 20	to.navigate.through.the.sources.
4840	61 6e 64 20 61 6c 6c 20 74 68 65 20 69 6d 70 6c 69 65 64 20 6c 6f 67 69 63 20 6f 66 20 74 68 65	and.all.the.implied.logic.of.the
4860	20 73 70 61 67 68 65 74 74 69 20 63 6f 64 65 2e 00 43 2b 2b 20 42 61 63 6b 65 6e 64 20 43 6f 64	.spaghetti.code..C++.Backend.Cod
4880	65 00 43 61 70 69 74 61 6c 69 7a 61 74 69 6f 6e 20 61 6e 64 20 70 75 6e 63 74 75 61 74 69 6f 6e	e.Capitalization.and.punctuation
48a0	00 43 68 65 63 6b 20 6f 75 74 20 74 68 65 20 72 65 71 75 69 72 65 64 20 6b 65 72 6e 65 6c 20 76	.Check.out.the.required.kernel.v
48c0	65 72 73 69 6f 6e 20 2d 20 73 65 65 20 60 60 76 79 6f 73 2d 62 75 69 6c 64 2f 64 61 74 61 2f 64	ersion.-.see.``vyos-build/data/d
48e0	65 66 61 75 6c 74 73 2e 6a 73 6f 6e 60 60 20 66 69 6c 65 20 28 65 78 61 6d 70 6c 65 20 75 73 65	efaults.json``.file.(example.use
4900	73 20 6b 65 72 6e 65 6c 20 34 2e 31 39 2e 31 34 36 29 3a 00 43 6c 6f 6e 65 20 74 68 65 20 6b 65	s.kernel.4.19.146):.Clone.the.ke
4920	72 6e 65 6c 20 73 6f 75 72 63 65 20 74 6f 20 60 76 79 6f 73 2d 62 75 69 6c 64 2f 70 61 63 6b 61	rnel.source.to.`vyos-build/packa
4940	67 65 73 2f 6c 69 6e 75 78 2d 6b 65 72 6e 65 6c 2f 60 3a 00 43 6c 6f 6e 65 3a 20 60 60 67 69 74	ges/linux-kernel/`:.Clone:.``git
4960	20 63 6c 6f 6e 65 20 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 3c 75 73 65 72 3e	.clone.https://github.com/<user>
4980	2f 76 79 6f 73 2d 31 78 2e 67 69 74 60 60 00 43 6f 64 69 6e 67 20 47 75 69 64 65 6c 69 6e 65 73	/vyos-1x.git``.Coding.Guidelines
49a0	00 43 6f 6d 6d 61 6e 64 20 64 65 66 69 6e 69 74 69 6f 6e 73 20 61 72 65 20 70 75 72 65 6c 79 20	.Command.definitions.are.purely.
49c0	64 65 63 6c 61 72 61 74 69 76 65 2c 20 61 6e 64 20 63 61 6e 6e 6f 74 20 63 6f 6e 74 61 69 6e 20	declarative,.and.cannot.contain.
49e0	61 6e 79 20 6c 6f 67 69 63 2e 20 41 6c 6c 20 6c 6f 67 69 63 20 66 6f 72 20 67 65 6e 65 72 61 74	any.logic..All.logic.for.generat
4a00	69 6e 67 20 63 6f 6e 66 69 67 20 66 69 6c 65 73 20 66 6f 72 20 74 61 72 67 65 74 20 61 70 70 6c	ing.config.files.for.target.appl
4a20	69 63 61 74 69 6f 6e 73 2c 20 72 65 73 74 61 72 74 69 6e 67 20 73 65 72 76 69 63 65 73 20 61 6e	ications,.restarting.services.an
4a40	64 20 73 6f 20 6f 6e 20 69 73 20 69 6d 70 6c 65 6d 65 6e 74 65 64 20 69 6e 20 63 6f 6e 66 69 67	d.so.on.is.implemented.in.config
4a60	75 72 61 74 69 6f 6e 20 73 63 72 69 70 74 73 20 69 6e 73 74 65 61 64 2e 00 43 6f 6d 6d 69 74 20	uration.scripts.instead..Commit.
4a80	74 68 65 20 63 68 61 6e 67 65 73 20 62 79 20 63 61 6c 6c 69 6e 67 20 60 60 67 69 74 20 63 6f 6d	the.changes.by.calling.``git.com
4aa0	6d 69 74 60 60 2e 20 50 6c 65 61 73 65 20 75 73 65 20 61 20 6d 65 61 6e 69 6e 67 66 75 6c 20 63	mit``..Please.use.a.meaningful.c
4ac0	6f 6d 6d 69 74 20 68 65 61 64 6c 69 6e 65 20 28 72 65 61 64 20 61 62 6f 76 65 29 20 61 6e 64 20	ommit.headline.(read.above).and.
4ae0	64 6f 6e 27 74 20 66 6f 72 67 65 74 20 74 6f 20 72 65 66 65 72 65 6e 63 65 20 74 68 65 20 50 68	don't.forget.to.reference.the.Ph
4b00	61 62 72 69 63 61 74 6f 72 5f 20 49 44 2e 00 43 6f 6e 66 69 67 20 4c 6f 61 64 20 54 65 73 74 73	abricator_.ID..Config.Load.Tests
4b20	00 43 6f 6e 66 69 67 20 4d 69 67 72 61 74 69 6f 6e 20 53 63 72 69 70 74 73 00 43 6f 6e 66 69 67	.Config.Migration.Scripts.Config
4b40	75 72 61 74 69 6f 6e 20 45 72 72 6f 72 20 6f 6e 20 53 79 73 74 65 6d 20 42 6f 6f 74 00 43 6f 6e	uration.Error.on.System.Boot.Con
4b60	66 69 67 75 72 61 74 69 6f 6e 20 53 63 72 69 70 74 20 53 74 72 75 63 74 75 72 65 20 61 6e 64 20	figuration.Script.Structure.and.
4b80	42 65 68 61 76 69 6f 75 72 00 43 6f 6e 73 75 6c 74 20 74 68 65 20 64 6f 63 75 6d 65 6e 74 61 74	Behaviour.Consult.the.documentat
4ba0	69 6f 6e 5f 20 74 6f 20 65 6e 73 75 72 65 20 74 68 61 74 20 79 6f 75 20 68 61 76 65 20 63 6f 6e	ion_.to.ensure.that.you.have.con
4bc0	66 69 67 75 72 65 64 20 79 6f 75 72 20 73 79 73 74 65 6d 20 63 6f 72 72 65 63 74 6c 79 00 43 6f	figured.your.system.correctly.Co
4be0	6e 74 69 6e 75 6f 75 73 20 49 6e 74 65 67 72 61 74 69 6f 6e 00 43 75 73 74 6f 6d 69 7a 65 00 44	ntinuous.Integration.Customize.D
4c00	48 43 50 20 63 6c 69 65 6e 74 20 61 6e 64 20 44 48 43 50 76 36 20 70 72 65 66 69 78 20 64 65 6c	HCP.client.and.DHCPv6.prefix.del
4c20	65 67 61 74 69 6f 6e 00 44 4d 56 50 4e 20 70 61 74 63 68 65 73 20 61 72 65 20 61 64 64 65 64 20	egation.DMVPN.patches.are.added.
4c40	62 79 20 74 68 69 73 20 63 6f 6d 6d 69 74 3a 20 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63	by.this.commit:.https://github.c
4c60	6f 6d 2f 76 79 6f 73 2f 76 79 6f 73 2d 73 74 72 6f 6e 67 73 77 61 6e 2f 63 6f 6d 6d 69 74 2f 31	om/vyos/vyos-strongswan/commit/1
4c80	63 66 31 32 62 30 66 32 66 39 32 31 62 66 63 35 31 61 66 66 61 33 62 38 31 32 32 36 00 44 65 62	cf12b0f2f921bfc51affa3b81226.Deb
4ca0	69 61 6e 20 41 50 54 20 69 73 20 6e 6f 74 20 76 65 72 79 20 76 65 72 62 6f 73 65 20 77 68 65 6e	ian.APT.is.not.very.verbose.when
4cc0	20 69 74 20 63 6f 6d 65 73 20 74 6f 20 65 72 72 6f 72 73 2e 20 49 66 20 79 6f 75 72 20 49 53 4f	.it.comes.to.errors..If.your.ISO
4ce0	20 62 75 69 6c 64 20 62 72 65 61 6b 73 20 66 6f 72 20 77 68 61 74 65 76 65 72 20 72 65 61 73 6f	.build.breaks.for.whatever.reaso
4d00	6e 20 61 6e 64 20 79 6f 75 20 73 75 73 70 65 63 74 20 69 74 27 73 20 61 20 70 72 6f 62 6c 65 6d	n.and.you.suspect.it's.a.problem
4d20	20 77 69 74 68 20 41 50 54 20 64 65 70 65 6e 64 65 6e 63 69 65 73 20 6f 72 20 69 6e 73 74 61 6c	.with.APT.dependencies.or.instal
4d40	6c 61 74 69 6f 6e 20 79 6f 75 20 63 61 6e 20 61 64 64 20 74 68 69 73 20 73 6d 61 6c 6c 20 70 61	lation.you.can.add.this.small.pa
4d60	74 63 68 20 77 68 69 63 68 20 69 6e 63 72 65 61 73 65 73 20 74 68 65 20 41 50 54 20 76 65 72 62	tch.which.increases.the.APT.verb
4d80	6f 73 69 74 79 20 64 75 72 69 6e 67 20 49 53 4f 20 62 75 69 6c 64 2e 00 44 65 62 69 61 6e 20 42	osity.during.ISO.build..Debian.B
4da0	6f 6f 6b 77 6f 72 6d 20 66 6f 72 20 56 79 4f 53 20 31 2e 34 20 28 73 61 67 69 74 74 61 29 00 44	ookworm.for.VyOS.1.4.(sagitta).D
4dc0	65 62 69 61 6e 20 42 6f 6f 6b 77 6f 72 6d 20 66 6f 72 20 74 68 65 20 75 70 63 6f 6d 69 6e 67 20	ebian.Bookworm.for.the.upcoming.
4de0	56 79 4f 53 20 31 2e 35 2f 63 69 72 63 69 6e 75 73 2f 63 75 72 72 65 6e 74 20 28 73 75 62 6a 65	VyOS.1.5/circinus/current.(subje
4e00	63 74 20 74 6f 20 63 68 61 6e 67 65 29 20 2d 20 61 6b 61 20 74 68 65 20 72 6f 6c 6c 69 6e 67 20	ct.to.change).-.aka.the.rolling.
4e20	72 65 6c 65 61 73 65 00 44 65 62 69 61 6e 20 42 75 6c 6c 73 65 79 65 20 66 6f 72 20 56 79 4f 53	release.Debian.Bullseye.for.VyOS
4e40	20 31 2e 34 20 28 73 61 67 69 74 74 61 29 00 44 65 62 69 61 6e 20 42 75 6c 6c 73 65 79 65 20 66	.1.4.(sagitta).Debian.Bullseye.f
4e60	6f 72 20 56 79 4f 53 20 31 2e 34 20 28 73 61 67 69 74 74 61 2c 20 63 75 72 72 65 6e 74 29 20 2d	or.VyOS.1.4.(sagitta,.current).-
4e80	20 61 6b 61 20 74 68 65 20 72 6f 6c 6c 69 6e 67 20 72 65 6c 65 61 73 65 00 44 65 62 69 61 6e 20	.aka.the.rolling.release.Debian.
4ea0	42 75 73 74 65 72 20 66 6f 72 20 56 79 4f 53 20 31 2e 33 20 28 65 71 75 75 6c 65 75 73 29 00 44	Buster.for.VyOS.1.3.(equuleus).D
4ec0	65 62 69 61 6e 20 4a 65 73 73 69 65 20 66 6f 72 20 56 79 4f 53 20 31 2e 32 20 28 63 72 75 78 29	ebian.Jessie.for.VyOS.1.2.(crux)
4ee0	00 44 65 62 69 61 6e 20 64 6f 65 73 20 6b 65 65 70 20 74 68 65 69 72 20 70 61 63 6b 61 67 65 20	.Debian.does.keep.their.package.
4f00	69 6e 20 67 69 74 2c 20 62 75 74 20 69 74 27 73 20 75 70 73 74 72 65 61 6d 20 74 61 72 62 61 6c	in.git,.but.it's.upstream.tarbal
4f20	6c 20 69 6d 70 6f 72 74 65 64 20 69 6e 74 6f 20 67 69 74 20 77 69 74 68 6f 75 74 20 69 74 73 20	l.imported.into.git.without.its.
4f40	6f 72 69 67 69 6e 61 6c 20 63 6f 6d 6d 69 74 20 68 69 73 74 6f 72 79 2e 20 54 6f 20 62 65 20 61	original.commit.history..To.be.a
4f60	62 6c 65 20 74 6f 20 6d 65 72 67 65 20 6e 65 77 20 74 61 67 73 20 69 6e 2c 20 77 65 20 6b 65 65	ble.to.merge.new.tags.in,.we.kee
4f80	70 20 61 20 66 6f 72 6b 20 6f 66 20 74 68 65 20 75 70 73 74 72 65 61 6d 20 72 65 70 6f 73 69 74	p.a.fork.of.the.upstream.reposit
4fa0	6f 72 79 20 77 69 74 68 20 70 61 63 6b 61 67 69 6e 67 20 66 69 6c 65 73 20 69 6d 70 6f 72 74 65	ory.with.packaging.files.importe
4fc0	64 20 66 72 6f 6d 20 44 65 62 69 61 6e 20 61 74 20 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e	d.from.Debian.at.https://github.
4fe0	63 6f 6d 2f 76 79 6f 73 2f 6b 65 65 70 61 6c 69 76 65 64 2d 75 70 73 74 72 65 61 6d 00 44 65 62	com/vyos/keepalived-upstream.Deb
5000	75 67 67 69 6e 67 00 44 65 62 75 67 67 69 6e 67 20 50 79 74 68 6f 6e 20 43 6f 64 65 20 77 69 74	ugging.Debugging.Python.Code.wit
5020	68 20 50 44 42 00 44 65 73 63 72 69 70 74 69 6f 6e 00 44 65 74 65 72 6d 69 6e 69 6e 65 20 73 6f	h.PDB.Description.Determinine.so
5040	75 72 63 65 20 70 61 63 6b 61 67 65 00 44 65 76 65 6c 6f 70 6d 65 6e 74 00 44 6f 20 6e 6f 74 20	urce.package.Development.Do.not.
5060	61 64 64 20 61 6e 67 6c 65 20 62 72 61 63 6b 65 74 73 20 61 72 6f 75 6e 64 20 74 68 65 20 66 6f	add.angle.brackets.around.the.fo
5080	72 6d 61 74 2c 20 74 68 65 79 20 77 69 6c 6c 20 62 65 20 69 6e 73 65 72 74 65 64 20 61 75 74 6f	rmat,.they.will.be.inserted.auto
50a0	6d 61 74 69 63 61 6c 6c 79 00 44 6f 63 6b 65 72 00 44 6f 63 6b 65 72 68 75 62 00 44 6f 69 6e 67	matically.Docker.Dockerhub.Doing
50c0	20 73 6f 20 67 72 61 6e 74 73 20 70 72 69 76 69 6c 65 67 65 73 20 65 71 75 69 76 61 6c 65 6e 74	.so.grants.privileges.equivalent
50e0	20 74 6f 20 74 68 65 20 60 60 72 6f 6f 74 60 60 20 75 73 65 72 21 20 49 74 20 69 73 20 72 65 63	.to.the.``root``.user!.It.is.rec
5100	6f 6d 6d 65 6e 64 65 64 20 74 6f 20 72 65 6d 6f 76 65 20 74 68 65 20 6e 6f 6e 2d 72 6f 6f 74 20	ommended.to.remove.the.non-root.
5120	75 73 65 72 20 66 72 6f 6d 20 74 68 65 20 60 60 64 6f 63 6b 65 72 60 60 20 67 72 6f 75 70 20 61	user.from.the.``docker``.group.a
5140	66 74 65 72 20 62 75 69 6c 64 69 6e 67 20 74 68 65 20 56 79 4f 53 20 49 53 4f 2e 20 53 65 65 20	fter.building.the.VyOS.ISO..See.
5160	61 6c 73 6f 20 60 44 6f 63 6b 65 72 20 61 73 20 6e 6f 6e 2d 72 6f 6f 74 60 5f 2e 00 44 75 65 20	also.`Docker.as.non-root`_..Due.
5180	74 6f 20 69 73 73 75 65 73 20 69 6e 20 74 68 65 20 75 70 73 74 72 65 61 6d 20 76 65 72 73 69 6f	to.issues.in.the.upstream.versio
51a0	6e 20 74 68 61 74 20 73 6f 6d 65 74 69 6d 65 73 20 73 65 74 20 69 6e 74 65 72 66 61 63 65 73 20	n.that.sometimes.set.interfaces.
51c0	64 6f 77 6e 2c 20 61 20 6d 6f 64 69 66 69 65 64 20 76 65 72 73 69 6f 6e 20 69 73 20 75 73 65 64	down,.a.modified.version.is.used
51e0	2e 00 44 75 65 20 74 6f 20 74 68 65 20 75 70 64 61 74 65 64 20 76 65 72 73 69 6f 6e 20 6f 66 20	..Due.to.the.updated.version.of.
5200	44 6f 63 6b 65 72 2c 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 65 78 61 6d 70 6c 65 73 20 6d	Docker,.the.following.examples.m
5220	61 79 20 62 65 63 6f 6d 65 20 69 6e 76 61 6c 69 64 2e 00 44 75 72 69 6e 67 20 74 68 65 20 6d 69	ay.become.invalid..During.the.mi
5240	67 72 61 74 69 6f 6e 20 61 6e 64 20 65 78 74 65 6e 73 69 76 65 20 72 65 77 72 69 74 65 20 6f 66	gration.and.extensive.rewrite.of
5260	20 66 75 6e 63 74 69 6f 6e 61 6c 69 74 79 20 66 72 6f 6d 20 50 65 72 6c 20 69 6e 74 6f 20 50 79	.functionality.from.Perl.into.Py
5280	74 68 6f 6e 20 61 20 73 69 67 6e 69 66 69 63 61 6e 74 20 69 6e 63 72 65 61 73 65 20 69 6e 20 74	thon.a.significant.increase.in.t
52a0	68 65 20 6f 76 65 72 61 6c 6c 20 73 79 73 74 65 6d 20 62 6f 6f 74 74 69 6d 65 20 77 61 73 20 6e	he.overall.system.boottime.was.n
52c0	6f 74 69 63 65 64 2e 20 54 68 65 20 73 79 73 74 65 6d 20 62 6f 6f 74 20 74 69 6d 65 20 63 61 6e	oticed..The.system.boot.time.can
52e0	20 62 65 20 61 6e 61 6c 79 73 65 64 20 61 6e 64 20 61 20 67 72 61 70 68 20 63 61 6e 20 62 65 20	.be.analysed.and.a.graph.can.be.
5300	67 65 6e 65 72 61 74 65 64 20 69 6e 20 74 68 65 20 65 6e 64 20 77 68 69 63 68 20 73 68 6f 77 73	generated.in.the.end.which.shows
5320	20 69 6e 20 64 65 74 61 69 6c 20 77 68 6f 20 63 61 6c 6c 65 64 20 77 68 6f 6d 20 64 75 72 69 6e	.in.detail.who.called.whom.durin
5340	67 20 74 68 65 20 73 79 73 74 65 6d 20 73 74 61 72 74 75 70 20 70 68 61 73 65 2e 00 45 61 63 68	g.the.system.startup.phase..Each
5360	20 6d 6f 64 75 6c 65 20 69 73 20 62 75 69 6c 64 20 6f 6e 20 64 65 6d 61 6e 64 20 69 66 20 61 20	.module.is.build.on.demand.if.a.
5380	6e 65 77 20 63 6f 6d 6d 69 74 20 6f 6e 20 74 68 65 20 62 72 61 6e 63 68 20 69 6e 20 71 75 65 73	new.commit.on.the.branch.in.ques
53a0	74 69 6f 6e 20 69 73 20 66 6f 75 6e 64 2e 20 41 66 74 65 72 20 61 20 73 75 63 63 65 73 73 66 75	tion.is.found..After.a.successfu
53c0	6c 20 72 75 6e 20 74 68 65 20 72 65 73 75 6c 74 69 6e 67 20 44 65 62 69 61 6e 20 50 61 63 6b 61	l.run.the.resulting.Debian.Packa
53e0	67 65 28 73 29 20 77 69 6c 6c 20 62 65 20 64 65 70 6c 6f 79 65 64 20 74 6f 20 6f 75 72 20 44 65	ge(s).will.be.deployed.to.our.De
5400	62 69 61 6e 20 72 65 70 6f 73 69 74 6f 72 79 20 77 68 69 63 68 20 69 73 20 75 73 65 64 20 64 75	bian.repository.which.is.used.du
5420	72 69 6e 67 20 62 75 69 6c 64 20 74 69 6d 65 2e 20 49 74 20 69 73 20 6c 6f 63 61 74 65 64 20 68	ring.build.time..It.is.located.h
5440	65 72 65 3a 20 68 74 74 70 3a 2f 2f 64 65 76 2e 70 61 63 6b 61 67 65 73 2e 76 79 6f 73 2e 6e 65	ere:.http://dev.packages.vyos.ne
5460	74 2f 72 65 70 6f 73 69 74 6f 72 69 65 73 2f 2e 00 45 61 63 68 20 6f 66 20 74 68 6f 73 65 20 6d	t/repositories/..Each.of.those.m
5480	6f 64 75 6c 65 73 20 68 6f 6c 64 73 20 61 20 64 65 70 65 6e 64 65 6e 63 79 20 6f 6e 20 74 68 65	odules.holds.a.dependency.on.the
54a0	20 6b 65 72 6e 65 6c 20 76 65 72 73 69 6f 6e 20 61 6e 64 20 69 66 20 79 6f 75 20 61 72 65 20 6c	.kernel.version.and.if.you.are.l
54c0	75 63 6b 79 20 65 6e 6f 75 67 68 20 74 6f 20 72 65 63 65 69 76 65 20 61 6e 20 49 53 4f 20 62 75	ucky.enough.to.receive.an.ISO.bu
54e0	69 6c 64 20 65 72 72 6f 72 20 77 68 69 63 68 20 73 6f 75 6e 64 73 20 6c 69 6b 65 3a 00 45 6e 61	ild.error.which.sounds.like:.Ena
5500	62 6c 65 64 2f 44 69 73 61 62 6c 65 64 00 45 6e 73 75 72 65 20 74 68 65 20 70 72 6f 62 6c 65 6d	bled/Disabled.Ensure.the.problem
5520	20 69 73 20 72 65 70 72 6f 64 75 63 69 62 6c 65 00 45 76 65 72 79 20 63 68 61 6e 67 65 20 73 65	.is.reproducible.Every.change.se
5540	74 20 6d 75 73 74 20 62 65 20 63 6f 6e 73 69 73 74 65 6e 74 20 28 73 65 6c 66 20 63 6f 6e 74 61	t.must.be.consistent.(self.conta
5560	69 6e 69 6e 67 29 21 20 44 6f 20 6e 6f 74 20 66 69 78 20 6d 75 6c 74 69 70 6c 65 20 62 75 67 73	ining)!.Do.not.fix.multiple.bugs
5580	20 69 6e 20 61 20 73 69 6e 67 6c 65 20 63 6f 6d 6d 69 74 2e 20 49 66 20 79 6f 75 20 61 6c 72 65	.in.a.single.commit..If.you.alre
55a0	61 64 79 20 77 6f 72 6b 65 64 20 6f 6e 20 6d 75 6c 74 69 70 6c 65 20 66 69 78 65 73 20 69 6e 20	ady.worked.on.multiple.fixes.in.
55c0	74 68 65 20 73 61 6d 65 20 66 69 6c 65 20 75 73 65 20 60 67 69 74 20 61 64 64 20 2d 2d 70 61 74	the.same.file.use.`git.add.--pat
55e0	63 68 60 20 74 6f 20 6f 6e 6c 79 20 61 64 64 20 74 68 65 20 70 61 72 74 73 20 72 65 6c 61 74 65	ch`.to.only.add.the.parts.relate
5600	64 20 74 6f 20 74 68 65 20 6f 6e 65 20 69 73 73 75 65 20 69 6e 74 6f 20 79 6f 75 72 20 75 70 63	d.to.the.one.issue.into.your.upc
5620	6f 6d 69 6e 67 20 63 6f 6d 6d 69 74 2e 00 45 78 61 6d 70 6c 65 3a 00 45 78 61 6d 70 6c 65 73 3a	oming.commit..Example:.Examples:
5640	00 45 78 63 65 70 74 69 6f 6e 73 2c 20 69 6e 63 6c 75 64 69 6e 67 20 60 60 56 79 4f 53 45 72 72	.Exceptions,.including.``VyOSErr
5660	6f 72 60 60 20 28 77 68 69 63 68 20 69 73 20 72 61 69 73 65 64 20 62 79 20 60 60 76 79 6f 73 2e	or``.(which.is.raised.by.``vyos.
5680	63 6f 6e 66 69 67 2e 43 6f 6e 66 69 67 60 60 20 6f 6e 20 69 6d 70 72 6f 70 65 72 20 63 6f 6e 66	config.Config``.on.improper.conf
56a0	69 67 20 6f 70 65 72 61 74 69 6f 6e 73 2c 20 73 75 63 68 20 61 73 20 74 72 79 69 6e 67 20 74 6f	ig.operations,.such.as.trying.to
56c0	20 75 73 65 20 60 60 6c 69 73 74 5f 6e 6f 64 65 73 28 29 60 60 20 6f 6e 20 61 20 6e 6f 6e 2d 74	.use.``list_nodes()``.on.a.non-t
56e0	61 67 20 6e 6f 64 65 29 20 73 68 6f 75 6c 64 20 6e 6f 74 20 62 65 20 73 69 6c 65 6e 63 65 64 20	ag.node).should.not.be.silenced.
5700	6f 72 20 63 61 75 67 68 74 20 61 6e 64 20 72 65 2d 72 61 69 73 65 64 20 61 73 20 63 6f 6e 66 69	or.caught.and.re-raised.as.confi
5720	67 20 65 72 72 6f 72 2e 20 53 75 72 65 20 74 68 69 73 20 77 69 6c 6c 20 6e 6f 74 20 6c 6f 6f 6b	g.error..Sure.this.will.not.look
5740	20 70 72 65 74 74 79 20 6f 6e 20 75 73 65 72 27 73 20 73 63 72 65 65 6e 2c 20 62 75 74 20 69 74	.pretty.on.user's.screen,.but.it
5760	20 77 69 6c 6c 20 6d 61 6b 65 20 77 61 79 20 62 65 74 74 65 72 20 62 75 67 20 72 65 70 6f 72 74	.will.make.way.better.bug.report
5780	73 2c 20 61 6e 64 20 68 65 6c 70 20 75 73 65 72 73 20 28 61 6e 64 20 6d 6f 73 74 20 56 79 4f 53	s,.and.help.users.(and.most.VyOS
57a0	20 75 73 65 72 73 20 61 72 65 20 49 54 20 70 72 6f 66 65 73 73 69 6f 6e 61 6c 73 29 20 64 6f 20	.users.are.IT.professionals).do.
57c0	74 68 65 69 72 20 6f 77 6e 20 64 65 62 75 67 67 69 6e 67 20 61 73 20 77 65 6c 6c 2e 00 45 78 70	their.own.debugging.as.well..Exp
57e0	6f 72 74 20 6c 61 73 74 20 63 6f 6d 6d 69 74 20 74 6f 20 70 61 74 63 68 20 66 69 6c 65 3a 20 60	ort.last.commit.to.patch.file:.`
5800	60 67 69 74 20 66 6f 72 6d 61 74 2d 70 61 74 63 68 60 60 20 6f 72 20 65 78 70 6f 72 74 20 74 68	`git.format-patch``.or.export.th
5820	65 20 6c 61 73 74 20 74 77 6f 20 63 6f 6d 6d 69 74 73 20 69 6e 74 6f 20 69 74 73 20 61 70 70 72	e.last.two.commits.into.its.appr
5840	6f 70 72 69 61 74 65 20 70 61 74 63 68 20 66 69 6c 65 73 3a 20 60 60 67 69 74 20 66 6f 72 6d 61	opriate.patch.files:.``git.forma
5860	74 2d 70 61 74 63 68 20 2d 32 60 60 00 45 78 74 65 72 6e 61 6c 20 61 72 69 74 68 6d 65 74 69 63	t-patch.-2``.External.arithmetic
5880	20 76 61 6c 69 64 61 74 6f 72 20 6d 61 79 20 62 65 20 61 64 64 65 64 20 69 66 20 74 68 65 72 65	.validator.may.be.added.if.there
58a0	27 73 20 64 65 6d 61 6e 64 2c 20 63 6f 6d 70 6c 65 78 20 76 61 6c 69 64 61 74 69 6f 6e 20 69 73	's.demand,.complex.validation.is
58c0	20 62 65 74 74 65 72 20 6c 65 66 74 20 74 6f 20 63 6f 6d 6d 69 74 2d 74 69 6d 65 20 73 63 72 69	.better.left.to.commit-time.scri
58e0	70 74 73 00 46 52 52 00 46 65 61 74 75 72 65 20 52 65 71 75 65 73 74 00 46 65 61 74 75 72 65 20	pts.FRR.Feature.Request.Feature.
5900	52 65 71 75 65 73 74 73 00 46 65 61 74 75 72 65 20 72 65 71 75 65 73 74 73 20 74 68 61 74 20 64	Requests.Feature.requests.that.d
5920	6f 20 6e 6f 74 20 69 6e 63 6c 75 64 65 20 72 65 71 75 69 72 65 64 20 69 6e 66 6f 72 6d 61 74 69	o.not.include.required.informati
5940	6f 6e 20 61 6e 64 20 6e 65 65 64 20 63 6c 61 72 69 66 69 63 61 74 69 6f 6e 2e 00 46 69 72 6d 77	on.and.need.clarification..Firmw
5960	61 72 65 00 46 69 72 73 74 2c 20 63 6c 6f 6e 65 20 74 68 65 20 73 6f 75 72 63 65 20 63 6f 64 65	are.First,.clone.the.source.code
5980	20 61 6e 64 20 63 68 65 63 6b 20 6f 75 74 20 74 68 65 20 61 70 70 72 6f 70 72 69 61 74 65 20 76	.and.check.out.the.appropriate.v
59a0	65 72 73 69 6f 6e 20 62 79 20 72 75 6e 6e 69 6e 67 3a 00 46 6f 6c 6c 6f 77 20 74 68 65 20 61 62	ersion.by.running:.Follow.the.ab
59c0	6f 76 65 20 73 74 65 70 73 20 6f 6e 20 68 6f 77 20 74 6f 20 22 46 6f 72 6b 20 72 65 70 6f 73 69	ove.steps.on.how.to."Fork.reposi
59e0	74 6f 72 79 20 74 6f 20 73 75 62 6d 69 74 20 61 20 50 61 74 63 68 22 2e 20 49 6e 73 74 65 61 64	tory.to.submit.a.Patch"..Instead
5a00	20 6f 66 20 75 70 6c 6f 61 64 69 6e 67 20 22 70 75 73 68 69 6e 67 22 20 79 6f 75 72 20 63 68 61	.of.uploading."pushing".your.cha
5a20	6e 67 65 73 20 74 6f 20 47 69 74 48 75 62 20 79 6f 75 20 63 61 6e 20 65 78 70 6f 72 74 20 74 68	nges.to.GitHub.you.can.export.th
5a40	65 20 70 61 74 63 68 65 73 2f 20 63 6f 6d 6d 69 74 73 20 61 6e 64 20 73 65 6e 64 20 69 74 20 74	e.patches/.commits.and.send.it.t
5a60	6f 20 6d 61 69 6e 74 61 69 6e 65 72 73 40 76 79 6f 73 2e 6e 65 74 20 6f 72 20 61 74 74 61 63 68	o.maintainers@vyos.net.or.attach
5a80	20 69 74 20 64 69 72 65 63 74 6c 79 20 74 6f 20 74 68 65 20 62 75 67 20 28 70 72 65 66 65 72 72	.it.directly.to.the.bug.(preferr
5aa0	65 64 20 6f 76 65 72 20 65 6d 61 69 6c 29 00 46 6f 6c 6c 6f 77 65 64 20 62 79 20 61 20 6d 65 73	ed.over.email).Followed.by.a.mes
5ac0	73 61 67 65 20 77 68 69 63 68 20 64 65 73 63 72 69 62 65 73 20 61 6c 6c 20 74 68 65 20 64 65 74	sage.which.describes.all.the.det
5ae0	61 69 6c 73 20 6c 69 6b 65 3a 00 46 6f 72 20 65 61 63 68 20 66 65 61 74 75 72 65 2c 20 61 20 66	ails.like:.For.each.feature,.a.f
5b00	69 6c 65 20 63 61 6c 6c 65 64 20 60 60 76 79 6f 73 2e 66 65 61 74 75 72 65 2e 64 65 62 75 67 60	ile.called.``vyos.feature.debug`
5b20	60 20 63 61 6e 20 62 65 20 63 72 65 61 74 65 64 20 74 6f 20 74 6f 67 67 6c 65 20 74 68 65 20 66	`.can.be.created.to.toggle.the.f
5b40	65 61 74 75 72 65 20 6f 6e 2e 20 49 66 20 61 20 70 61 72 61 6d 65 74 65 72 20 69 73 20 72 65 71	eature.on..If.a.parameter.is.req
5b60	75 69 72 65 64 20 69 74 20 63 61 6e 20 62 65 20 70 6c 61 63 65 64 20 69 6e 73 69 64 65 20 74 68	uired.it.can.be.placed.inside.th
5b80	65 20 66 69 6c 65 20 61 73 20 69 74 73 20 66 69 72 73 74 20 6c 69 6e 65 2e 00 46 6f 72 20 65 61	e.file.as.its.first.line..For.ea
5ba0	73 79 20 6f 72 69 65 6e 74 61 74 69 6f 6e 20 77 65 20 73 75 67 67 65 73 74 20 79 6f 75 20 74 61	sy.orientation.we.suggest.you.ta
5bc0	6b 65 20 61 20 6c 6f 6f 6b 20 6f 6e 20 74 68 65 20 60 60 6e 74 70 2e 70 79 60 60 20 6f 72 20 60	ke.a.look.on.the.``ntp.py``.or.`
5be0	60 69 6e 74 65 72 66 61 63 65 73 2d 62 6f 6e 64 69 6e 67 2e 70 79 60 60 20 28 66 6f 72 20 74 61	`interfaces-bonding.py``.(for.ta
5c00	67 20 6e 6f 64 65 73 29 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 2e 20 42 6f 74 68 20 66 69	g.nodes).implementation..Both.fi
5c20	6c 65 73 20 63 61 6e 20 62 65 20 66 6f 75 6e 64 20 69 6e 20 74 68 65 20 76 79 6f 73 2d 31 78 5f	les.can.be.found.in.the.vyos-1x_
5c40	20 72 65 70 6f 73 69 74 6f 72 79 2e 00 46 6f 72 20 65 78 61 6d 70 6c 65 20 72 75 6e 6e 69 6e 67	.repository..For.example.running
5c60	2c 20 60 60 65 78 70 6f 72 74 20 56 59 4f 53 5f 49 46 43 4f 4e 46 49 47 5f 44 45 42 55 47 3d 22	,.``export.VYOS_IFCONFIG_DEBUG="
5c80	22 60 60 20 6f 6e 20 79 6f 75 72 20 76 62 61 73 68 2c 20 77 69 6c 6c 20 68 61 76 65 20 74 68 65	"``.on.your.vbash,.will.have.the
5ca0	20 73 61 6d 65 20 65 66 66 65 63 74 20 61 73 20 60 60 74 6f 75 63 68 20 2f 74 6d 70 2f 76 79 6f	.same.effect.as.``touch./tmp/vyo
5cc0	73 2e 69 66 63 6f 6e 66 69 67 2e 64 65 62 75 67 60 60 2e 00 46 6f 72 20 65 78 61 6d 70 6c 65 2c	s.ifconfig.debug``..For.example,
5ce0	20 60 60 2f 74 6d 70 2f 76 79 6f 73 2e 69 66 63 6f 6e 66 69 67 2e 64 65 62 75 67 60 60 20 63 61	.``/tmp/vyos.ifconfig.debug``.ca
5d00	6e 20 62 65 20 63 72 65 61 74 65 64 20 74 6f 20 65 6e 61 62 6c 65 20 69 6e 74 65 72 66 61 63 65	n.be.created.to.enable.interface
5d20	20 64 65 62 75 67 67 69 6e 67 2e 00 46 6f 72 20 74 68 65 20 70 61 63 6b 61 67 65 73 20 72 65 71	.debugging..For.the.packages.req
5d40	75 69 72 65 64 2c 20 79 6f 75 20 63 61 6e 20 72 65 66 65 72 20 74 6f 20 74 68 65 20 60 60 64 6f	uired,.you.can.refer.to.the.``do
5d60	63 6b 65 72 2f 44 6f 63 6b 65 72 66 69 6c 65 60 60 20 66 69 6c 65 20 69 6e 20 74 68 65 20 72 65	cker/Dockerfile``.file.in.the.re
5d80	70 6f 73 69 74 6f 72 79 5f 2e 20 54 68 65 20 60 60 2e 2f 62 75 69 6c 64 2d 76 79 6f 73 2d 69 6d	pository_..The.``./build-vyos-im
5da0	61 67 65 60 60 20 73 63 72 69 70 74 20 77 69 6c 6c 20 61 6c 73 6f 20 77 61 72 6e 20 79 6f 75 20	age``.script.will.also.warn.you.
5dc0	69 66 20 61 6e 79 20 64 65 70 65 6e 64 65 6e 63 69 65 73 20 61 72 65 20 6d 69 73 73 69 6e 67 2e	if.any.dependencies.are.missing.
5de0	00 46 6f 72 6b 20 52 65 70 6f 73 69 74 6f 72 79 20 61 6e 64 20 73 75 62 6d 69 74 20 50 61 74 63	.Fork.Repository.and.submit.Patc
5e00	68 00 46 6f 72 6b 3a 20 60 60 67 69 74 20 72 65 6d 6f 74 65 20 61 64 64 20 6d 79 66 6f 72 6b 20	h.Fork:.``git.remote.add.myfork.
5e20	68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 3c 75 73 65 72 3e 2f 76 79 6f 73 2d 31	https://github.com/<user>/vyos-1
5e40	78 2e 67 69 74 60 60 00 46 6f 72 6b 69 6e 67 20 74 68 65 20 72 65 70 6f 73 69 74 6f 72 79 20 61	x.git``.Forking.the.repository.a
5e60	6e 64 20 73 75 62 6d 69 74 74 69 6e 67 20 61 20 47 69 74 48 75 62 20 70 75 6c 6c 2d 72 65 71 75	nd.submitting.a.GitHub.pull-requ
5e80	65 73 74 20 69 73 20 74 68 65 20 70 72 65 66 65 72 72 65 64 20 77 61 79 20 6f 66 20 73 75 62 6d	est.is.the.preferred.way.of.subm
5ea0	69 74 74 69 6e 67 20 79 6f 75 72 20 63 68 61 6e 67 65 73 20 74 6f 20 56 79 4f 53 2e 20 59 6f 75	itting.your.changes.to.VyOS..You
5ec0	20 63 61 6e 20 66 6f 72 6b 20 61 6e 79 20 56 79 4f 53 20 72 65 70 6f 73 69 74 6f 72 79 20 74 6f	.can.fork.any.VyOS.repository.to
5ee0	20 79 6f 75 72 20 76 65 72 79 20 6f 77 6e 20 47 69 74 48 75 62 20 61 63 63 6f 75 6e 74 20 62 79	.your.very.own.GitHub.account.by
5f00	20 6a 75 73 74 20 61 70 70 65 6e 64 69 6e 67 20 60 60 2f 66 6f 72 6b 60 60 20 74 6f 20 61 6e 79	.just.appending.``/fork``.to.any
5f20	20 72 65 70 6f 73 69 74 6f 72 79 27 73 20 55 52 4c 20 6f 6e 20 47 69 74 48 75 62 2e 20 54 6f 20	.repository's.URL.on.GitHub..To.
5f40	65 2e 67 2e 20 66 6f 72 6b 20 74 68 65 20 60 60 76 79 6f 73 2d 31 78 60 60 20 72 65 70 6f 73 69	e.g..fork.the.``vyos-1x``.reposi
5f60	74 6f 72 79 2c 20 6f 70 65 6e 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 55 52 4c 20 69 6e 20	tory,.open.the.following.URL.in.
5f80	79 6f 75 72 20 66 61 76 6f 75 72 69 74 65 20 62 72 6f 77 73 65 72 3a 20 68 74 74 70 73 3a 2f 2f	your.favourite.browser:.https://
5fa0	67 69 74 68 75 62 2e 63 6f 6d 2f 76 79 6f 73 2f 76 79 6f 73 2d 31 78 2f 66 6f 72 6b 00 46 6f 72	github.com/vyos/vyos-1x/fork.For
5fc0	6d 61 74 74 69 6e 67 00 47 4e 55 20 50 72 65 70 72 6f 63 65 73 73 6f 72 00 47 65 74 20 63 6f 6d	matting.GNU.Preprocessor.Get.com
5fe0	6d 75 6e 69 74 79 20 73 75 70 70 6f 72 74 20 76 69 61 20 53 6c 61 63 6b 5f 20 6f 72 20 6f 75 72	munity.support.via.Slack_.or.our
6000	20 46 6f 72 75 6d 5f 00 47 6f 6f 64 20 6c 75 63 6b 21 00 47 6f 6f 64 3a 20 22 44 69 73 61 62 6c	.Forum_.Good.luck!.Good:."Disabl
6020	65 20 49 50 76 36 20 66 6f 72 77 61 72 64 69 6e 67 22 00 47 6f 6f 64 3a 20 22 46 72 6f 62 6e 69	e.IPv6.forwarding".Good:."Frobni
6040	63 61 74 69 6f 6e 20 61 6c 67 6f 72 69 74 68 6d 22 00 47 6f 6f 64 3a 20 22 54 43 50 20 63 6f 6e	cation.algorithm".Good:."TCP.con
6060	6e 65 63 74 69 6f 6e 20 74 69 6d 65 6f 75 74 22 00 47 6f 6f 64 3a 20 50 50 50 6f 45 2c 20 49 50	nection.timeout".Good:.PPPoE,.IP
6080	73 65 63 00 47 6f 6f 64 3a 20 52 41 44 49 55 53 20 28 61 73 20 69 6e 20 72 65 6d 6f 74 65 20 61	sec.Good:.RADIUS.(as.in.remote.a
60a0	75 74 68 65 6e 74 69 63 61 74 69 6f 6e 20 66 6f 72 20 64 69 61 6c 2d 69 6e 20 75 73 65 72 20 73	uthentication.for.dial-in.user.s
60c0	65 72 76 69 63 65 73 29 00 47 75 69 64 65 6c 69 6e 65 73 00 48 65 6c 70 20 53 74 72 69 6e 67 00	ervices).Guidelines.Help.String.
60e0	48 65 6c 70 20 66 75 74 75 72 65 20 6d 61 69 6e 74 61 69 6e 65 72 73 20 6f 66 20 56 79 4f 53 20	Help.future.maintainers.of.VyOS.
6100	28 69 74 20 63 6f 75 6c 64 20 62 65 20 79 6f 75 21 29 20 74 6f 20 66 69 6e 64 20 6f 75 74 20 77	(it.could.be.you!).to.find.out.w
6120	68 79 20 63 65 72 74 61 69 6e 20 74 68 69 6e 67 73 20 68 61 76 65 20 62 65 65 6e 20 63 68 61 6e	hy.certain.things.have.been.chan
6140	67 65 64 20 69 6e 20 74 68 65 20 63 6f 64 65 62 61 73 65 20 6f 72 20 77 68 79 20 63 65 72 74 61	ged.in.the.codebase.or.why.certa
6160	69 6e 20 66 65 61 74 75 72 65 73 20 68 61 76 65 20 62 65 65 6e 20 61 64 64 65 64 00 48 6f 72 72	in.features.have.been.added.Horr
6180	69 62 6c 65 3a 20 22 54 63 70 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 74 69 6d 65 6f 75 74 22 00 48	ible:."Tcp.connection.timeout".H
61a0	6f 72 72 69 62 6c 65 3a 20 22 66 72 6f 62 6e 69 63 61 74 69 6f 6e 20 61 6c 67 6f 72 69 74 68 6d	orrible:."frobnication.algorithm
61c0	2e 22 00 48 6f 77 20 63 61 6e 20 77 65 20 72 65 70 72 6f 64 75 63 65 20 74 68 69 73 20 42 75 67	.".How.can.we.reproduce.this.Bug
61e0	3f 00 48 6f 77 20 79 6f 75 27 64 20 63 6f 6e 66 69 67 75 72 65 20 69 74 20 62 79 20 68 61 6e 64	?.How.you'd.configure.it.by.hand
6200	20 74 68 65 72 65 3f 00 49 20 68 61 76 65 20 66 6f 75 6e 64 20 61 20 62 75 67 2c 20 77 68 61 74	.there?.I.have.found.a.bug,.what
6220	20 73 68 6f 75 6c 64 20 49 20 64 6f 3f 00 49 50 20 61 6e 64 20 49 50 76 36 20 6f 70 74 69 6f 6e	.should.I.do?.IP.and.IPv6.option
6240	73 00 49 53 4f 20 42 75 69 6c 64 20 49 73 73 75 65 73 00 49 53 4f 20 69 6d 61 67 65 20 62 75 69	s.ISO.Build.Issues.ISO.image.bui
6260	6c 64 00 49 66 20 61 20 76 65 72 62 20 69 73 20 65 73 73 65 6e 74 69 61 6c 2c 20 6b 65 65 70 20	ld.If.a.verb.is.essential,.keep.
6280	69 74 2e 20 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 69 6e 20 74 68 65 20 68 65 6c 70 20 74 65 78	it..For.example,.in.the.help.tex
62a0	74 20 6f 66 20 60 60 73 65 74 20 73 79 73 74 65 6d 20 69 70 76 36 20 64 69 73 61 62 6c 65 2d 66	t.of.``set.system.ipv6.disable-f
62c0	6f 72 77 61 72 64 69 6e 67 60 60 2c 20 22 44 69 73 61 62 6c 65 20 49 50 76 36 20 66 6f 72 77 61	orwarding``,."Disable.IPv6.forwa
62e0	72 64 69 6e 67 20 6f 6e 20 61 6c 6c 20 69 6e 74 65 72 66 61 63 65 73 22 20 69 73 20 61 20 70 65	rding.on.all.interfaces".is.a.pe
6300	72 66 65 63 74 6c 79 20 6a 75 73 74 69 66 69 65 64 20 77 6f 72 64 69 6e 67 2e 00 49 66 20 61 70	rfectly.justified.wording..If.ap
6320	70 6c 69 63 61 62 6c 65 20 61 20 72 65 66 65 72 65 6e 63 65 20 74 6f 20 61 20 70 72 65 76 69 6f	plicable.a.reference.to.a.previo
6340	75 73 20 63 6f 6d 6d 69 74 20 73 68 6f 75 6c 64 20 62 65 20 6d 61 64 65 20 6c 69 6e 6b 69 6e 67	us.commit.should.be.made.linking
6360	20 74 68 6f 73 65 20 63 6f 6d 6d 69 74 73 20 6e 69 63 65 6c 79 20 77 68 65 6e 20 62 72 6f 77 73	.those.commits.nicely.when.brows
6380	69 6e 67 20 74 68 65 20 68 69 73 74 6f 72 79 3a 20 60 60 41 66 74 65 72 20 63 6f 6d 6d 69 74 20	ing.the.history:.``After.commit.
63a0	61 62 63 64 31 32 65 66 20 28 22 73 6e 6d 70 3a 20 74 68 69 73 20 69 73 20 61 20 68 65 61 64 6c	abcd12ef.("snmp:.this.is.a.headl
63c0	69 6e 65 22 29 20 61 20 50 79 74 68 6f 6e 20 69 6d 70 6f 72 74 20 73 74 61 74 65 6d 65 6e 74 20	ine").a.Python.import.statement.
63e0	69 73 20 6d 69 73 73 69 6e 67 2c 20 74 68 72 6f 77 69 6e 67 20 74 68 65 20 66 6f 6c 6c 6f 77 69	is.missing,.throwing.the.followi
6400	6e 67 20 65 78 63 65 70 74 69 6f 6e 3a 20 41 42 43 44 45 46 60 60 00 49 66 20 69 74 27 73 20 61	ng.exception:.ABCDEF``.If.it's.a
6420	20 72 65 67 72 65 73 73 69 6f 6e 2c 20 74 65 6c 6c 20 75 73 20 61 20 56 79 4f 53 20 76 65 72 73	.regression,.tell.us.a.VyOS.vers
6440	69 6f 6e 20 77 68 65 72 65 20 74 68 65 20 66 65 61 74 75 72 65 20 73 74 69 6c 6c 20 77 6f 72 6b	ion.where.the.feature.still.work
6460	65 64 20 63 6f 72 72 65 63 74 6c 79 2e 20 49 74 27 73 20 70 65 72 66 65 63 74 20 69 66 20 79 6f	ed.correctly..It's.perfect.if.yo
6480	75 20 63 61 6e 20 74 65 6c 6c 20 65 78 61 63 74 6c 79 20 77 68 69 63 68 20 76 65 72 73 69 6f 6e	u.can.tell.exactly.which.version
64a0	20 62 72 6f 6b 65 20 69 74 2c 20 62 75 74 20 77 65 20 75 6e 64 65 72 73 74 61 6e 64 20 74 68 61	.broke.it,.but.we.understand.tha
64c0	74 20 69 74 27 73 20 6e 6f 74 20 61 6c 77 61 79 73 20 65 61 73 79 20 6f 72 20 66 65 61 73 69 62	t.it's.not.always.easy.or.feasib
64e0	6c 65 20 e2 80 94 20 61 6e 79 20 77 6f 72 6b 69 6e 67 20 76 65 72 73 69 6f 6e 20 69 73 20 61 63	le.....any.working.version.is.ac
6500	63 65 70 74 61 62 6c 65 2e 00 49 66 20 74 68 65 72 65 20 69 73 20 6e 6f 20 50 68 61 62 72 69 63	ceptable..If.there.is.no.Phabric
6520	61 74 6f 72 5f 20 72 65 66 65 72 65 6e 63 65 20 69 6e 20 74 68 65 20 63 6f 6d 6d 69 74 73 20 6f	ator_.reference.in.the.commits.o
6540	66 20 79 6f 75 72 20 70 75 6c 6c 20 72 65 71 75 65 73 74 2c 20 77 65 20 68 61 76 65 20 74 6f 20	f.your.pull.request,.we.have.to.
6560	61 73 6b 20 79 6f 75 20 74 6f 20 61 6d 65 6e 64 20 74 68 65 20 63 6f 6d 6d 69 74 20 6d 65 73 73	ask.you.to.amend.the.commit.mess
6580	61 67 65 2e 20 4f 74 68 65 72 77 69 73 65 20 77 65 20 77 69 6c 6c 20 68 61 76 65 20 74 6f 20 72	age..Otherwise.we.will.have.to.r
65a0	65 6a 65 63 74 20 69 74 2e 00 49 66 20 74 68 65 72 65 20 69 73 20 6e 6f 20 72 65 73 70 6f 6e 73	eject.it..If.there.is.no.respons
65c0	65 20 61 66 74 65 72 20 66 75 72 74 68 65 72 20 74 77 6f 20 77 65 65 6b 73 2c 20 74 68 65 20 74	e.after.further.two.weeks,.the.t
65e0	61 73 6b 20 77 69 6c 6c 20 62 65 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 63 6c 6f 73 65 64	ask.will.be.automatically.closed
6600	2e 00 49 66 20 74 68 65 72 65 20 69 73 20 6e 6f 20 72 65 73 70 6f 6e 73 65 20 66 72 6f 6d 20 74	..If.there.is.no.response.from.t
6620	68 65 20 72 65 70 6f 72 74 65 72 20 77 69 74 68 69 6e 20 74 77 6f 20 77 65 65 6b 73 2c 20 74 68	he.reporter.within.two.weeks,.th
6640	65 20 74 61 73 6b 20 62 6f 74 20 77 69 6c 6c 20 61 64 64 20 61 20 63 6f 6d 6d 65 6e 74 20 28 22	e.task.bot.will.add.a.comment.("
6660	41 6e 79 20 6e 65 77 73 3f 22 29 20 74 6f 20 72 65 6d 69 6e 64 20 74 68 65 20 72 65 70 6f 72 74	Any.news?").to.remind.the.report
6680	65 72 20 74 6f 20 72 65 70 6c 79 2e 00 49 66 20 79 6f 75 20 61 72 65 20 62 72 61 76 65 20 65 6e	er.to.reply..If.you.are.brave.en
66a0	6f 75 67 68 20 74 6f 20 62 75 69 6c 64 20 79 6f 75 72 73 65 6c 66 20 61 6e 20 49 53 4f 20 69 6d	ough.to.build.yourself.an.ISO.im
66c0	61 67 65 20 63 6f 6e 74 61 69 6e 69 6e 67 20 61 6e 79 20 6d 6f 64 69 66 69 65 64 20 70 61 63 6b	age.containing.any.modified.pack
66e0	61 67 65 20 66 72 6f 6d 20 6f 75 72 20 47 69 74 48 75 62 20 6f 72 67 61 6e 69 73 61 74 69 6f 6e	age.from.our.GitHub.organisation
6700	20 2d 20 74 68 69 73 20 69 73 20 74 68 65 20 70 6c 61 63 65 20 74 6f 20 62 65 2e 00 49 66 20 79	.-.this.is.the.place.to.be..If.y
6720	6f 75 20 61 72 65 6e 27 74 20 63 65 72 74 61 69 6e 20 77 68 61 74 20 74 68 65 20 63 6f 72 72 65	ou.aren't.certain.what.the.corre
6740	63 74 20 62 65 68 61 76 69 6f 72 20 69 73 20 61 6e 64 20 69 66 20 77 68 61 74 20 79 6f 75 20 73	ct.behavior.is.and.if.what.you.s
6760	65 65 20 69 73 20 72 65 61 6c 6c 79 20 61 20 62 75 67 2c 20 6f 72 20 69 66 20 79 6f 75 20 64 6f	ee.is.really.a.bug,.or.if.you.do
6780	6e 27 74 20 68 61 76 65 20 61 20 72 65 70 72 6f 64 75 63 69 6e 67 20 70 72 6f 63 65 64 75 72 65	n't.have.a.reproducing.procedure
67a0	20 74 68 61 74 20 72 65 6c 69 61 62 6c 79 20 74 72 69 67 67 65 72 73 20 69 74 2c 20 70 6c 65 61	.that.reliably.triggers.it,.plea
67c0	73 65 20 63 72 65 61 74 65 20 61 20 70 6f 73 74 20 6f 6e 20 74 68 65 20 66 6f 72 75 6d 20 6f 72	se.create.a.post.on.the.forum.or
67e0	20 61 73 6b 20 69 6e 20 74 68 65 20 63 68 61 74 20 66 69 72 73 74 20 e2 80 94 20 6f 72 2c 20 69	.ask.in.the.chat.first.....or,.i
6800	66 20 79 6f 75 20 68 61 76 65 20 61 20 73 75 62 73 63 72 69 70 74 69 6f 6e 2c 20 63 72 65 61 74	f.you.have.a.subscription,.creat
6820	65 20 61 20 73 75 70 70 6f 72 74 20 74 69 63 6b 65 74 2e 20 4f 75 72 20 74 65 61 6d 20 61 6e 64	e.a.support.ticket..Our.team.and
6840	20 63 6f 6d 6d 75 6e 69 74 79 20 6d 65 6d 62 65 72 73 20 63 61 6e 20 68 65 6c 70 20 79 6f 75 20	.community.members.can.help.you.
6860	69 64 65 6e 74 69 66 79 20 74 68 65 20 62 75 67 20 61 6e 64 20 77 6f 72 6b 20 61 72 6f 75 6e 64	identify.the.bug.and.work.around
6880	20 69 74 2c 20 74 68 65 6e 20 63 72 65 61 74 65 20 61 6e 20 61 63 74 69 6f 6e 61 62 6c 65 20 61	.it,.then.create.an.actionable.a
68a0	6e 64 20 74 65 73 74 61 62 6c 65 20 62 75 67 20 72 65 70 6f 72 74 2e 00 49 66 20 79 6f 75 20 75	nd.testable.bug.report..If.you.u
68c0	70 67 72 61 64 65 20 79 6f 75 72 20 6b 65 72 6e 65 6c 20 6f 72 20 69 6e 63 6c 75 64 65 20 6e 65	pgrade.your.kernel.or.include.ne
68e0	77 20 64 72 69 76 65 72 73 20 79 6f 75 20 6d 61 79 20 6e 65 65 64 20 6e 65 77 20 66 69 72 6d 77	w.drivers.you.may.need.new.firmw
6900	61 72 65 2e 20 42 75 69 6c 64 20 61 20 6e 65 77 20 60 60 76 79 6f 73 2d 6c 69 6e 75 78 2d 66 69	are..Build.a.new.``vyos-linux-fi
6920	72 6d 77 61 72 65 60 60 20 70 61 63 6b 61 67 65 20 77 69 74 68 20 74 68 65 20 69 6e 63 6c 75 64	rmware``.package.with.the.includ
6940	65 64 20 68 65 6c 70 65 72 20 73 63 72 69 70 74 73 2e 00 49 6e 20 61 20 62 69 67 20 73 79 73 74	ed.helper.scripts..In.a.big.syst
6960	65 6d 2c 20 73 75 63 68 20 61 73 20 56 79 4f 53 2c 20 74 68 61 74 20 69 73 20 63 6f 6d 70 72 69	em,.such.as.VyOS,.that.is.compri
6980	73 65 64 20 6f 66 20 6d 75 6c 74 69 70 6c 65 20 63 6f 6d 70 6f 6e 65 6e 74 73 2c 20 69 74 27 73	sed.of.multiple.components,.it's
69a0	20 69 6d 70 6f 73 73 69 62 6c 65 20 74 6f 20 6b 65 65 70 20 74 72 61 63 6b 20 6f 66 20 61 6c 6c	.impossible.to.keep.track.of.all
69c0	20 74 68 65 20 63 68 61 6e 67 65 73 20 61 6e 64 20 62 75 67 73 2f 66 65 61 74 75 72 65 20 72 65	.the.changes.and.bugs/feature.re
69e0	71 75 65 73 74 73 20 69 6e 20 6f 6e 65 27 73 20 68 65 61 64 2e 20 57 65 20 75 73 65 20 61 20 62	quests.in.one's.head..We.use.a.b
6a00	75 67 74 72 61 63 6b 65 72 20 6b 6e 6f 77 6e 20 61 73 20 50 68 61 62 72 69 63 61 74 6f 72 5f 20	ugtracker.known.as.Phabricator_.
6a20	66 6f 72 20 69 74 20 28 22 69 73 73 75 65 20 74 72 61 63 6b 65 72 22 20 77 6f 75 6c 64 20 62 65	for.it.("issue.tracker".would.be
6a40	20 61 20 62 65 74 74 65 72 20 74 65 72 6d 2c 20 62 75 74 20 74 68 69 73 20 6f 6e 65 20 73 74 75	.a.better.term,.but.this.one.stu
6a60	63 6b 29 2e 00 49 6e 20 61 64 64 69 74 69 6f 6e 20 74 68 69 73 20 61 6c 73 6f 20 68 65 6c 70 73	ck)..In.addition.this.also.helps
6a80	20 77 68 65 6e 20 62 72 6f 77 73 69 6e 67 20 74 68 65 20 47 69 74 48 75 62 20 63 6f 64 65 62 61	.when.browsing.the.GitHub.codeba
6aa0	73 65 20 6f 6e 20 61 20 6d 6f 62 69 6c 65 20 64 65 76 69 63 65 20 69 66 20 79 6f 75 20 68 61 70	se.on.a.mobile.device.if.you.hap
6ac0	70 65 6e 20 74 6f 20 62 65 20 61 20 63 72 61 7a 79 20 73 63 69 65 6e 74 69 73 74 2e 00 49 6e 20	pen.to.be.a.crazy.scientist..In.
6ae0	6f 72 64 65 72 20 74 6f 20 6f 70 65 6e 20 75 70 20 61 20 62 75 67 2d 72 65 70 6f 72 74 2f 66 65	order.to.open.up.a.bug-report/fe
6b00	61 74 75 72 65 20 72 65 71 75 65 73 74 20 79 6f 75 20 6e 65 65 64 20 74 6f 20 63 72 65 61 74 65	ature.request.you.need.to.create
6b20	20 79 6f 75 72 73 65 6c 66 20 61 6e 20 61 63 63 6f 75 6e 74 20 6f 6e 20 56 79 4f 53 20 50 68 61	.yourself.an.account.on.VyOS.Pha
6b40	62 72 69 63 61 74 6f 72 5f 2e 20 4f 6e 20 74 68 65 20 6c 65 66 74 20 73 69 64 65 20 6f 66 20 74	bricator_..On.the.left.side.of.t
6b60	68 65 20 73 70 65 63 69 66 69 63 20 70 72 6f 6a 65 63 74 20 28 56 79 4f 53 20 31 2e 32 20 6f 72	he.specific.project.(VyOS.1.2.or
6b80	20 56 79 4f 53 20 31 2e 33 29 20 79 6f 75 20 77 69 6c 6c 20 66 69 6e 64 20 71 75 69 63 6b 2d 6c	.VyOS.1.3).you.will.find.quick-l
6ba0	69 6e 6b 73 20 66 6f 72 20 6f 70 65 6e 69 6e 67 20 61 20 62 75 67 2d 72 65 70 6f 72 74 2f 66 65	inks.for.opening.a.bug-report/fe
6bc0	61 74 75 72 65 20 72 65 71 75 65 73 74 2e 00 49 6e 20 6f 72 64 65 72 20 74 6f 20 72 65 63 6f 72	ature.request..In.order.to.recor
6be0	64 20 79 6f 75 20 61 73 20 74 68 65 20 61 75 74 68 6f 72 20 6f 66 20 74 68 65 20 66 69 78 20 70	d.you.as.the.author.of.the.fix.p
6c00	6c 65 61 73 65 20 69 64 65 6e 74 69 66 79 20 79 6f 75 72 73 65 6c 66 20 74 6f 20 47 69 74 20 62	lease.identify.yourself.to.Git.b
6c20	79 20 73 65 74 74 69 6e 67 20 75 70 20 79 6f 75 72 20 6e 61 6d 65 20 61 6e 64 20 65 6d 61 69 6c	y.setting.up.your.name.and.email
6c40	2e 20 54 68 69 73 20 63 61 6e 20 62 65 20 64 6f 6e 65 20 6c 6f 63 61 6c 20 66 6f 72 20 74 68 69	..This.can.be.done.local.for.thi
6c60	73 20 6f 6e 65 20 61 6e 64 20 6f 6e 6c 79 20 72 65 70 6f 73 69 74 6f 72 79 20 60 60 67 69 74 20	s.one.and.only.repository.``git.
6c80	63 6f 6e 66 69 67 60 60 20 6f 72 20 67 6c 6f 62 61 6c 6c 79 20 75 73 69 6e 67 20 60 60 67 69 74	config``.or.globally.using.``git
6ca0	20 63 6f 6e 66 69 67 20 2d 2d 67 6c 6f 62 61 6c 60 60 2e 00 49 6e 20 6f 72 64 65 72 20 74 6f 20	.config.--global``..In.order.to.
6cc0	72 65 74 72 69 65 76 65 20 74 68 65 20 64 65 62 75 67 20 6f 75 74 70 75 74 20 6f 6e 20 74 68 65	retrieve.the.debug.output.on.the
6ce0	20 63 6f 6d 6d 61 6e 64 2d 6c 69 6e 65 20 79 6f 75 20 6e 65 65 64 20 74 6f 20 64 69 73 61 62 6c	.command-line.you.need.to.disabl
6d00	65 20 60 60 76 79 6f 73 2d 63 6f 6e 66 69 67 64 60 60 20 69 6e 20 61 64 64 69 74 69 6f 6e 2e 20	e.``vyos-configd``.in.addition..
6d20	54 68 69 73 20 63 61 6e 20 62 65 20 72 75 6e 20 65 69 74 68 65 72 20 6f 6e 65 2d 74 69 6d 65 20	This.can.be.run.either.one-time.
6d40	62 79 20 63 61 6c 6c 69 6e 67 20 60 60 73 75 64 6f 20 73 79 73 74 65 6d 63 74 6c 20 73 74 6f 70	by.calling.``sudo.systemctl.stop
6d60	20 76 79 6f 73 2d 63 6f 6e 66 69 67 64 60 60 20 6f 72 20 6d 61 6b 65 20 74 68 69 73 20 72 65 62	.vyos-configd``.or.make.this.reb
6d80	6f 6f 74 2d 73 61 66 65 20 62 79 20 63 61 6c 6c 69 6e 67 20 60 60 73 75 64 6f 20 73 79 73 74 65	oot-safe.by.calling.``sudo.syste
6da0	6d 63 74 6c 20 64 69 73 61 62 6c 65 20 76 79 6f 73 2d 63 6f 6e 66 69 67 64 60 60 2e 00 49 6e 20	mctl.disable.vyos-configd``..In.
6dc0	73 6f 6d 65 20 63 6f 6e 74 65 78 74 73 2c 20 74 68 65 20 66 69 72 73 74 20 6c 69 6e 65 20 69 73	some.contexts,.the.first.line.is
6de0	20 74 72 65 61 74 65 64 20 61 73 20 74 68 65 20 73 75 62 6a 65 63 74 20 6f 66 20 61 6e 20 65 6d	.treated.as.the.subject.of.an.em
6e00	61 69 6c 20 61 6e 64 20 74 68 65 20 72 65 73 74 20 6f 66 20 74 68 65 20 74 65 78 74 20 61 73 20	ail.and.the.rest.of.the.text.as.
6e20	74 68 65 20 62 6f 64 79 2e 20 54 68 65 20 62 6c 61 6e 6b 20 6c 69 6e 65 20 73 65 70 61 72 61 74	the.body..The.blank.line.separat
6e40	69 6e 67 20 74 68 65 20 73 75 6d 6d 61 72 79 20 66 72 6f 6d 20 74 68 65 20 62 6f 64 79 20 69 73	ing.the.summary.from.the.body.is
6e60	20 63 72 69 74 69 63 61 6c 20 28 75 6e 6c 65 73 73 20 79 6f 75 20 6f 6d 69 74 20 74 68 65 20 62	.critical.(unless.you.omit.the.b
6e80	6f 64 79 20 65 6e 74 69 72 65 6c 79 29 3b 20 74 6f 6f 6c 73 20 6c 69 6b 65 20 72 65 62 61 73 65	ody.entirely);.tools.like.rebase
6ea0	20 63 61 6e 20 67 65 74 20 63 6f 6e 66 75 73 65 64 20 69 66 20 79 6f 75 20 72 75 6e 20 74 68 65	.can.get.confused.if.you.run.the
6ec0	20 74 77 6f 20 74 6f 67 65 74 68 65 72 2e 00 49 6e 20 74 68 65 20 65 6e 64 20 79 6f 75 20 77 69	.two.together..In.the.end.you.wi
6ee0	6c 6c 20 62 65 20 70 72 65 73 65 6e 74 65 64 20 77 69 74 68 20 74 68 65 20 6b 65 72 6e 65 6c 20	ll.be.presented.with.the.kernel.
6f00	62 69 6e 61 72 79 20 70 61 63 6b 61 67 65 73 20 77 68 69 63 68 20 79 6f 75 20 63 61 6e 20 74 68	binary.packages.which.you.can.th
6f20	65 6e 20 75 73 65 20 69 6e 20 79 6f 75 72 20 63 75 73 74 6f 6d 20 49 53 4f 20 62 75 69 6c 64 20	en.use.in.your.custom.ISO.build.
6f40	70 72 6f 63 65 73 73 2c 20 62 79 20 70 6c 61 63 69 6e 67 20 61 6c 6c 20 74 68 65 20 60 2a 2e 64	process,.by.placing.all.the.`*.d
6f60	65 62 60 20 66 69 6c 65 73 20 69 6e 20 74 68 65 20 76 79 6f 73 2d 62 75 69 6c 64 2f 70 61 63 6b	eb`.files.in.the.vyos-build/pack
6f80	61 67 65 73 20 66 6f 6c 64 65 72 20 77 68 65 72 65 20 74 68 65 79 20 77 69 6c 6c 20 62 65 20 75	ages.folder.where.they.will.be.u
6fa0	73 65 64 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 77 68 65 6e 20 62 75 69 6c 64 69 6e 67 20	sed.automatically.when.building.
6fc0	56 79 4f 53 20 61 73 20 64 6f 63 75 6d 65 6e 74 65 64 20 61 62 6f 76 65 2e 00 49 6e 20 74 68 65	VyOS.as.documented.above..In.the
6fe0	20 66 75 74 75 72 65 2c 20 77 65 20 6d 61 79 20 73 77 69 74 63 68 20 74 6f 20 75 73 69 6e 67 20	.future,.we.may.switch.to.using.
7000	73 79 73 74 65 6d 64 20 69 6e 66 72 61 73 74 72 75 63 74 75 72 65 20 69 6e 73 74 65 61 64 2e 20	systemd.infrastructure.instead..
7020	42 75 69 6c 64 69 6e 67 20 69 74 20 64 6f 65 73 6e 27 74 20 72 65 71 75 69 72 65 20 61 20 73 70	Building.it.doesn't.require.a.sp
7040	65 63 69 61 6c 20 70 72 6f 63 65 64 75 72 65 2e 00 49 6e 63 6c 75 64 65 20 6f 75 74 70 75 74 00	ecial.procedure..Include.output.
7060	49 6e 73 65 72 74 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 61 74 65 6d 65 6e 74 20 72	Insert.the.following.statement.r
7080	69 67 68 74 20 62 65 66 6f 72 65 20 74 68 65 20 73 65 63 74 69 6f 6e 20 77 68 65 72 65 20 79 6f	ight.before.the.section.where.yo
70a0	75 20 77 61 6e 74 20 74 6f 20 69 6e 76 65 73 74 69 67 61 74 65 20 61 20 70 72 6f 62 6c 65 6d 20	u.want.to.investigate.a.problem.
70c0	28 65 2e 67 2e 20 61 20 73 74 61 74 65 6d 65 6e 74 20 79 6f 75 20 73 65 65 20 69 6e 20 61 20 62	(e.g..a.statement.you.see.in.a.b
70e0	61 63 6b 74 72 61 63 65 29 3a 20 60 60 69 6d 70 6f 72 74 20 70 64 62 3b 20 70 64 62 2e 73 65 74	acktrace):.``import.pdb;.pdb.set
7100	5f 74 72 61 63 65 28 29 60 60 20 4f 70 74 69 6f 6e 61 6c 6c 79 20 79 6f 75 20 63 61 6e 20 73 75	_trace()``.Optionally.you.can.su
7120	72 72 6f 75 6e 64 65 64 20 74 68 69 73 20 73 74 61 74 65 6d 65 6e 74 20 62 79 20 61 6e 20 60 60	rrounded.this.statement.by.an.``
7140	69 66 60 60 20 77 68 69 63 68 20 6f 6e 6c 79 20 74 72 69 67 67 65 72 73 20 75 6e 64 65 72 20 74	if``.which.only.triggers.under.t
7160	68 65 20 63 6f 6e 64 69 74 69 6f 6e 20 79 6f 75 20 61 72 65 20 69 6e 74 65 72 65 73 74 65 64 20	he.condition.you.are.interested.
7180	69 6e 2e 00 49 6e 73 74 61 6c 6c 00 49 6e 73 74 61 6c 6c 20 68 74 74 70 73 3a 2f 2f 70 79 70 69	in..Install.Install.https://pypi
71a0	2e 6f 72 67 2f 70 72 6f 6a 65 63 74 2f 73 74 64 65 62 2f 00 49 6e 73 74 61 6c 6c 69 6e 67 20 44	.org/project/stdeb/.Installing.D
71c0	6f 63 6b 65 72 5f 20 61 6e 64 20 70 72 65 72 65 71 75 69 73 69 74 65 73 3a 00 49 6e 73 74 65 61	ocker_.and.prerequisites:.Instea
71e0	64 20 6f 66 20 73 75 70 70 6c 79 69 6e 67 20 61 6c 6c 20 74 68 6f 73 65 20 58 4d 4c 20 6e 6f 64	d.of.supplying.all.those.XML.nod
7200	65 73 20 6d 75 6c 74 69 70 6c 65 20 74 69 6d 65 73 20 74 68 65 72 65 20 61 72 65 20 6e 6f 77 20	es.multiple.times.there.are.now.
7220	69 6e 63 6c 75 64 65 20 66 69 6c 65 73 20 77 69 74 68 20 70 72 65 64 65 66 69 6e 65 64 20 66 65	include.files.with.predefined.fe
7240	61 74 75 72 65 73 2e 20 42 72 69 65 66 20 6f 76 65 72 76 69 65 77 3a 00 49 6e 74 65 6c 20 4e 49	atures..Brief.overview:.Intel.NI
7260	43 00 49 6e 74 65 6c 20 4e 49 43 20 64 72 69 76 65 72 73 00 49 6e 74 65 6c 20 51 41 54 00 49 6e	C.Intel.NIC.drivers.Intel.QAT.In
7280	74 65 72 20 51 41 54 00 49 6e 74 65 72 66 61 63 65 20 62 61 73 65 64 20 74 65 73 74 73 00 49 73	ter.QAT.Interface.based.tests.Is
72a0	20 74 68 65 20 66 65 61 74 75 72 65 20 73 75 70 70 6f 72 74 65 64 20 62 79 20 74 68 65 20 75 6e	.the.feature.supported.by.the.un
72c0	64 65 72 6c 79 69 6e 67 20 63 6f 6d 70 6f 6e 65 6e 74 20 28 46 72 65 65 52 61 6e 67 65 52 6f 75	derlying.component.(FreeRangeRou
72e0	74 69 6e 67 2c 20 6e 66 74 61 62 6c 65 73 2c 20 4b 65 61 2e 2e 2e 29 20 61 6c 72 65 61 64 79 3f	ting,.nftables,.Kea...).already?
7300	00 49 73 73 75 65 73 20 6f 72 20 62 75 67 73 20 61 72 65 20 66 6f 75 6e 64 20 69 6e 20 61 6e 79	.Issues.or.bugs.are.found.in.any
7320	20 73 6f 66 74 77 61 72 65 20 70 72 6f 6a 65 63 74 2e 20 56 79 4f 53 20 69 73 20 6e 6f 74 20 61	.software.project..VyOS.is.not.a
7340	6e 20 65 78 63 65 70 74 69 6f 6e 2e 00 49 73 73 75 65 73 2f 46 65 61 74 75 72 65 20 72 65 71 75	n.exception..Issues/Feature.requ
7360	65 73 74 73 00 49 74 20 69 73 20 61 6c 73 6f 20 70 6f 73 73 69 62 6c 65 20 74 6f 20 73 65 74 20	ests.It.is.also.possible.to.set.
7380	75 70 20 74 68 65 20 64 65 62 75 67 67 69 6e 67 20 75 73 69 6e 67 20 65 6e 76 69 72 6f 6e 6d 65	up.the.debugging.using.environme
73a0	6e 74 20 76 61 72 69 61 62 6c 65 73 2e 20 49 6e 20 74 68 61 74 20 63 61 73 65 2c 20 74 68 65 20	nt.variables..In.that.case,.the.
73c0	6e 61 6d 65 20 77 69 6c 6c 20 62 65 20 28 69 6e 20 75 70 70 65 72 63 61 73 65 29 20 56 59 4f 53	name.will.be.(in.uppercase).VYOS
73e0	5f 46 45 41 54 55 52 45 5f 44 45 42 55 47 2e 00 49 74 27 73 20 61 6e 20 41 64 61 20 70 72 6f 67	_FEATURE_DEBUG..It's.an.Ada.prog
7400	72 61 6d 20 61 6e 64 20 72 65 71 75 69 72 65 73 20 47 4e 41 54 20 61 6e 64 20 67 70 72 62 75 69	ram.and.requires.GNAT.and.gprbui
7420	6c 64 20 66 6f 72 20 62 75 69 6c 64 69 6e 67 2c 20 64 65 70 65 6e 64 65 6e 63 69 65 73 20 61 72	ld.for.building,.dependencies.ar
7440	65 20 70 72 6f 70 65 72 6c 79 20 73 70 65 63 69 66 69 65 64 20 73 6f 20 6a 75 73 74 20 66 6f 6c	e.properly.specified.so.just.fol
7460	6c 6f 77 20 64 65 62 75 69 6c 64 27 73 20 73 75 67 67 65 73 74 69 6f 6e 73 2e 00 49 74 27 73 20	low.debuild's.suggestions..It's.
7480	66 69 6e 65 20 69 66 20 79 6f 75 20 63 61 6e 6e 6f 74 20 70 72 6f 76 69 64 65 20 73 6f 6d 65 20	fine.if.you.cannot.provide.some.
74a0	6f 66 20 74 68 61 74 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2c 20 62 75 74 20 69 66 20 79 6f 75 20	of.that.information,.but.if.you.
74c0	63 61 6e 2c 20 69 74 20 6d 61 6b 65 73 20 74 68 65 20 77 6f 72 6b 20 6f 66 20 64 65 76 65 6c 6f	can,.it.makes.the.work.of.develo
74e0	70 65 72 73 20 63 6f 6e 73 69 64 65 72 61 62 6c 79 20 73 69 6d 70 6c 65 72 2c 20 73 6f 20 74 72	pers.considerably.simpler,.so.tr
7500	79 20 74 6f 20 64 6f 20 74 68 65 20 72 65 73 65 61 72 63 68 20 74 6f 20 61 6e 73 77 65 72 20 74	y.to.do.the.research.to.answer.t
7520	68 6f 73 65 20 71 75 65 73 74 69 6f 6e 73 2e 00 4a 65 6e 6b 69 6e 73 20 43 49 00 4a 75 73 74 20	hose.questions..Jenkins.CI.Just.
7540	69 6e 73 74 61 6c 6c 20 75 73 69 6e 67 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 63 6f 6d 6d	install.using.the.following.comm
7560	61 6e 64 73 3a 00 4b 65 65 70 20 74 72 61 63 6b 20 6f 66 20 74 68 65 20 70 72 6f 67 72 65 73 73	ands:.Keep.track.of.the.progress
7580	20 28 77 68 61 74 20 77 65 27 76 65 20 61 6c 72 65 61 64 79 20 64 6f 6e 65 20 69 6e 20 74 68 69	.(what.we've.already.done.in.thi
75a0	73 20 62 72 61 6e 63 68 20 61 6e 64 20 77 68 61 74 20 77 65 20 73 74 69 6c 6c 20 6e 65 65 64 20	s.branch.and.what.we.still.need.
75c0	74 6f 20 64 6f 29 2e 00 4b 65 65 70 61 6c 69 76 65 64 20 6e 6f 72 6d 61 6c 6c 79 20 69 73 6e 27	to.do)..Keepalived.normally.isn'
75e0	74 20 75 70 64 61 74 65 64 20 74 6f 20 6e 65 77 65 72 20 66 65 61 74 75 72 65 20 72 65 6c 65 61	t.updated.to.newer.feature.relea
7600	73 65 73 20 62 65 74 77 65 65 6e 20 44 65 62 69 61 6e 20 76 65 72 73 69 6f 6e 73 2c 20 73 6f 20	ses.between.Debian.versions,.so.
7620	77 65 20 61 72 65 20 62 75 69 6c 64 69 6e 67 20 69 74 20 66 72 6f 6d 20 73 6f 75 72 63 65 2e 00	we.are.building.it.from.source..
7640	4b 65 72 6e 65 6c 00 4c 61 75 6e 63 68 20 44 6f 63 6b 65 72 20 63 6f 6e 74 61 69 6e 65 72 20 61	Kernel.Launch.Docker.container.a
7660	6e 64 20 62 75 69 6c 64 20 70 61 63 6b 61 67 65 00 4c 65 61 66 20 6e 6f 64 65 73 20 28 6e 6f 64	nd.build.package.Leaf.nodes.(nod
7680	65 73 20 77 69 74 68 20 76 61 6c 75 65 73 29 20 75 73 65 20 3c 6c 65 61 66 4e 6f 64 65 3e 20 74	es.with.values).use.<leafNode>.t
76a0	61 67 20 69 6e 73 74 65 61 64 00 4c 65 74 20 75 73 20 61 73 73 75 6d 65 20 79 6f 75 20 77 61 6e	ag.instead.Let.us.assume.you.wan
76c0	74 20 74 6f 20 64 65 62 75 67 20 61 20 50 79 74 68 6f 6e 20 73 63 72 69 70 74 20 74 68 61 74 20	t.to.debug.a.Python.script.that.
76e0	69 73 20 63 61 6c 6c 65 64 20 62 79 20 61 6e 20 6f 70 2d 6d 6f 64 65 20 63 6f 6d 6d 61 6e 64 2e	is.called.by.an.op-mode.command.
7700	20 41 66 74 65 72 20 79 6f 75 20 66 6f 75 6e 64 20 74 68 65 20 73 63 72 69 70 74 20 62 79 20 6c	.After.you.found.the.script.by.l
7720	6f 6f 6b 69 6e 67 20 75 70 20 74 68 65 20 6f 70 2d 6d 6f 64 65 2d 64 65 66 69 74 69 6f 6e 73 20	ooking.up.the.op-mode-defitions.
7740	79 6f 75 20 63 61 6e 20 65 64 69 74 20 74 68 65 20 73 63 72 69 70 74 20 69 6e 20 74 68 65 20 6c	you.can.edit.the.script.in.the.l
7760	69 76 65 20 73 79 73 74 65 6d 20 75 73 69 6e 67 20 65 2e 67 2e 20 76 69 3a 20 60 60 76 69 20 2f	ive.system.using.e.g..vi:.``vi./
7780	75 73 72 2f 6c 69 62 65 78 65 63 2f 76 79 6f 73 2f 6f 70 5f 6d 6f 64 65 2f 73 68 6f 77 5f 78 79	usr/libexec/vyos/op_mode/show_xy
77a0	7a 2e 70 79 60 60 00 4c 65 74 27 73 20 66 61 63 65 20 69 74 3a 20 56 79 4f 53 20 69 73 20 66 75	z.py``.Let's.face.it:.VyOS.is.fu
77c0	6c 6c 20 6f 66 20 73 70 61 67 68 65 74 74 69 20 63 6f 64 65 20 77 68 65 72 65 20 6c 6f 67 69 63	ll.of.spaghetti.code.where.logic
77e0	20 66 6f 72 20 72 65 61 64 69 6e 67 20 74 68 65 20 56 79 4f 53 20 63 6f 6e 66 69 67 2c 20 67 65	.for.reading.the.VyOS.config,.ge
7800	6e 65 72 61 74 69 6e 67 20 64 61 65 6d 6f 6e 20 63 6f 6e 66 69 67 73 2c 20 61 6e 64 20 72 65 73	nerating.daemon.configs,.and.res
7820	74 61 72 74 69 6e 67 20 70 72 6f 63 65 73 73 65 73 20 69 73 20 61 6c 6c 20 6d 69 78 65 64 20 75	tarting.processes.is.all.mixed.u
7840	70 2e 00 4c 69 6b 65 20 61 6e 79 20 6f 74 68 65 72 20 70 72 6f 6a 65 63 74 20 77 65 20 68 61 76	p..Like.any.other.project.we.hav
7860	65 20 73 6f 6d 65 20 73 6d 61 6c 6c 20 67 75 69 64 65 6c 69 6e 65 73 20 61 62 6f 75 74 20 6f 75	e.some.small.guidelines.about.ou
7880	72 20 73 6f 75 72 63 65 20 63 6f 64 65 2c 20 74 6f 6f 2e 20 54 68 65 20 72 75 6c 65 73 20 77 65	r.source.code,.too..The.rules.we
78a0	20 68 61 76 65 20 61 72 65 20 6e 6f 74 20 74 68 65 72 65 20 74 6f 20 70 75 6e 69 73 68 20 79 6f	.have.are.not.there.to.punish.yo
78c0	75 20 2d 20 74 68 65 20 72 75 6c 65 73 20 61 72 65 20 69 6e 20 70 6c 61 63 65 20 74 6f 20 68 65	u.-.the.rules.are.in.place.to.he
78e0	6c 70 20 75 73 20 61 6c 6c 2e 20 42 79 20 68 61 76 69 6e 67 20 61 20 63 6f 6e 73 69 73 74 65 6e	lp.us.all..By.having.a.consisten
7900	74 20 63 6f 64 69 6e 67 20 73 74 79 6c 65 20 69 74 20 62 65 63 6f 6d 65 73 20 76 65 72 79 20 65	t.coding.style.it.becomes.very.e
7920	61 73 79 20 66 6f 72 20 6e 65 77 20 61 6e 64 20 61 6c 73 6f 20 6c 6f 6e 67 74 69 6d 65 20 63 6f	asy.for.new.and.also.longtime.co
7940	6e 74 72 69 62 75 74 6f 72 73 20 74 6f 20 6e 61 76 69 67 61 74 65 20 74 68 72 6f 75 67 68 20 74	ntributors.to.navigate.through.t
7960	68 65 20 73 6f 75 72 63 65 73 20 61 6e 64 20 61 6c 6c 20 74 68 65 20 69 6d 70 6c 69 65 64 20 6c	he.sources.and.all.the.implied.l
7980	6f 67 69 63 20 6f 66 20 61 6e 79 20 6f 6e 65 20 73 6f 75 72 63 65 20 66 69 6c 65 2e 2e 00 4c 69	ogic.of.any.one.source.file...Li
79a0	6d 69 74 73 3a 00 4c 69 6e 75 78 20 4b 65 72 6e 65 6c 00 4c 69 76 65 20 53 79 73 74 65 6d 00 4d	mits:.Linux.Kernel.Live.System.M
79c0	54 55 20 73 69 7a 65 00 4d 61 6b 65 20 79 6f 75 72 20 63 68 61 6e 67 65 73 20 61 6e 64 20 73 61	TU.size.Make.your.changes.and.sa
79e0	76 65 20 74 68 65 6d 2e 20 44 6f 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 66 6f 72 20 61 6c	ve.them..Do.the.following.for.al
7a00	6c 20 63 68 61 6e 67 65 73 20 66 69 6c 65 73 20 74 6f 20 72 65 63 6f 72 64 20 74 68 65 6d 20 69	l.changes.files.to.record.them.i
7a20	6e 20 79 6f 75 72 20 63 72 65 61 74 65 64 20 47 69 74 20 63 6f 6d 6d 69 74 3a 00 4d 61 6e 75 61	n.your.created.Git.commit:.Manua
7a40	6c 20 53 6d 6f 6b 65 74 65 73 74 20 52 75 6e 00 4d 61 6e 75 61 6c 20 63 6f 6e 66 69 67 20 6c 6f	l.Smoketest.Run.Manual.config.lo
7a60	61 64 20 74 65 73 74 00 4d 61 6e 79 20 62 61 73 65 20 73 79 73 74 65 6d 20 70 61 63 6b 61 67 65	ad.test.Many.base.system.package
7a80	73 20 61 72 65 20 70 75 6c 6c 65 64 20 73 74 72 61 69 67 68 74 20 66 72 6f 6d 20 44 65 62 69 61	s.are.pulled.straight.from.Debia
7aa0	6e 27 73 20 6d 61 69 6e 20 61 6e 64 20 63 6f 6e 74 72 69 62 20 72 65 70 6f 73 69 74 6f 72 69 65	n's.main.and.contrib.repositorie
7ac0	73 2c 20 62 75 74 20 74 68 65 72 65 20 61 72 65 20 65 78 63 65 70 74 69 6f 6e 73 2e 00 4d 65 6c	s,.but.there.are.exceptions..Mel
7ae0	6c 61 6e 6f 78 20 4f 46 45 44 00 4d 69 67 72 61 74 69 6e 67 20 6f 6c 64 20 43 4c 49 00 4d 6f 76	lanox.OFED.Migrating.old.CLI.Mov
7b00	65 20 64 65 66 61 75 6c 74 20 76 61 6c 75 65 73 20 74 6f 20 73 63 72 69 70 74 73 00 4e 61 74 69	e.default.values.to.scripts.Nati
7b20	76 65 20 42 75 69 6c 64 00 4e 65 77 20 73 79 6e 74 61 78 00 4e 6f 20 63 6f 64 65 20 69 6e 63 6f	ve.Build.New.syntax.No.code.inco
7b40	6d 70 61 74 69 62 6c 65 20 77 69 74 68 20 50 79 74 68 6f 6e 33 00 4e 6f 20 6e 65 77 20 66 65 61	mpatible.with.Python3.No.new.fea
7b60	74 75 72 65 73 20 69 6e 20 50 65 72 6c 00 4e 6f 20 6f 6c 64 20 73 74 79 6c 65 20 63 6f 6d 6d 61	tures.in.Perl.No.old.style.comma
7b80	6e 64 20 64 65 66 69 6e 69 74 69 6f 6e 73 00 4e 6f 20 73 70 65 63 69 61 6c 20 62 75 69 6c 64 20	nd.definitions.No.special.build.
7ba0	70 72 6f 63 65 64 75 72 65 20 69 73 20 72 65 71 75 69 72 65 64 2e 00 4e 6f 6e 65 00 4e 6f 74 65	procedure.is.required..None.Note
7bc0	73 00 4e 6f 77 20 61 20 66 72 65 73 68 20 62 75 69 6c 64 20 6f 66 20 74 68 65 20 56 79 4f 53 20	s.Now.a.fresh.build.of.the.VyOS.
7be0	49 53 4f 20 63 61 6e 20 62 65 67 69 6e 2e 20 43 68 61 6e 67 65 20 64 69 72 65 63 74 6f 72 79 20	ISO.can.begin..Change.directory.
7c00	74 6f 20 74 68 65 20 60 60 76 79 6f 73 2d 62 75 69 6c 64 60 60 20 64 69 72 65 63 74 6f 72 79 20	to.the.``vyos-build``.directory.
7c20	61 6e 64 20 72 75 6e 3a 00 4e 6f 77 20 61 73 20 79 6f 75 20 61 72 65 20 61 77 61 72 65 20 6f 66	and.run:.Now.as.you.are.aware.of
7c40	20 74 68 65 20 70 72 65 72 65 71 75 69 73 69 74 65 73 20 77 65 20 63 61 6e 20 63 6f 6e 74 69 6e	.the.prerequisites.we.can.contin
7c60	75 65 20 61 6e 64 20 62 75 69 6c 64 20 6f 75 72 20 6f 77 6e 20 49 53 4f 20 66 72 6f 6d 20 73 6f	ue.and.build.our.own.ISO.from.so
7c80	75 72 63 65 2e 20 46 6f 72 20 74 68 69 73 20 77 65 20 68 61 76 65 20 74 6f 20 66 65 74 63 68 20	urce..For.this.we.have.to.fetch.
7ca0	74 68 65 20 6c 61 74 65 73 74 20 73 6f 75 72 63 65 20 63 6f 64 65 20 66 72 6f 6d 20 47 69 74 48	the.latest.source.code.from.GitH
7cc0	75 62 2e 20 50 6c 65 61 73 65 20 6e 6f 74 65 20 61 73 20 74 68 69 73 20 77 69 6c 6c 20 64 69 66	ub..Please.note.as.this.will.dif
7ce0	66 65 72 20 66 6f 72 20 62 6f 74 68 20 60 63 75 72 72 65 6e 74 60 20 61 6e 64 20 60 63 72 75 78	fer.for.both.`current`.and.`crux
7d00	60 2e 00 4e 6f 77 20 69 74 27 73 20 74 69 6d 65 20 74 6f 20 66 69 78 20 74 68 65 20 70 61 63 6b	`..Now.it's.time.to.fix.the.pack
7d20	61 67 65 20 6d 69 72 72 6f 72 20 61 6e 64 20 72 65 72 75 6e 20 74 68 65 20 6c 61 73 74 20 73 74	age.mirror.and.rerun.the.last.st
7d40	65 70 20 75 6e 74 69 6c 20 74 68 65 20 70 61 63 6b 61 67 65 20 69 6e 73 74 61 6c 6c 61 74 69 6f	ep.until.the.package.installatio
7d60	6e 20 73 75 63 63 65 65 64 73 20 61 67 61 69 6e 21 00 4e 6f 77 20 77 65 20 63 61 6e 20 75 73 65	n.succeeds.again!.Now.we.can.use
7d80	20 74 68 65 20 68 65 6c 70 65 72 20 73 63 72 69 70 74 20 60 60 62 75 69 6c 64 2d 6b 65 72 6e 65	.the.helper.script.``build-kerne
7da0	6c 2e 73 68 60 60 20 77 68 69 63 68 20 64 6f 65 73 20 61 6c 6c 20 74 68 65 20 6e 65 63 65 73 73	l.sh``.which.does.all.the.necess
7dc0	61 72 79 20 76 6f 6f 64 6f 6f 20 62 79 20 61 70 70 6c 79 69 6e 67 20 72 65 71 75 69 72 65 64 20	ary.voodoo.by.applying.required.
7de0	70 61 74 63 68 65 73 20 66 72 6f 6d 20 74 68 65 20 60 76 79 6f 73 2d 62 75 69 6c 64 2f 70 61 63	patches.from.the.`vyos-build/pac
7e00	6b 61 67 65 73 2f 6c 69 6e 75 78 2d 6b 65 72 6e 65 6c 2f 70 61 74 63 68 65 73 60 20 66 6f 6c 64	kages/linux-kernel/patches`.fold
7e20	65 72 2c 20 63 6f 70 79 69 6e 67 20 6f 75 72 20 6b 65 72 6e 65 6c 20 63 6f 6e 66 69 67 75 72 61	er,.copying.our.kernel.configura
7e40	74 69 6f 6e 20 60 60 78 38 36 5f 36 34 5f 76 79 6f 73 5f 64 65 66 63 6f 6e 66 69 67 60 60 20 74	tion.``x86_64_vyos_defconfig``.t
7e60	6f 20 74 68 65 20 72 69 67 68 74 20 6c 6f 63 61 74 69 6f 6e 2c 20 61 6e 64 20 66 69 6e 61 6c 6c	o.the.right.location,.and.finall
7e80	79 20 62 75 69 6c 64 69 6e 67 20 74 68 65 20 44 65 62 69 61 6e 20 70 61 63 6b 61 67 65 73 2e 00	y.building.the.Debian.packages..
7ea0	4e 6f 77 20 79 6f 75 20 61 72 65 20 70 72 65 70 61 72 65 64 20 77 69 74 68 20 74 77 6f 20 6e 65	Now.you.are.prepared.with.two.ne
7ec0	77 20 61 6c 69 61 73 65 73 20 60 60 76 79 62 6c 64 60 60 20 61 6e 64 20 60 60 76 79 62 6c 64 5f	w.aliases.``vybld``.and.``vybld_
7ee0	63 72 75 78 60 60 20 74 6f 20 73 70 61 77 6e 20 79 6f 75 72 20 64 65 76 65 6c 6f 70 6d 65 6e 74	crux``.to.spawn.your.development
7f00	20 63 6f 6e 74 61 69 6e 65 72 73 20 69 6e 20 79 6f 75 72 20 63 75 72 72 65 6e 74 20 77 6f 72 6b	.containers.in.your.current.work
7f20	69 6e 67 20 64 69 72 65 63 74 6f 72 79 2e 00 4f 6c 64 20 63 6f 6e 63 65 70 74 2f 73 79 6e 74 61	ing.directory..Old.concept/synta
7f40	78 00 4f 6e 20 74 68 65 20 6f 74 68 65 72 20 68 61 6e 64 20 2d 20 61 73 20 65 61 63 68 20 74 65	x.On.the.other.hand.-.as.each.te
7f60	73 74 20 69 73 20 63 6f 6e 74 61 69 6e 20 69 6e 20 69 74 73 20 6f 77 6e 20 66 69 6c 65 20 2d 20	st.is.contain.in.its.own.file.-.
7f80	6f 6e 65 20 63 61 6e 20 61 6c 77 61 79 73 20 65 78 65 63 75 74 65 20 61 20 73 69 6e 67 6c 65 20	one.can.always.execute.a.single.
7fa0	53 6d 6f 6b 65 74 65 73 74 20 62 79 20 68 61 6e 64 20 62 79 20 73 69 6d 70 6c 79 20 72 75 6e 6e	Smoketest.by.hand.by.simply.runn
7fc0	69 6e 67 20 74 68 65 20 50 79 74 68 6f 6e 20 74 65 73 74 20 73 63 72 69 70 74 73 2e 00 4f 6e 63	ing.the.Python.test.scripts..Onc
7fe0	65 20 79 6f 75 20 68 61 76 65 20 74 68 65 20 72 65 71 75 69 72 65 64 20 64 65 70 65 6e 64 65 6e	e.you.have.the.required.dependen
8000	63 69 65 73 20 69 6e 73 74 61 6c 6c 65 64 2c 20 79 6f 75 20 6d 61 79 20 70 72 6f 63 65 65 64 20	cies.installed,.you.may.proceed.
8020	77 69 74 68 20 74 68 65 20 73 74 65 70 73 20 64 65 73 63 72 69 62 65 64 20 69 6e 20 3a 72 65 66	with.the.steps.described.in.:ref
8040	3a 60 62 75 69 6c 64 5f 69 73 6f 60 2e 00 4f 6e 63 65 20 79 6f 75 20 72 75 6e 20 60 60 73 68 6f	:`build_iso`..Once.you.run.``sho
8060	77 20 78 79 7a 60 60 20 61 6e 64 20 79 6f 75 72 20 63 6f 6e 64 69 74 69 6f 6e 20 69 73 20 74 72	w.xyz``.and.your.condition.is.tr
8080	69 67 67 65 72 65 64 20 79 6f 75 20 73 68 6f 75 6c 64 20 62 65 20 64 72 6f 70 70 65 64 20 69 6e	iggered.you.should.be.dropped.in
80a0	74 6f 20 74 68 65 20 70 79 74 68 6f 6e 20 64 65 62 75 67 67 65 72 3a 00 4f 6e 65 20 69 73 20 6e	to.the.python.debugger:.One.is.n
80c0	6f 74 20 62 6f 75 6e 64 20 74 6f 20 6c 6f 61 64 20 61 6c 6c 20 63 6f 6e 66 69 67 75 72 61 74 69	ot.bound.to.load.all.configurati
80e0	6f 6e 73 20 6f 6e 65 20 61 66 74 65 72 20 61 6e 6f 74 68 65 72 20 62 75 74 20 63 61 6e 20 61 6c	ons.one.after.another.but.can.al
8100	73 6f 20 6c 6f 61 64 20 69 6e 64 69 76 69 64 75 61 6c 20 74 65 73 74 20 63 6f 6e 66 69 67 75 72	so.load.individual.test.configur
8120	61 74 69 6f 6e 73 20 6f 6e 20 68 69 73 20 6f 77 6e 2e 00 4f 6e 65 20 6f 66 20 74 68 65 20 6d 61	ations.on.his.own..One.of.the.ma
8140	6a 6f 72 20 61 64 76 61 6e 74 61 67 65 73 20 69 6e 74 72 6f 64 75 63 65 64 20 69 6e 20 56 79 4f	jor.advantages.introduced.in.VyO
8160	53 20 31 2e 33 20 69 73 20 61 6e 20 61 75 74 6d 61 74 65 64 20 74 65 73 74 20 66 72 61 6d 65 77	S.1.3.is.an.autmated.test.framew
8180	6f 72 6b 2e 20 57 68 65 6e 20 61 73 73 65 6d 62 6c 69 6e 67 20 61 6e 20 49 53 4f 20 69 6d 61 67	ork..When.assembling.an.ISO.imag
81a0	65 20 6d 75 6c 74 69 70 6c 65 20 74 68 69 6e 67 73 20 63 61 6e 20 67 6f 20 77 72 6f 6e 67 20 62	e.multiple.things.can.go.wrong.b
81c0	61 64 6c 79 20 61 6e 64 20 70 75 62 6c 69 73 68 69 6e 67 20 61 20 66 61 75 6c 74 79 20 49 53 4f	adly.and.publishing.a.faulty.ISO
81e0	20 6d 61 6b 65 73 20 6e 6f 20 73 65 6e 73 65 2e 20 54 68 65 20 75 73 65 72 20 69 73 20 64 69 73	.makes.no.sense..The.user.is.dis
8200	61 70 70 6f 69 6e 74 65 64 20 62 79 20 74 68 65 20 71 75 61 6c 69 74 79 20 6f 66 20 74 68 65 20	appointed.by.the.quality.of.the.
8220	69 6d 61 67 65 20 61 6e 64 20 74 68 65 20 64 65 76 65 6c 6f 70 65 72 73 20 67 65 74 20 66 6c 6f	image.and.the.developers.get.flo
8240	64 64 65 64 20 77 69 74 68 20 62 75 67 20 72 65 70 6f 72 74 73 20 6f 76 65 72 20 61 6e 64 20 6f	dded.with.bug.reports.over.and.o
8260	76 65 72 20 61 67 61 69 6e 2e 00 4f 6e 65 20 6f 66 20 74 68 65 20 6d 61 6a 6f 72 20 61 64 76 61	ver.again..One.of.the.major.adva
8280	6e 74 61 67 65 73 20 69 6e 74 72 6f 64 75 63 65 64 20 69 6e 20 56 79 4f 53 20 31 2e 33 20 69 73	ntages.introduced.in.VyOS.1.3.is
82a0	20 61 6e 20 61 75 74 6f 6d 61 74 65 64 20 74 65 73 74 20 66 72 61 6d 65 77 6f 72 6b 2e 20 57 68	.an.automated.test.framework..Wh
82c0	65 6e 20 61 73 73 65 6d 62 6c 69 6e 67 20 61 6e 20 49 53 4f 20 69 6d 61 67 65 20 6d 75 6c 74 69	en.assembling.an.ISO.image.multi
82e0	70 6c 65 20 74 68 69 6e 67 73 20 63 61 6e 20 67 6f 20 77 72 6f 6e 67 20 62 61 64 6c 79 20 61 6e	ple.things.can.go.wrong.badly.an
8300	64 20 70 75 62 6c 69 73 68 69 6e 67 20 61 20 66 61 75 6c 74 79 20 49 53 4f 20 6d 61 6b 65 73 20	d.publishing.a.faulty.ISO.makes.
8320	6e 6f 20 73 65 6e 73 65 2e 20 54 68 65 20 75 73 65 72 20 69 73 20 64 69 73 61 70 70 6f 69 6e 74	no.sense..The.user.is.disappoint
8340	65 64 20 62 79 20 74 68 65 20 71 75 61 6c 69 74 79 20 6f 66 20 74 68 65 20 69 6d 61 67 65 20 61	ed.by.the.quality.of.the.image.a
8360	6e 64 20 74 68 65 20 64 65 76 65 6c 6f 70 65 72 73 20 67 65 74 20 66 6c 6f 64 64 65 64 20 77 69	nd.the.developers.get.flodded.wi
8380	74 68 20 62 75 67 20 72 65 70 6f 72 74 73 20 6f 76 65 72 20 61 6e 64 20 6f 76 65 72 20 61 67 61	th.bug.reports.over.and.over.aga
83a0	69 6e 2e 00 4f 6e 6c 79 20 61 70 70 6c 69 63 61 62 6c 65 20 74 6f 20 6c 65 61 66 20 6e 6f 64 65	in..Only.applicable.to.leaf.node
83c0	73 00 4f 74 68 65 72 20 70 61 63 6b 61 67 65 73 20 28 65 2e 67 2e 20 76 79 6f 73 2d 31 78 29 20	s.Other.packages.(e.g..vyos-1x).
83e0	61 64 64 20 64 65 70 65 6e 64 65 6e 63 69 65 73 20 74 6f 20 74 68 65 20 49 53 4f 20 62 75 69 6c	add.dependencies.to.the.ISO.buil
8400	64 20 70 72 6f 63 65 64 75 72 65 20 6f 6e 20 65 2e 67 2e 20 74 68 65 20 77 69 72 65 67 75 61 72	d.procedure.on.e.g..the.wireguar
8420	64 2d 6d 6f 64 75 6c 65 73 20 70 61 63 6b 61 67 65 20 77 68 69 63 68 20 69 74 73 65 6c 66 20 61	d-modules.package.which.itself.a
8440	64 64 73 20 61 20 64 65 70 65 6e 64 65 6e 63 79 20 6f 6e 20 74 68 65 20 6b 65 72 6e 65 6c 20 76	dds.a.dependency.on.the.kernel.v
8460	65 72 73 69 6f 6e 20 75 73 65 64 20 64 75 65 20 74 6f 20 74 68 65 20 6d 6f 64 75 6c 65 20 69 74	ersion.used.due.to.the.module.it
8480	20 73 68 69 70 73 2e 20 54 68 69 73 20 6d 61 79 20 63 68 61 6e 67 65 20 28 66 6f 72 20 57 69 72	.ships..This.may.change.(for.Wir
84a0	65 47 75 61 72 64 29 20 69 6e 20 66 75 74 75 72 65 20 6b 65 72 6e 65 6c 20 72 65 6c 65 61 73 65	eGuard).in.future.kernel.release
84c0	73 20 62 75 74 20 61 73 20 6c 6f 6e 67 20 61 73 20 77 65 20 68 61 76 65 20 6f 75 74 2d 6f 66 2d	s.but.as.long.as.we.have.out-of-
84e0	74 72 65 65 20 6d 6f 64 75 6c 65 73 2e 00 4f 75 72 20 53 74 72 6f 6e 67 53 57 41 4e 20 62 75 69	tree.modules..Our.StrongSWAN.bui
8500	6c 64 20 64 69 66 66 65 72 73 20 66 72 6f 6d 20 74 68 65 20 75 70 73 74 72 65 61 6d 3a 00 4f 75	ld.differs.from.the.upstream:.Ou
8520	72 20 60 56 79 4f 53 20 43 49 60 5f 20 73 79 73 74 65 6d 20 69 73 20 62 61 73 65 64 20 6f 6e 20	r.`VyOS.CI`_.system.is.based.on.
8540	4a 65 6e 6b 69 6e 73 20 61 6e 64 20 62 75 69 6c 64 73 20 61 6c 6c 20 6f 75 72 20 72 65 71 75 69	Jenkins.and.builds.all.our.requi
8560	72 65 64 20 70 61 63 6b 61 67 65 73 20 66 6f 72 20 56 79 4f 53 20 31 2e 32 20 74 6f 20 31 2e 34	red.packages.for.VyOS.1.2.to.1.4
8580	2e 20 49 6e 20 61 64 64 69 74 69 6f 6e 20 74 6f 20 74 68 65 20 70 61 63 6b 61 67 65 20 62 75 69	..In.addition.to.the.package.bui
85a0	6c 64 2c 20 74 68 65 72 65 20 69 73 20 74 68 65 20 76 79 6f 73 2d 62 75 69 6c 64 20 4a 6f 62 20	ld,.there.is.the.vyos-build.Job.
85c0	77 68 69 63 68 20 62 75 69 6c 64 73 20 61 6e 64 20 74 65 73 74 73 20 74 68 65 20 56 79 4f 53 20	which.builds.and.tests.the.VyOS.
85e0	49 53 4f 20 69 6d 61 67 65 20 77 68 69 63 68 20 69 73 20 70 75 62 6c 69 73 68 65 64 20 61 66 74	ISO.image.which.is.published.aft
8600	65 72 20 61 20 73 75 63 63 65 73 73 66 75 6c 20 74 65 73 74 20 64 72 69 76 65 2e 00 4f 75 72 20	er.a.successful.test.drive..Our.
8620	60 56 79 4f 53 20 43 49 60 5f 20 73 79 73 74 65 6d 20 69 73 20 62 61 73 65 64 20 6f 6e 20 4a 65	`VyOS.CI`_.system.is.based.on.Je
8640	6e 6b 69 6e 73 20 61 6e 64 20 62 75 69 6c 64 73 20 61 6c 6c 20 6f 75 72 20 72 65 71 75 69 72 65	nkins.and.builds.all.our.require
8660	64 20 70 61 63 6b 61 67 65 73 20 66 6f 72 20 56 79 4f 53 20 31 2e 32 20 74 6f 20 31 2e 34 2e 20	d.packages.for.VyOS.1.2.to.1.4..
8680	49 6e 20 61 64 64 69 74 69 6f 6e 20 74 6f 20 74 68 65 20 70 61 63 6b 61 67 65 20 62 75 69 6c 64	In.addition.to.the.package.build
86a0	2c 20 74 68 65 72 65 20 69 73 20 74 68 65 20 76 79 6f 73 2d 62 75 69 6c 64 20 4a 6f 62 20 77 68	,.there.is.the.vyos-build.Job.wh
86c0	69 63 68 20 62 75 69 6c 64 73 20 61 6e 64 20 74 65 73 74 73 20 74 68 65 20 56 79 4f 53 20 49 53	ich.builds.and.tests.the.VyOS.IS
86e0	4f 20 69 6d 61 67 65 20 77 68 69 63 68 20 69 73 20 70 75 62 6c 69 73 68 65 64 20 61 66 74 65 72	O.image.which.is.published.after
8700	20 61 20 73 75 63 63 65 73 73 66 75 6c 6c 20 74 65 73 74 20 64 72 69 76 65 2e 00 4f 75 72 20 63	.a.successfull.test.drive..Our.c
8720	6f 64 65 20 69 73 20 73 70 6c 69 74 20 69 6e 74 6f 20 73 65 76 65 72 61 6c 20 6d 6f 64 75 6c 65	ode.is.split.into.several.module
8740	73 2e 20 56 79 4f 53 20 69 73 20 63 6f 6d 70 6f 73 65 64 20 6f 66 20 6d 75 6c 74 69 70 6c 65 20	s..VyOS.is.composed.of.multiple.
8760	69 6e 64 69 76 69 64 75 61 6c 20 70 61 63 6b 61 67 65 73 2c 20 73 6f 6d 65 20 6f 66 20 74 68 65	individual.packages,.some.of.the
8780	6d 20 61 72 65 20 66 6f 72 6b 73 20 6f 66 20 75 70 73 74 72 65 61 6d 20 70 61 63 6b 61 67 65 73	m.are.forks.of.upstream.packages
87a0	20 61 6e 64 20 61 72 65 20 70 65 72 69 6f 64 69 63 61 6c 6c 79 20 73 79 6e 63 65 64 20 77 69 74	.and.are.periodically.synced.wit
87c0	68 20 75 70 73 74 72 65 61 6d 2c 20 73 6f 20 6b 65 65 70 69 6e 67 20 74 68 65 20 77 68 6f 6c 65	h.upstream,.so.keeping.the.whole
87e0	20 73 6f 75 72 63 65 20 75 6e 64 65 72 20 61 20 73 69 6e 67 6c 65 20 72 65 70 6f 73 69 74 6f 72	.source.under.a.single.repositor
8800	79 20 77 6f 75 6c 64 20 62 65 20 76 65 72 79 20 69 6e 63 6f 6e 76 65 6e 69 65 6e 74 20 61 6e 64	y.would.be.very.inconvenient.and
8820	20 73 6c 6f 77 2e 20 54 68 65 72 65 20 69 73 20 6e 6f 77 20 61 6e 20 6f 6e 67 6f 69 6e 67 20 65	.slow..There.is.now.an.ongoing.e
8840	66 66 6f 72 74 20 74 6f 20 63 6f 6e 73 6f 6c 69 64 61 74 65 20 61 6c 6c 20 56 79 4f 53 2d 73 70	ffort.to.consolidate.all.VyOS-sp
8860	65 63 69 66 69 63 20 66 72 61 6d 65 77 6f 72 6b 2f 63 6f 6e 66 69 67 20 70 61 63 6b 61 67 65 73	ecific.framework/config.packages
8880	20 69 6e 74 6f 20 76 79 6f 73 2d 31 78 20 70 61 63 6b 61 67 65 2c 20 62 75 74 20 74 68 65 20 62	.into.vyos-1x.package,.but.the.b
88a0	61 73 69 63 20 73 74 72 75 63 74 75 72 65 20 69 73 20 67 6f 69 6e 67 20 74 6f 20 73 74 61 79 20	asic.structure.is.going.to.stay.
88c0	74 68 65 20 73 61 6d 65 2c 20 6a 75 73 74 20 77 69 74 68 20 66 65 77 65 72 20 61 6e 64 20 66 65	the.same,.just.with.fewer.and.fe
88e0	77 65 72 20 70 61 63 6b 61 67 65 73 20 77 68 69 6c 65 20 74 68 65 20 62 61 73 65 20 63 6f 64 65	wer.packages.while.the.base.code
8900	20 69 73 20 72 65 77 72 69 74 74 65 6e 20 66 72 6f 6d 20 50 65 72 6c 2f 42 41 53 48 20 69 6e 74	.is.rewritten.from.Perl/BASH.int
8920	6f 20 50 79 74 68 6f 6e 20 75 73 69 6e 67 20 61 6e 64 20 58 4d 4c 20 62 61 73 65 64 20 69 6e 74	o.Python.using.and.XML.based.int
8940	65 72 66 61 63 65 20 64 65 66 69 6e 69 74 69 6f 6e 20 66 6f 72 20 74 68 65 20 43 4c 49 2e 00 4f	erface.definition.for.the.CLI..O
8960	75 72 20 6f 70 20 6d 6f 64 65 20 73 63 72 69 70 74 73 20 75 73 65 20 74 68 65 20 70 79 74 68 6f	ur.op.mode.scripts.use.the.pytho
8980	6e 2d 76 69 63 69 20 6d 6f 64 75 6c 65 2c 20 77 68 69 63 68 20 69 73 20 6e 6f 74 20 69 6e 63 6c	n-vici.module,.which.is.not.incl
89a0	75 64 65 64 20 69 6e 20 44 65 62 69 61 6e 27 73 20 62 75 69 6c 64 2c 20 61 6e 64 20 69 73 6e 27	uded.in.Debian's.build,.and.isn'
89c0	74 20 71 75 69 74 65 20 65 61 73 79 20 74 6f 20 69 6e 74 65 67 72 61 74 65 20 69 6e 20 74 68 61	t.quite.easy.to.integrate.in.tha
89e0	74 20 62 75 69 6c 64 2e 20 46 6f 72 20 74 68 69 73 20 72 65 61 73 6f 6e 20 77 65 20 64 65 62 69	t.build..For.this.reason.we.debi
8a00	61 6e 69 7a 65 20 74 68 61 74 20 6d 6f 64 75 6c 65 20 62 79 20 68 61 6e 64 20 6e 6f 77 2c 20 75	anize.that.module.by.hand.now,.u
8a20	73 69 6e 67 20 74 68 69 73 20 70 72 6f 63 65 64 75 72 65 3a 00 4f 75 72 20 73 6d 6f 6b 65 74 65	sing.this.procedure:.Our.smokete
8a40	73 74 73 20 6e 6f 74 20 6f 6e 6c 79 20 74 65 73 74 20 64 61 65 6d 6f 6e 73 20 61 6e 64 20 73 65	sts.not.only.test.daemons.and.se
8a60	72 69 76 65 73 2c 20 62 75 74 20 61 6c 73 6f 20 63 68 65 63 6b 20 69 66 20 77 68 61 74 20 77 65	rives,.but.also.check.if.what.we
8a80	20 63 6f 6e 66 69 67 75 72 65 20 66 6f 72 20 61 6e 20 69 6e 74 65 72 66 61 63 65 20 77 6f 72 6b	.configure.for.an.interface.work
8aa0	73 2e 20 54 68 75 73 20 74 68 65 72 65 20 69 73 20 61 20 63 6f 6d 6d 6f 6e 20 62 61 73 65 20 63	s..Thus.there.is.a.common.base.c
8ac0	6c 61 73 73 65 64 20 6e 61 6d 65 64 3a 20 60 60 62 61 73 65 5f 69 6e 74 65 72 66 61 63 65 73 5f	lassed.named:.``base_interfaces_
8ae0	74 65 73 74 2e 70 79 60 60 20 77 68 69 63 68 20 68 6f 6c 64 73 20 61 6c 6c 20 74 68 65 20 63 6f	test.py``.which.holds.all.the.co
8b00	6d 6d 6f 6e 20 63 6f 64 65 20 74 68 61 74 20 61 6e 20 69 6e 74 65 72 66 61 63 65 20 73 75 70 70	mmon.code.that.an.interface.supp
8b20	6f 72 74 73 20 61 6e 64 20 69 73 20 74 65 73 74 65 64 2e 00 50 61 63 6b 61 67 65 73 00 50 61 74	orts.and.is.tested..Packages.Pat
8b40	63 68 65 73 20 61 72 65 20 61 6c 77 61 79 73 20 6d 6f 72 65 20 74 68 61 6e 20 77 65 6c 63 6f 6d	ches.are.always.more.than.welcom
8b60	65 2e 20 54 6f 20 68 61 76 65 20 61 20 63 6c 65 61 6e 20 61 6e 64 20 65 61 73 79 20 74 6f 20 6d	e..To.have.a.clean.and.easy.to.m
8b80	61 69 6e 74 61 69 6e 20 72 65 70 6f 73 69 74 6f 72 79 20 77 65 20 68 61 76 65 20 73 6f 6d 65 20	aintain.repository.we.have.some.
8ba0	67 75 69 64 65 6c 69 6e 65 73 20 77 68 65 6e 20 77 6f 72 6b 69 6e 67 20 77 69 74 68 20 47 69 74	guidelines.when.working.with.Git
8bc0	2e 20 41 20 63 6c 65 61 6e 20 72 65 70 6f 73 69 74 6f 72 79 20 65 61 73 65 73 20 74 68 65 20 61	..A.clean.repository.eases.the.a
8be0	75 74 6f 6d 61 74 69 63 20 67 65 6e 65 72 61 74 69 6f 6e 20 6f 66 20 61 20 63 68 61 6e 67 65 6c	utomatic.generation.of.a.changel
8c00	6f 67 20 66 69 6c 65 2e 00 50 61 74 63 68 65 73 20 66 6f 72 20 44 4d 56 50 4e 20 61 72 65 20 6d	og.file..Patches.for.DMVPN.are.m
8c20	65 72 67 65 64 20 69 6e 00 50 6c 65 61 73 65 20 6c 65 61 76 65 20 61 20 63 6f 6d 6d 65 6e 74 20	erged.in.Please.leave.a.comment.
8c40	65 78 70 6c 61 69 6e 69 6e 67 20 77 68 79 20 74 68 65 20 70 72 69 6f 72 69 74 79 20 77 61 73 20	explaining.why.the.priority.was.
8c60	63 68 6f 73 65 6e 20 28 65 2e 67 2e 20 22 61 66 74 65 72 20 69 6e 74 65 72 66 61 63 65 73 20 61	chosen.(e.g.."after.interfaces.a
8c80	72 65 20 63 6f 6e 66 69 67 75 72 65 64 22 29 00 50 6c 65 61 73 65 20 73 75 62 6d 69 74 20 79 6f	re.configured").Please.submit.yo
8ca0	75 72 20 70 61 74 63 68 65 73 20 75 73 69 6e 67 20 74 68 65 20 77 65 6c 6c 2d 6b 6e 6f 77 6e 20	ur.patches.using.the.well-known.
8cc0	47 69 74 48 75 62 20 70 75 6c 6c 2d 72 65 71 75 65 73 74 20 61 67 61 69 6e 73 74 20 6f 75 72 20	GitHub.pull-request.against.our.
8ce0	72 65 70 6f 73 69 74 6f 72 69 65 73 20 66 6f 75 6e 64 20 69 6e 20 74 68 65 20 56 79 4f 53 20 47	repositories.found.in.the.VyOS.G
8d00	69 74 48 75 62 20 6f 72 67 61 6e 69 73 61 74 69 6f 6e 20 61 74 20 68 74 74 70 73 3a 2f 2f 67 69	itHub.organisation.at.https://gi
8d20	74 68 75 62 2e 63 6f 6d 2f 76 79 6f 73 00 50 6c 65 61 73 65 20 75 73 65 20 74 68 65 20 66 6f 6c	thub.com/vyos.Please.use.the.fol
8d40	6c 6f 77 69 6e 67 20 74 65 6d 70 6c 61 74 65 20 61 73 20 67 6f 6f 64 20 73 74 61 72 74 69 6e 67	lowing.template.as.good.starting
8d60	20 70 6f 69 6e 74 20 77 68 65 6e 20 64 65 76 65 6c 6f 70 69 6e 67 20 6e 65 77 20 6d 6f 64 75 6c	.point.when.developing.new.modul
8d80	65 73 20 6f 72 20 65 76 65 6e 20 72 65 77 72 69 74 65 20 61 20 77 68 6f 6c 65 20 62 75 6e 63 68	es.or.even.rewrite.a.whole.bunch
8da0	20 6f 66 20 63 6f 64 65 20 69 6e 20 74 68 65 20 6e 65 77 20 73 74 79 6c 65 20 58 4d 4c 2f 50 79	.of.code.in.the.new.style.XML/Py
8dc0	68 6f 6e 20 69 6e 74 65 72 66 61 63 65 2e 00 50 6c 65 61 73 65 20 75 73 65 20 74 68 65 20 66 6f	hon.interface..Please.use.the.fo
8de0	6c 6c 6f 77 69 6e 67 20 74 65 6d 70 6c 61 74 65 20 61 73 20 67 6f 6f 64 20 73 74 61 72 74 69 6e	llowing.template.as.good.startin
8e00	67 20 70 6f 69 6e 74 20 77 68 65 6e 20 64 65 76 65 6c 6f 70 69 6e 67 20 6e 65 77 20 6d 6f 64 75	g.point.when.developing.new.modu
8e20	6c 65 73 20 6f 72 20 65 76 65 6e 20 72 65 77 72 69 74 65 20 61 20 77 68 6f 6c 65 20 62 75 6e 63	les.or.even.rewrite.a.whole.bunc
8e40	68 20 6f 66 20 63 6f 64 65 20 69 6e 20 74 68 65 20 6e 65 77 20 73 74 79 6c 65 20 58 4d 4c 2f 50	h.of.code.in.the.new.style.XML/P
8e60	79 74 68 6f 6e 20 69 6e 74 65 72 66 61 63 65 2e 00 50 6f 72 74 20 64 65 73 63 72 69 70 74 69 6f	ython.interface..Port.descriptio
8e80	6e 00 50 6f 72 74 20 64 69 73 61 62 6c 65 00 50 72 65 66 65 72 20 69 6e 66 69 6e 69 74 69 76 65	n.Port.disable.Prefer.infinitive
8ea0	73 00 50 72 65 70 61 72 65 20 70 61 74 63 68 2f 63 6f 6d 6d 69 74 00 50 72 65 70 61 72 65 20 72	s.Prepare.patch/commit.Prepare.r
8ec0	65 6c 65 61 73 65 20 6e 6f 74 65 73 20 66 6f 72 20 75 70 63 6f 6d 69 6e 67 20 72 65 6c 65 61 73	elease.notes.for.upcoming.releas
8ee0	65 73 00 50 72 65 72 65 71 75 69 73 69 74 65 73 00 50 72 69 6f 72 69 74 69 65 73 00 50 72 6f 70	es.Prerequisites.Priorities.Prop
8f00	6f 73 65 64 20 43 4c 49 20 73 79 6e 74 61 78 2c 20 69 66 20 74 68 65 20 66 65 61 74 75 72 65 20	osed.CLI.syntax,.if.the.feature.
8f20	72 65 71 75 69 72 65 73 20 6e 65 77 20 63 6f 6d 6d 61 6e 64 73 2e 20 50 6c 65 61 73 65 20 69 6e	requires.new.commands..Please.in
8f40	63 6c 75 64 65 20 62 6f 74 68 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 61 6e 64 20 6f 70 65	clude.both.configuration.and.ope
8f60	72 61 74 69 6f 6e 61 6c 20 6d 6f 64 65 20 63 6f 6d 6d 61 6e 64 73 2c 20 69 66 20 62 6f 74 68 20	rational.mode.commands,.if.both.
8f80	61 72 65 20 72 65 71 75 69 72 65 64 2e 00 50 72 6f 76 69 64 65 20 61 73 20 6d 75 63 68 20 69 6e	are.required..Provide.as.much.in
8fa0	66 6f 72 6d 61 74 69 6f 6e 20 61 73 20 79 6f 75 20 63 61 6e 00 50 79 74 68 6f 6e 00 50 79 74 68	formation.as.you.can.Python.Pyth
8fc0	6f 6e 20 28 6f 72 20 61 6e 79 20 6f 74 68 65 72 20 6c 61 6e 67 75 61 67 65 2c 20 66 6f 72 20 74	on.(or.any.other.language,.for.t
8fe0	68 61 74 20 6d 61 74 74 65 72 29 20 64 6f 65 73 20 6e 6f 74 20 70 72 6f 76 69 64 65 20 61 75 74	hat.matter).does.not.provide.aut
9000	6f 6d 61 74 69 63 20 70 72 6f 74 65 63 74 69 6f 6e 20 66 72 6f 6d 20 62 61 64 20 64 65 73 69 67	omatic.protection.from.bad.desig
9020	6e 2c 20 73 6f 20 77 65 20 6e 65 65 64 20 74 6f 20 61 6c 73 6f 20 64 65 76 69 73 65 20 64 65 73	n,.so.we.need.to.also.devise.des
9040	69 67 6e 20 67 75 69 64 65 6c 69 6e 65 73 20 61 6e 64 20 66 6f 6c 6c 6f 77 20 74 68 65 6d 20 74	ign.guidelines.and.follow.them.t
9060	6f 20 6b 65 65 70 20 74 68 65 20 73 79 73 74 65 6d 20 65 78 74 65 6e 73 69 62 6c 65 20 61 6e 64	o.keep.the.system.extensible.and
9080	20 6d 61 69 6e 74 61 69 6e 61 62 6c 65 2e 00 50 79 74 68 6f 6e 20 33 20 2a 2a 73 68 61 6c 6c 2a	.maintainable..Python.3.**shall*
90a0	2a 20 62 65 20 75 73 65 64 2e 20 48 6f 77 20 6c 6f 6e 67 20 63 61 6e 20 77 65 20 6b 65 65 70 20	*.be.used..How.long.can.we.keep.
90c0	50 79 74 68 6f 6e 20 32 20 61 6c 69 76 65 20 61 6e 79 77 61 79 3f 20 4e 6f 20 63 6f 6e 73 69 64	Python.2.alive.anyway?.No.consid
90e0	65 72 61 74 69 6f 6e 73 20 66 6f 72 20 50 79 74 68 6f 6e 20 32 20 63 6f 6d 70 61 74 69 62 69 6c	erations.for.Python.2.compatibil
9100	69 74 79 20 2a 2a 73 68 6f 75 6c 64 2a 2a 20 62 65 20 74 61 6b 65 6e 20 61 74 20 61 6e 79 20 74	ity.**should**.be.taken.at.any.t
9120	69 6d 65 2e 00 50 79 74 68 6f 6e 3a 20 54 61 62 73 20 2a 2a 73 68 61 6c 6c 20 6e 6f 74 2a 2a 20	ime..Python:.Tabs.**shall.not**.
9140	62 65 20 75 73 65 64 2e 20 45 76 65 72 79 20 69 6e 64 65 6e 74 61 74 69 6f 6e 20 6c 65 76 65 6c	be.used..Every.indentation.level
9160	20 73 68 6f 75 6c 64 20 62 65 20 34 20 73 70 61 63 65 73 00 51 45 4d 55 00 52 61 74 69 6f 6e 61	.should.be.4.spaces.QEMU.Rationa
9180	6c 65 3a 20 74 68 69 73 20 73 65 65 6d 73 20 74 6f 20 62 65 20 74 68 65 20 75 6e 77 72 69 74 74	le:.this.seems.to.be.the.unwritt
91a0	65 6e 20 73 74 61 6e 64 61 72 64 20 69 6e 20 6e 65 74 77 6f 72 6b 20 64 65 76 69 63 65 20 43 4c	en.standard.in.network.device.CL
91c0	49 73 2c 20 61 6e 64 20 61 20 67 6f 6f 64 20 61 65 73 74 68 65 74 69 63 20 63 6f 6d 70 72 6f 6d	Is,.and.a.good.aesthetic.comprom
91e0	69 73 65 2e 00 52 65 63 65 6e 74 20 76 65 72 73 69 6f 6e 73 20 75 73 65 20 74 68 65 20 60 60 76	ise..Recent.versions.use.the.``v
9200	79 6f 73 2e 66 72 72 60 60 20 66 72 61 6d 65 77 6f 72 6b 2e 20 54 68 65 20 50 79 74 68 6f 6e 20	yos.frr``.framework..The.Python.
9220	63 6c 61 73 73 20 69 73 20 6c 6f 63 61 74 65 64 20 69 6e 73 69 64 65 20 6f 75 72 20 60 60 76 79	class.is.located.inside.our.``vy
9240	6f 73 2d 31 78 3a 70 79 74 68 6f 6e 2f 76 79 6f 73 2f 66 72 72 2e 70 79 60 60 2e 20 49 74 20 63	os-1x:python/vyos/frr.py``..It.c
9260	6f 6d 65 73 20 77 69 74 68 20 61 6e 20 65 6d 62 65 64 64 65 64 20 64 65 62 75 67 67 69 6e 67 2f	omes.with.an.embedded.debugging/
9280	20 28 70 72 69 6e 74 20 73 74 79 6c 65 29 20 64 65 62 75 67 67 65 72 20 61 73 20 76 79 6f 73 2e	.(print.style).debugger.as.vyos.
92a0	69 66 63 6f 6e 66 69 67 20 64 6f 65 73 2e 00 52 65 70 6f 72 74 20 61 20 42 75 67 00 52 75 6e 20	ifconfig.does..Report.a.Bug.Run.
92c0	74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 63 6f 6d 6d 61 6e 64 20 61 66 74 65 72 20 62 75 69 6c	the.following.command.after.buil
92e0	64 69 6e 67 20 74 68 65 20 49 53 4f 20 69 6d 61 67 65 2e 00 52 75 6e 20 74 68 65 20 66 6f 6c 6c	ding.the.ISO.image..Run.the.foll
9300	6f 77 69 6e 67 20 63 6f 6d 6d 61 6e 64 20 61 66 74 65 72 20 62 75 69 6c 64 69 6e 67 20 74 68 65	owing.command.after.building.the
9320	20 51 45 4d 55 20 69 6d 61 67 65 2e 00 53 69 6d 70 6c 79 20 75 73 65 20 6f 75 72 20 77 72 61 70	.QEMU.image..Simply.use.our.wrap
9340	70 65 72 20 73 63 72 69 70 74 20 74 6f 20 62 75 69 6c 64 20 61 6c 6c 20 6f 66 20 74 68 65 20 64	per.script.to.build.all.of.the.d
9360	72 69 76 65 72 20 6d 6f 64 75 6c 65 73 2e 00 53 69 6e 63 65 20 56 79 4f 53 20 68 61 73 20 73 77	river.modules..Since.VyOS.has.sw
9380	69 74 63 68 65 64 20 74 6f 20 44 65 62 69 61 6e 20 28 31 31 29 20 42 75 6c 6c 73 65 79 65 20 69	itched.to.Debian.(11).Bullseye.i
93a0	6e 20 69 74 73 20 60 60 63 75 72 72 65 6e 74 60 60 20 62 72 61 6e 63 68 2c 20 79 6f 75 20 77 69	n.its.``current``.branch,.you.wi
93c0	6c 6c 20 72 65 71 75 69 72 65 20 69 6e 64 69 76 69 64 75 61 6c 20 63 6f 6e 74 61 69 6e 65 72 20	ll.require.individual.container.
93e0	66 6f 72 20 60 63 75 72 72 65 6e 74 60 2c 20 60 65 71 75 75 6c 65 75 73 60 20 61 6e 64 20 60 63	for.`current`,.`equuleus`.and.`c
9400	72 75 78 60 20 62 75 69 6c 64 73 2e 00 53 6d 6f 6b 65 74 65 73 74 73 00 53 6d 6f 6b 65 74 65 73	rux`.builds..Smoketests.Smoketes
9420	74 73 20 65 78 65 63 75 74 65 73 20 70 72 65 64 65 66 69 6e 65 64 20 56 79 4f 53 20 43 4c 49 20	ts.executes.predefined.VyOS.CLI.
9440	63 6f 6d 6d 61 6e 64 73 20 61 6e 64 20 63 68 65 63 6b 73 20 69 66 20 74 68 65 20 64 65 73 69 72	commands.and.checks.if.the.desir
9460	65 64 20 64 61 65 6d 6f 6e 2f 73 65 72 76 69 63 65 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20	ed.daemon/service.configuration.
9480	69 73 20 72 65 6e 64 65 72 74 20 2d 20 74 68 61 74 20 69 73 20 68 6f 77 20 74 6f 20 70 75 74 20	is.rendert.-.that.is.how.to.put.
94a0	69 74 20 22 73 68 6f 72 74 22 2e 00 53 6f 20 69 66 20 79 6f 75 20 70 6c 61 6e 20 74 6f 20 62 75	it."short"..So.if.you.plan.to.bu
94c0	69 6c 64 20 79 6f 75 72 20 6f 77 6e 20 63 75 73 74 6f 6d 20 49 53 4f 20 69 6d 61 67 65 20 61 6e	ild.your.own.custom.ISO.image.an
94e0	64 20 77 61 6e 27 74 20 74 6f 20 6d 61 6b 65 20 75 73 65 20 6f 66 20 6f 75 72 20 73 6d 6f 6b 65	d.wan't.to.make.use.of.our.smoke
9500	74 65 73 74 73 2c 20 65 6e 73 75 72 65 20 74 68 61 74 20 79 6f 75 20 68 61 76 65 20 74 68 65 20	tests,.ensure.that.you.have.the.
9520	60 76 79 6f 73 2d 31 78 2d 73 6d 6f 6b 65 74 65 73 74 60 20 70 61 63 6b 61 67 65 20 69 6e 73 74	`vyos-1x-smoketest`.package.inst
9540	61 6c 6c 65 64 2e 00 53 6f 20 69 66 20 79 6f 75 20 70 6c 61 6e 20 74 6f 20 62 75 69 6c 64 20 79	alled..So.if.you.plan.to.build.y
9560	6f 75 72 20 6f 77 6e 20 63 75 73 74 6f 6d 20 49 53 4f 20 69 6d 61 67 65 20 61 6e 64 20 77 61 6e	our.own.custom.ISO.image.and.wan
9580	74 20 74 6f 20 6d 61 6b 65 20 75 73 65 20 6f 66 20 6f 75 72 20 73 6d 6f 6b 65 74 65 73 74 73 2c	t.to.make.use.of.our.smoketests,
95a0	20 65 6e 73 75 72 65 20 74 68 61 74 20 79 6f 75 20 68 61 76 65 20 74 68 65 20 60 76 79 6f 73 2d	.ensure.that.you.have.the.`vyos-
95c0	31 78 2d 73 6d 6f 6b 65 74 65 73 74 60 20 70 61 63 6b 61 67 65 20 69 6e 73 74 61 6c 6c 65 64 2e	1x-smoketest`.package.installed.
95e0	00 53 6f 6d 65 20 56 79 4f 53 20 70 61 63 6b 61 67 65 73 20 28 6e 61 6d 65 6c 79 20 76 79 6f 73	.Some.VyOS.packages.(namely.vyos
9600	2d 31 78 29 20 63 6f 6d 65 20 77 69 74 68 20 62 75 69 6c 64 2d 74 69 6d 65 20 74 65 73 74 73 20	-1x).come.with.build-time.tests.
9620	77 68 69 63 68 20 76 65 72 69 66 79 20 73 6f 6d 65 20 6f 66 20 74 68 65 20 69 6e 74 65 72 6e 61	which.verify.some.of.the.interna
9640	6c 20 6c 69 62 72 61 72 79 20 63 61 6c 6c 73 20 74 68 61 74 20 74 68 65 79 20 77 6f 72 6b 20 61	l.library.calls.that.they.work.a
9660	73 20 65 78 70 65 63 74 65 64 2e 20 54 68 6f 73 65 20 74 65 73 74 73 20 61 72 65 20 63 61 72 72	s.expected..Those.tests.are.carr
9680	69 65 64 20 6f 75 74 20 74 68 72 6f 75 67 68 20 74 68 65 20 50 79 74 68 6f 6e 20 55 6e 69 74 74	ied.out.through.the.Python.Unitt
96a0	65 73 74 20 6d 6f 64 75 6c 65 2e 20 49 66 20 79 6f 75 20 77 61 6e 74 20 74 6f 20 62 75 69 6c 64	est.module..If.you.want.to.build
96c0	20 74 68 65 20 60 60 76 79 6f 73 2d 31 78 60 60 20 70 61 63 6b 61 67 65 20 28 77 68 69 63 68 20	.the.``vyos-1x``.package.(which.
96e0	69 73 20 6f 75 72 20 6d 61 69 6e 20 64 65 76 65 6c 6f 70 6d 65 6e 74 20 70 61 63 6b 61 67 65 29	is.our.main.development.package)
9700	20 79 6f 75 20 6e 65 65 64 20 74 6f 20 73 74 61 72 74 20 79 6f 75 72 20 44 6f 63 6b 65 72 20 63	.you.need.to.start.your.Docker.c
9720	6f 6e 74 61 69 6e 65 72 20 75 73 69 6e 67 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 61 72 67	ontainer.using.the.following.arg
9740	75 6d 65 6e 74 3a 20 60 60 2d 2d 73 79 73 63 74 6c 20 6e 65 74 2e 69 70 76 36 2e 63 6f 6e 66 2e	ument:.``--sysctl.net.ipv6.conf.
9760	6c 6f 2e 64 69 73 61 62 6c 65 5f 69 70 76 36 3d 30 60 60 2c 20 6f 74 68 65 72 77 69 73 65 20 74	lo.disable_ipv6=0``,.otherwise.t
9780	68 6f 73 65 20 74 65 73 74 73 20 77 69 6c 6c 20 66 61 69 6c 2e 00 53 6f 6d 65 20 61 62 62 72 65	hose.tests.will.fail..Some.abbre
97a0	76 69 61 74 69 6f 6e 73 20 61 72 65 20 74 72 61 64 69 74 69 6f 6e 61 6c 6c 79 20 77 72 69 74 74	viations.are.traditionally.writt
97c0	65 6e 20 69 6e 20 6d 69 78 65 64 20 63 61 73 65 2e 20 47 65 6e 65 72 61 6c 6c 79 2c 20 69 66 20	en.in.mixed.case..Generally,.if.
97e0	69 74 20 63 6f 6e 74 61 69 6e 73 20 77 6f 72 64 73 20 22 6f 76 65 72 22 20 6f 72 20 22 76 65 72	it.contains.words."over".or."ver
9800	73 69 6f 6e 22 2c 20 74 68 65 20 6c 65 74 74 65 72 20 2a 2a 73 68 6f 75 6c 64 2a 2a 20 62 65 20	sion",.the.letter.**should**.be.
9820	6c 6f 77 65 72 63 61 73 65 2e 20 49 66 20 74 68 65 72 65 27 73 20 61 6e 20 61 63 63 65 70 74 65	lowercase..If.there's.an.accepte
9840	64 20 73 70 65 6c 6c 69 6e 67 20 28 65 73 70 65 63 69 61 6c 6c 79 20 69 66 20 64 65 66 69 6e 65	d.spelling.(especially.if.define
9860	64 20 62 79 20 61 6e 20 52 46 43 20 6f 72 20 61 6e 6f 74 68 65 72 20 73 74 61 6e 64 61 72 64 29	d.by.an.RFC.or.another.standard)
9880	2c 20 69 74 20 2a 2a 6d 75 73 74 2a 2a 20 62 65 20 66 6f 6c 6c 6f 77 65 64 2e 00 53 6f 6d 65 20	,.it.**must**.be.followed..Some.
98a0	6f 66 20 74 68 65 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 73 20 68 61 76 65 20 70 72 65 63 6f	of.the.configurations.have.preco
98c0	6e 64 69 74 69 6f 6e 73 20 77 68 69 63 68 20 6e 65 65 64 20 74 6f 20 62 65 20 6d 65 74 2e 20 54	nditions.which.need.to.be.met..T
98e0	68 6f 73 65 20 6d 6f 73 74 20 6c 69 6b 65 6c 79 20 69 6e 63 6c 75 64 65 20 67 65 6e 65 72 61 74	hose.most.likely.include.generat
9900	69 6f 6e 20 6f 66 20 63 72 79 70 6f 67 72 61 70 68 69 63 20 6b 65 79 73 20 62 65 66 6f 72 65 20	ion.of.crypographic.keys.before.
9920	74 68 65 20 63 6f 6e 66 69 67 20 63 61 6e 20 62 65 20 61 70 70 6c 69 65 64 20 2d 20 79 6f 75 20	the.config.can.be.applied.-.you.
9940	77 69 6c 6c 20 67 65 74 20 61 20 63 6f 6d 6d 69 74 20 65 72 72 6f 72 20 6f 74 68 65 72 77 69 73	will.get.a.commit.error.otherwis
9960	65 2e 20 49 66 20 79 6f 75 20 61 72 65 20 69 6e 74 65 72 65 73 74 65 64 20 68 6f 77 20 74 68 6f	e..If.you.are.interested.how.tho
9980	73 65 20 70 72 65 63 6f 6e 64 69 74 69 6f 6e 73 20 61 72 65 20 66 75 6c 66 69 6c 6c 65 64 20 63	se.preconditions.are.fulfilled.c
99a0	68 65 63 6b 20 74 68 65 20 76 79 6f 73 2d 62 75 69 6c 64 5f 20 72 65 70 6f 73 69 74 6f 72 79 20	heck.the.vyos-build_.repository.
99c0	61 6e 64 20 74 68 65 20 60 60 73 63 72 69 70 74 73 2f 63 68 65 63 6b 2d 71 65 6d 75 2d 69 6e 73	and.the.``scripts/check-qemu-ins
99e0	74 61 6c 6c 60 60 20 66 69 6c 65 2e 00 53 6f 6d 65 74 69 6d 65 73 20 69 74 20 6d 69 67 68 74 20	tall``.file..Sometimes.it.might.
9a00	62 65 20 75 73 65 66 75 6c 20 74 6f 20 64 65 62 75 67 20 50 79 74 68 6f 6e 20 63 6f 64 65 20 69	be.useful.to.debug.Python.code.i
9a20	6e 74 65 72 61 63 74 69 76 65 6c 79 20 6f 6e 20 74 68 65 20 6c 69 76 65 20 73 79 73 74 65 6d 20	nteractively.on.the.live.system.
9a40	72 61 74 68 65 72 20 74 68 61 6e 20 61 20 49 44 45 2e 20 54 68 69 73 20 63 61 6e 20 62 65 20 61	rather.than.a.IDE..This.can.be.a
9a60	63 68 69 65 76 65 64 20 75 73 69 6e 67 20 70 64 62 2e 00 53 74 61 72 74 20 74 68 65 20 62 75 69	chieved.using.pdb..Start.the.bui
9a80	6c 64 3a 00 53 74 61 72 74 69 6e 67 20 77 69 74 68 20 56 79 4f 53 20 31 2e 32 20 74 68 65 20 72	ld:.Starting.with.VyOS.1.2.the.r
9aa0	65 6c 65 61 73 65 20 6d 6f 64 65 6c 20 6f 66 20 56 79 4f 53 20 68 61 73 20 63 68 61 6e 67 65 64	elease.model.of.VyOS.has.changed
9ac0	2e 20 56 79 4f 53 20 69 73 20 6e 6f 77 20 2a 2a 66 72 65 65 20 61 73 20 69 6e 20 73 70 65 65 63	..VyOS.is.now.**free.as.in.speec
9ae0	68 2c 20 62 75 74 20 6e 6f 74 20 61 73 20 69 6e 20 62 65 65 72 2a 2a 2e 20 54 68 69 73 20 6d 65	h,.but.not.as.in.beer**..This.me
9b00	61 6e 73 20 74 68 61 74 20 77 68 69 6c 65 20 56 79 4f 53 20 69 73 20 73 74 69 6c 6c 20 61 6e 20	ans.that.while.VyOS.is.still.an.
9b20	6f 70 65 6e 20 73 6f 75 72 63 65 20 70 72 6f 6a 65 63 74 2c 20 74 68 65 20 72 65 6c 65 61 73 65	open.source.project,.the.release
9b40	20 49 53 4f 73 20 61 72 65 20 6e 6f 20 6c 6f 6e 67 65 72 20 66 72 65 65 20 61 6e 64 20 63 61 6e	.ISOs.are.no.longer.free.and.can
9b60	20 6f 6e 6c 79 20 62 65 20 6f 62 74 61 69 6e 65 64 20 76 69 61 20 73 75 62 73 63 72 69 70 74 69	.only.be.obtained.via.subscripti
9b80	6f 6e 2c 20 6f 72 20 62 79 20 63 6f 6e 74 72 69 62 75 74 69 6e 67 20 74 6f 20 74 68 65 20 63 6f	on,.or.by.contributing.to.the.co
9ba0	6d 6d 75 6e 69 74 79 2e 00 53 75 62 6d 69 74 20 61 20 50 61 74 63 68 00 53 75 62 6d 69 74 20 74	mmunity..Submit.a.Patch.Submit.t
9bc0	68 65 20 70 61 74 63 68 20 60 60 67 69 74 20 70 75 73 68 60 60 20 61 6e 64 20 63 72 65 61 74 65	he.patch.``git.push``.and.create
9be0	20 74 68 65 20 47 69 74 48 75 62 20 70 75 6c 6c 2d 72 65 71 75 65 73 74 2e 00 53 75 6d 6d 61 72	.the.GitHub.pull-request..Summar
9c00	79 00 53 75 70 70 6f 73 65 20 79 6f 75 20 77 61 6e 74 20 74 6f 20 6d 61 6b 65 20 61 20 63 68 61	y.Suppose.you.want.to.make.a.cha
9c20	6e 67 65 20 69 6e 20 74 68 65 20 77 65 62 70 72 6f 78 79 20 73 63 72 69 70 74 20 62 75 74 20 79	nge.in.the.webproxy.script.but.y
9c40	65 74 20 79 6f 75 20 64 6f 20 6e 6f 74 20 6b 6e 6f 77 20 77 68 69 63 68 20 6f 66 20 74 68 65 20	et.you.do.not.know.which.of.the.
9c60	6d 61 6e 79 20 56 79 4f 53 20 70 61 63 6b 61 67 65 73 20 73 68 69 70 20 74 68 69 73 20 66 69 6c	many.VyOS.packages.ship.this.fil
9c80	65 2e 20 59 6f 75 20 63 61 6e 20 64 65 74 65 72 6d 69 6e 65 20 74 68 65 20 56 79 4f 53 20 70 61	e..You.can.determine.the.VyOS.pa
9ca0	63 6b 61 67 65 20 6e 61 6d 65 20 69 6e 20 71 75 65 73 74 69 6f 6e 20 62 79 20 75 73 69 6e 67 20	ckage.name.in.question.by.using.
9cc0	44 65 62 69 61 6e 27 73 20 60 60 64 70 6b 67 20 2d 53 60 60 20 63 6f 6d 6d 61 6e 64 20 6f 66 20	Debian's.``dpkg.-S``.command.of.
9ce0	79 6f 75 72 20 72 75 6e 6e 69 6e 67 20 56 79 4f 53 20 69 6e 73 74 61 6c 6c 61 74 69 6f 6e 2e 00	your.running.VyOS.installation..
9d00	53 79 73 74 65 6d 20 53 74 61 72 74 75 70 00 54 61 73 6b 20 61 75 74 6f 2d 63 6c 6f 73 69 6e 67	System.Startup.Task.auto-closing
9d20	00 54 61 73 6b 73 20 74 68 61 74 20 61 72 65 20 69 6d 70 6c 65 6d 65 6e 74 65 64 20 61 6e 64 20	.Tasks.that.are.implemented.and.
9d40	74 65 73 74 65 64 20 62 79 20 74 68 65 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 61 75 74	tested.by.the.implementation.aut
9d60	68 6f 72 2c 20 62 75 74 20 72 65 71 75 69 72 65 20 74 65 73 74 69 6e 67 20 69 6e 20 74 68 65 20	hor,.but.require.testing.in.the.
9d80	72 65 61 6c 2d 77 6f 72 6c 64 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 74 68 61 74 20 6f 6e 6c 79	real-world.environment.that.only
9da0	20 74 68 65 20 72 65 70 6f 72 74 65 72 20 63 61 6e 20 72 65 70 6c 69 63 61 74 65 20 28 65 2e 67	.the.reporter.can.replicate.(e.g
9dc0	2e 2c 20 68 61 72 64 77 61 72 65 20 77 65 20 64 6f 20 6e 6f 74 20 68 61 76 65 2c 20 73 70 65 63	.,.hardware.we.do.not.have,.spec
9de0	69 66 69 63 20 6e 65 74 77 6f 72 6b 20 63 6f 6e 64 69 74 69 6f 6e 73 2e 2e 2e 29 2e 00 54 65 6d	ific.network.conditions...)..Tem
9e00	70 6c 61 74 65 20 70 72 6f 63 65 73 73 6f 72 20 2a 2a 73 68 6f 75 6c 64 2a 2a 20 62 65 20 75 73	plate.processor.**should**.be.us
9e20	65 64 20 66 6f 72 20 67 65 6e 65 72 61 74 69 6e 67 20 63 6f 6e 66 69 67 20 66 69 6c 65 73 2e 20	ed.for.generating.config.files..
9e40	42 75 69 6c 74 2d 69 6e 20 73 74 72 69 6e 67 20 66 6f 72 6d 61 74 74 69 6e 67 20 2a 2a 6d 61 79	Built-in.string.formatting.**may
9e60	2a 2a 20 62 65 20 75 73 65 64 20 66 6f 72 20 73 69 6d 70 6c 65 20 6c 69 6e 65 2d 6f 72 69 65 6e	**.be.used.for.simple.line-orien
9e80	74 65 64 20 66 6f 72 6d 61 74 73 20 77 68 65 72 65 20 65 76 65 72 79 20 6c 69 6e 65 20 69 73 20	ted.formats.where.every.line.is.
9ea0	73 65 6c 66 2d 63 6f 6e 74 61 69 6e 65 64 2c 20 73 75 63 68 20 61 73 20 69 70 74 61 62 6c 65 73	self-contained,.such.as.iptables
9ec0	20 72 75 6c 65 73 2e 20 54 65 6d 70 6c 61 74 65 20 70 72 6f 63 65 73 73 6f 72 20 2a 2a 6d 75 73	.rules..Template.processor.**mus
9ee0	74 2a 2a 20 62 65 20 75 73 65 64 20 66 6f 72 20 73 74 72 75 63 74 75 72 65 64 2c 20 6d 75 6c 74	t**.be.used.for.structured,.mult
9f00	69 2d 6c 69 6e 65 20 66 6f 72 6d 61 74 73 20 73 75 63 68 20 61 73 20 74 68 6f 73 65 20 75 73 65	i-line.formats.such.as.those.use
9f20	64 20 62 79 20 49 53 43 20 44 48 43 50 64 2e 00 54 65 73 74 69 6e 67 00 54 65 78 74 20 67 65 6e	d.by.ISC.DHCPd..Testing.Text.gen
9f40	65 72 61 74 69 6f 6e 00 54 68 65 20 43 4c 49 20 70 61 72 73 65 72 20 75 73 65 64 20 69 6e 20 56	eration.The.CLI.parser.used.in.V
9f60	79 4f 53 20 69 73 20 61 20 6d 69 78 20 6f 66 20 62 61 73 68 2c 20 62 61 73 68 2d 63 6f 6d 70 6c	yOS.is.a.mix.of.bash,.bash-compl
9f80	65 74 69 6f 6e 20 68 65 6c 70 65 72 20 61 6e 64 20 74 68 65 20 43 2b 2b 20 62 61 63 6b 65 6e 64	etion.helper.and.the.C++.backend
9fa0	20 6c 69 62 72 61 72 79 20 5b 76 79 61 74 74 61 2d 63 66 67 5d 28 68 74 74 70 73 3a 2f 2f 67 69	.library.[vyatta-cfg](https://gi
9fc0	74 68 75 62 2e 63 6f 6d 2f 76 79 6f 73 2f 76 79 61 74 74 61 2d 63 66 67 29 2e 20 54 68 69 73 20	thub.com/vyos/vyatta-cfg)..This.
9fe0	73 65 63 74 69 6f 6e 20 69 73 20 61 20 72 65 66 65 72 65 6e 63 65 20 6f 66 20 63 6f 6d 6d 6f 6e	section.is.a.reference.of.common
a000	20 43 4c 49 20 63 6f 6d 6d 61 6e 64 73 20 61 6e 64 20 74 68 65 20 72 65 73 70 65 63 74 69 76 65	.CLI.commands.and.the.respective
a020	20 65 6e 74 72 79 20 70 6f 69 6e 74 20 69 6e 20 74 68 65 20 43 2f 43 2b 2b 20 63 6f 64 65 2e 00	.entry.point.in.the.C/C++.code..
a040	54 68 65 20 49 6e 74 65 6c 20 4e 49 43 20 64 72 69 76 65 72 73 20 64 6f 20 6e 6f 74 20 63 6f 6d	The.Intel.NIC.drivers.do.not.com
a060	65 20 66 72 6f 6d 20 61 20 47 69 74 20 72 65 70 6f 73 69 74 6f 72 79 2c 20 69 6e 73 74 65 61 64	e.from.a.Git.repository,.instead
a080	20 77 65 20 6a 75 73 74 20 66 65 74 63 68 20 74 68 65 20 74 61 72 62 61 6c 6c 73 20 66 72 6f 6d	.we.just.fetch.the.tarballs.from
a0a0	20 6f 75 72 20 6d 69 72 72 6f 72 20 61 6e 64 20 63 6f 6d 70 69 6c 65 20 74 68 65 6d 2e 00 54 68	.our.mirror.and.compile.them..Th
a0c0	65 20 49 6e 74 65 6c 20 51 41 54 20 28 51 75 69 63 6b 20 41 73 73 69 73 74 20 54 65 63 68 6e 6f	e.Intel.QAT.(Quick.Assist.Techno
a0e0	6c 6f 67 79 29 20 64 72 69 76 65 72 73 20 64 6f 20 6e 6f 74 20 63 6f 6d 65 20 66 72 6f 6d 20 61	logy).drivers.do.not.come.from.a
a100	20 47 69 74 20 72 65 70 6f 73 69 74 6f 72 79 2c 20 69 6e 73 74 65 61 64 20 77 65 20 6a 75 73 74	.Git.repository,.instead.we.just
a120	20 66 65 74 63 68 20 74 68 65 20 74 61 72 62 61 6c 6c 73 20 66 72 6f 6d 20 30 31 2e 6f 72 67 2c	.fetch.the.tarballs.from.01.org,
a140	20 49 6e 74 65 6c 27 73 20 6f 70 65 6e 2d 73 6f 75 72 63 65 20 77 65 62 73 69 74 65 2e 00 54 68	.Intel's.open-source.website..Th
a160	65 20 4c 69 6e 75 78 20 6b 65 72 6e 65 6c 20 75 73 65 64 20 62 79 20 56 79 4f 53 20 69 73 20 68	e.Linux.kernel.used.by.VyOS.is.h
a180	65 61 76 69 6c 79 20 74 69 65 64 20 74 6f 20 74 68 65 20 49 53 4f 20 62 75 69 6c 64 20 70 72 6f	eavily.tied.to.the.ISO.build.pro
a1a0	63 65 73 73 2e 20 54 68 65 20 66 69 6c 65 20 60 60 64 61 74 61 2f 64 65 66 61 75 6c 74 73 2e 6a	cess..The.file.``data/defaults.j
a1c0	73 6f 6e 60 60 20 68 6f 73 74 73 20 61 20 4a 53 4f 4e 20 64 65 66 69 6e 69 74 69 6f 6e 20 6f 66	son``.hosts.a.JSON.definition.of
a1e0	20 74 68 65 20 6b 65 72 6e 65 6c 20 76 65 72 73 69 6f 6e 20 75 73 65 64 20 60 60 6b 65 72 6e 65	.the.kernel.version.used.``kerne
a200	6c 5f 76 65 72 73 69 6f 6e 60 60 20 61 6e 64 20 74 68 65 20 60 60 6b 65 72 6e 65 6c 5f 66 6c 61	l_version``.and.the.``kernel_fla
a220	76 6f 72 60 60 20 6f 66 20 74 68 65 20 6b 65 72 6e 65 6c 20 77 68 69 63 68 20 72 65 70 72 65 73	vor``.of.the.kernel.which.repres
a240	65 6e 74 73 20 74 68 65 20 6b 65 72 6e 65 6c 27 73 20 4c 4f 43 41 4c 5f 56 45 52 53 49 4f 4e 2e	ents.the.kernel's.LOCAL_VERSION.
a260	20 42 6f 74 68 20 74 6f 67 65 74 68 65 72 20 66 6f 72 6d 20 74 68 65 20 6b 65 72 6e 65 6c 20 76	.Both.together.form.the.kernel.v
a280	65 72 73 69 6f 6e 20 76 61 72 69 61 62 6c 65 20 69 6e 20 74 68 65 20 73 79 73 74 65 6d 3a 00 54	ersion.variable.in.the.system:.T
a2a0	68 65 20 4d 65 6c 6c 61 6e 6f 78 20 4f 46 45 44 20 64 72 69 76 65 72 73 20 64 6f 20 6e 6f 74 20	he.Mellanox.OFED.drivers.do.not.
a2c0	63 6f 6d 65 20 66 72 6f 6d 20 61 20 47 69 74 20 72 65 70 6f 73 69 74 6f 72 79 2c 20 69 6e 73 74	come.from.a.Git.repository,.inst
a2e0	65 61 64 20 77 65 20 66 65 74 63 68 20 74 68 65 20 74 61 72 62 61 6c 6c 20 66 72 6f 6d 20 4e 76	ead.we.fetch.the.tarball.from.Nv
a300	69 64 69 61 20 61 6e 64 20 63 6f 6d 70 69 6c 65 20 74 68 65 20 73 6f 75 72 63 65 73 20 69 74 73	idia.and.compile.the.sources.its
a320	20 63 6f 6e 74 61 69 6e 73 20 61 67 61 69 6e 73 74 20 6f 75 72 20 6b 65 72 6e 65 6c 20 74 72 65	.contains.against.our.kernel.tre
a340	65 2e 00 54 68 65 20 52 45 41 44 4d 45 2e 6d 64 20 66 69 6c 65 20 77 69 6c 6c 20 67 75 69 64 65	e..The.README.md.file.will.guide
a360	20 79 6f 75 20 74 6f 20 75 73 65 20 74 68 65 20 74 68 69 73 20 74 6f 70 20 6c 65 76 65 6c 20 72	.you.to.use.the.this.top.level.r
a380	65 70 6f 73 69 74 6f 72 79 2e 00 54 68 65 20 60 60 61 70 70 6c 79 28 29 60 60 20 61 6e 64 20 60	epository..The.``apply()``.and.`
a3a0	60 67 65 6e 65 72 61 74 65 28 29 60 60 20 66 75 6e 63 74 69 6f 6e 73 20 6d 61 79 20 60 60 72 61	`generate()``.functions.may.``ra
a3c0	69 73 65 20 43 6f 6e 66 69 67 45 72 72 6f 72 60 60 20 69 66 2c 20 66 6f 72 20 65 78 61 6d 70 6c	ise.ConfigError``.if,.for.exampl
a3e0	65 2c 20 74 68 65 20 64 61 65 6d 6f 6e 20 66 61 69 6c 65 64 20 74 6f 20 73 74 61 72 74 20 77 69	e,.the.daemon.failed.to.start.wi
a400	74 68 20 74 68 65 20 75 70 64 61 74 65 64 20 63 6f 6e 66 69 67 2e 20 49 74 20 73 68 6f 75 6c 64	th.the.updated.config..It.should
a420	6e 27 74 20 62 65 20 61 20 73 75 62 73 74 69 74 75 74 65 20 66 6f 72 20 70 72 6f 70 65 72 20 63	n't.be.a.substitute.for.proper.c
a440	6f 6e 66 69 67 20 63 68 65 63 6b 69 6e 67 20 69 6e 20 74 68 65 20 60 60 76 65 72 69 66 79 28 29	onfig.checking.in.the.``verify()
a460	60 60 20 66 75 6e 63 74 69 6f 6e 2e 20 41 6c 6c 20 72 65 61 73 6f 6e 61 62 6c 65 20 65 66 66 6f	``.function..All.reasonable.effo
a480	72 74 20 73 68 6f 75 6c 64 20 62 65 20 6d 61 64 65 20 74 6f 20 76 65 72 69 66 79 20 74 68 61 74	rt.should.be.made.to.verify.that
a4a0	20 67 65 6e 65 72 61 74 65 64 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 69 73 20 76 61 6c 69	.generated.configuration.is.vali
a4c0	64 20 61 6e 64 20 77 69 6c 6c 20 62 65 20 61 63 63 65 70 74 65 64 20 62 79 20 74 68 65 20 64 61	d.and.will.be.accepted.by.the.da
a4e0	65 6d 6f 6e 2c 20 69 6e 63 6c 75 64 69 6e 67 2c 20 77 68 65 6e 20 6e 65 63 65 73 73 61 72 79 2c	emon,.including,.when.necessary,
a500	20 63 72 6f 73 73 2d 20 63 68 65 63 6b 73 20 77 69 74 68 20 6f 74 68 65 72 20 56 79 4f 53 20 63	.cross-.checks.with.other.VyOS.c
a520	6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 73 75 62 74 72 65 65 73 2e 00 54 68 65 20 60 60 61 70 70	onfiguration.subtrees..The.``app
a540	6c 79 28 29 60 60 20 66 75 6e 63 74 69 6f 6e 20 61 70 70 6c 69 65 73 20 74 68 65 20 67 65 6e 65	ly()``.function.applies.the.gene
a560	72 61 74 65 64 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 74 6f 20 74 68 65 20 6c 69 76 65 20	rated.configuration.to.the.live.
a580	73 79 73 74 65 6d 2e 20 49 74 20 73 68 6f 75 6c 64 20 75 73 65 20 6e 6f 6e 2d 64 69 73 72 75 70	system..It.should.use.non-disrup
a5a0	74 69 76 65 20 72 65 6c 6f 61 64 20 77 68 65 6e 65 76 65 72 20 70 6f 73 73 69 62 6c 65 2e 20 49	tive.reload.whenever.possible..I
a5c0	74 20 6d 61 79 20 65 78 65 63 75 74 65 20 64 69 73 72 75 70 74 69 76 65 20 6f 70 65 72 61 74 69	t.may.execute.disruptive.operati
a5e0	6f 6e 73 20 73 75 63 68 20 61 73 20 64 61 65 6d 6f 6e 20 70 72 6f 63 65 73 73 20 72 65 73 74 61	ons.such.as.daemon.process.resta
a600	72 74 20 69 66 20 61 20 70 61 72 74 69 63 75 6c 61 72 20 63 6f 6d 70 6f 6e 65 6e 74 20 64 6f 65	rt.if.a.particular.component.doe
a620	73 20 6e 6f 74 20 73 75 70 70 6f 72 74 20 6e 6f 6e 2d 64 69 73 72 75 70 74 69 76 65 20 72 65 6c	s.not.support.non-disruptive.rel
a640	6f 61 64 2c 20 6f 72 20 77 68 65 6e 20 74 68 65 20 65 78 70 65 63 74 65 64 20 73 65 72 76 69 63	oad,.or.when.the.expected.servic
a660	65 20 64 65 67 72 61 64 61 74 69 6f 6e 20 69 73 20 6d 69 6e 69 6d 61 6c 20 28 66 6f 72 20 65 78	e.degradation.is.minimal.(for.ex
a680	61 6d 70 6c 65 2c 20 69 6e 20 63 61 73 65 20 6f 66 20 61 75 78 69 6c 69 61 72 79 20 73 65 72 76	ample,.in.case.of.auxiliary.serv
a6a0	69 63 65 73 20 73 75 63 68 20 61 73 20 4c 4c 44 50 64 29 2e 20 49 6e 20 63 61 73 65 20 6f 66 20	ices.such.as.LLDPd)..In.case.of.
a6c0	68 69 67 68 20 69 6d 70 61 63 74 20 73 65 72 76 69 63 65 73 20 73 75 63 68 20 61 73 20 56 50 4e	high.impact.services.such.as.VPN
a6e0	20 64 61 65 6d 6f 6e 20 61 6e 64 20 72 6f 75 74 69 6e 67 20 70 72 6f 74 6f 63 6f 6c 73 2c 20 77	.daemon.and.routing.protocols,.w
a700	68 65 6e 20 6e 6f 6e 2d 20 64 69 73 72 75 70 74 69 76 65 20 72 65 6c 6f 61 64 20 69 73 20 73 75	hen.non-.disruptive.reload.is.su
a720	70 70 6f 72 74 65 64 20 66 6f 72 20 73 6f 6d 65 20 62 75 74 20 6e 6f 74 20 61 6c 6c 20 74 79 70	pported.for.some.but.not.all.typ
a740	65 73 20 6f 66 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 63 68 61 6e 67 65 73 2c 20 73 63 72	es.of.configuration.changes,.scr
a760	69 70 74 73 20 61 75 74 68 6f 72 73 20 73 68 6f 75 6c 64 20 6d 61 6b 65 20 65 66 66 6f 72 74 20	ipts.authors.should.make.effort.
a780	74 6f 20 64 65 74 65 72 6d 69 6e 65 20 69 66 20 61 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20	to.determine.if.a.configuration.
a7a0	63 68 61 6e 67 65 20 63 61 6e 20 62 65 20 64 6f 6e 65 20 69 6e 20 61 20 6e 6f 6e 2d 64 69 73 72	change.can.be.done.in.a.non-disr
a7c0	75 70 74 69 76 65 20 77 61 79 20 61 6e 64 20 6f 6e 6c 79 20 72 65 73 6f 72 74 20 74 6f 20 64 69	uptive.way.and.only.resort.to.di
a7e0	73 72 75 70 74 69 76 65 20 72 65 73 74 61 72 74 20 69 66 20 69 74 20 63 61 6e 6e 6f 74 20 62 65	sruptive.restart.if.it.cannot.be
a800	20 61 76 6f 69 64 65 64 2e 00 54 68 65 20 60 60 67 65 6e 65 72 61 74 65 28 29 60 60 20 66 75 6e	.avoided..The.``generate()``.fun
a820	63 74 69 6f 6e 20 67 65 6e 65 72 61 74 65 73 20 63 6f 6e 66 69 67 20 66 69 6c 65 73 20 66 6f 72	ction.generates.config.files.for
a840	20 73 79 73 74 65 6d 20 63 6f 6d 70 6f 6e 65 6e 74 73 2e 00 54 68 65 20 60 60 67 65 74 5f 63 6f	.system.components..The.``get_co
a860	6e 66 69 67 28 29 60 60 20 66 75 6e 63 74 69 6f 6e 20 6d 75 73 74 20 63 6f 6e 76 65 72 74 20 74	nfig()``.function.must.convert.t
a880	68 65 20 56 79 4f 53 20 63 6f 6e 66 69 67 20 74 6f 20 61 6e 20 61 62 73 74 72 61 63 74 2c 20 69	he.VyOS.config.to.an.abstract,.i
a8a0	6e 74 65 72 6e 61 6c 20 72 65 70 72 65 73 65 6e 74 61 74 69 6f 6e 2e 20 4e 6f 20 6f 74 68 65 72	nternal.representation..No.other
a8c0	20 66 75 6e 63 74 69 6f 6e 20 69 73 20 61 6c 6c 6f 77 65 64 20 74 6f 20 63 61 6c 6c 20 74 68 65	.function.is.allowed.to.call.the
a8e0	20 60 60 76 79 6f 73 2e 63 6f 6e 66 69 67 2e 20 43 6f 6e 66 69 67 60 60 20 6f 62 6a 65 63 74 20	.``vyos.config..Config``.object.
a900	6d 65 74 68 6f 64 20 64 69 72 65 63 74 6c 79 2e 20 54 68 65 20 72 61 74 69 6f 6e 61 6c 65 20 66	method.directly..The.rationale.f
a920	6f 72 20 69 74 20 69 73 20 74 68 61 74 20 77 68 65 6e 20 63 6f 6e 66 69 67 20 72 65 61 64 73 20	or.it.is.that.when.config.reads.
a940	61 72 65 20 6d 69 78 65 64 20 77 69 74 68 20 6f 74 68 65 72 20 6c 6f 67 69 63 2c 20 69 74 27 73	are.mixed.with.other.logic,.it's
a960	20 76 65 72 79 20 68 61 72 64 20 74 6f 20 63 68 61 6e 67 65 20 74 68 65 20 63 6f 6e 66 69 67 20	.very.hard.to.change.the.config.
a980	73 79 6e 74 61 78 20 73 69 6e 63 65 20 79 6f 75 20 6e 65 65 64 20 74 6f 20 77 65 65 64 20 6f 75	syntax.since.you.need.to.weed.ou
a9a0	74 20 65 76 65 72 79 20 6f 63 63 75 72 72 65 6e 63 65 20 6f 66 20 74 68 65 20 6f 6c 64 20 73 79	t.every.occurrence.of.the.old.sy
a9c0	6e 74 61 78 2e 20 49 66 20 73 79 6e 74 61 78 2d 73 70 65 63 69 66 69 63 20 63 6f 64 65 20 69 73	ntax..If.syntax-specific.code.is
a9e0	20 63 6f 6e 66 69 6e 65 64 20 74 6f 20 61 20 73 69 6e 67 6c 65 20 66 75 6e 63 74 69 6f 6e 2c 20	.confined.to.a.single.function,.
aa00	74 68 65 20 72 65 73 74 20 6f 66 20 74 68 65 20 63 6f 64 65 20 63 61 6e 20 62 65 20 6c 65 66 74	the.rest.of.the.code.can.be.left
aa20	20 75 6e 74 6f 75 63 68 65 64 20 61 73 20 6c 6f 6e 67 20 61 73 20 74 68 65 20 69 6e 74 65 72 6e	.untouched.as.long.as.the.intern
aa40	61 6c 20 72 65 70 72 65 73 65 6e 74 61 74 69 6f 6e 20 72 65 6d 61 69 6e 73 20 63 6f 6d 70 61 74	al.representation.remains.compat
aa60	69 62 6c 65 2e 00 54 68 65 20 60 60 6d 61 6b 65 20 74 65 73 74 60 60 20 63 6f 6d 6d 61 6e 64 20	ible..The.``make.test``.command.
aa80	66 72 6f 6d 20 74 68 65 20 76 79 6f 73 2d 62 75 69 6c 64 5f 20 72 65 70 6f 73 69 74 6f 72 79 20	from.the.vyos-build_.repository.
aaa0	77 69 6c 6c 20 6c 61 75 6e 63 68 20 61 20 6e 65 77 20 51 45 6d 75 20 69 6e 73 74 61 6e 63 65 20	will.launch.a.new.QEmu.instance.
aac0	61 6e 64 20 74 68 65 20 49 53 4f 20 69 6d 61 67 65 20 69 73 20 66 69 72 73 74 20 69 6e 73 74 61	and.the.ISO.image.is.first.insta
aae0	6c 6c 65 64 20 74 6f 20 74 68 65 20 76 69 72 74 75 61 6c 20 68 61 72 64 64 69 73 6b 2e 00 54 68	lled.to.the.virtual.harddisk..Th
ab00	65 20 60 60 76 65 72 69 66 79 28 29 60 60 20 66 75 6e 63 74 69 6f 6e 20 74 61 6b 65 73 20 79 6f	e.``verify()``.function.takes.yo
ab20	75 72 20 69 6e 74 65 72 6e 61 6c 20 72 65 70 72 65 73 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68	ur.internal.representation.of.th
ab40	65 20 63 6f 6e 66 69 67 20 61 6e 64 20 63 68 65 63 6b 73 20 69 66 20 69 74 27 73 20 76 61 6c 69	e.config.and.checks.if.it's.vali
ab60	64 2c 20 6f 74 68 65 72 77 69 73 65 20 69 74 20 6d 75 73 74 20 72 61 69 73 65 20 60 60 43 6f 6e	d,.otherwise.it.must.raise.``Con
ab80	66 69 67 45 72 72 6f 72 60 60 20 77 69 74 68 20 61 6e 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65	figError``.with.an.error.message
aba0	20 74 68 61 74 20 64 65 73 63 72 69 62 65 73 20 74 68 65 20 70 72 6f 62 6c 65 6d 20 61 6e 64 20	.that.describes.the.problem.and.
abc0	70 6f 73 73 69 62 6c 79 20 73 75 67 67 65 73 74 73 20 68 6f 77 20 74 6f 20 66 69 78 20 69 74 2e	possibly.suggests.how.to.fix.it.
abe0	20 49 74 20 6d 75 73 74 20 6e 6f 74 20 6d 61 6b 65 20 61 6e 79 20 63 68 61 6e 67 65 73 20 74 6f	.It.must.not.make.any.changes.to
ac00	20 74 68 65 20 73 79 73 74 65 6d 2e 20 54 68 65 20 72 61 74 69 6f 6e 61 6c 65 20 66 6f 72 20 69	.the.system..The.rationale.for.i
ac20	74 20 69 73 20 61 67 61 69 6e 20 74 65 73 74 61 62 69 6c 69 74 79 20 61 6e 64 2c 20 69 6e 20 74	t.is.again.testability.and,.in.t
ac40	68 65 20 66 75 74 75 72 65 20 77 68 65 6e 20 74 68 65 20 63 6f 6e 66 69 67 20 62 61 63 6b 65 6e	he.future.when.the.config.backen
ac60	64 20 69 73 20 72 65 61 64 79 20 61 6e 64 20 65 76 65 72 79 20 73 63 72 69 70 74 20 69 73 20 72	d.is.ready.and.every.script.is.r
ac80	65 77 72 69 74 74 65 6e 20 69 6e 20 74 68 69 73 20 66 61 73 68 69 6f 6e 2c 20 61 62 69 6c 69 74	ewritten.in.this.fashion,.abilit
aca0	79 20 74 6f 20 65 78 65 63 75 74 65 20 63 6f 6d 6d 69 74 20 64 72 79 20 72 75 6e 20 28 22 63 6f	y.to.execute.commit.dry.run.("co
acc0	6d 6d 69 74 20 74 65 73 74 22 20 6c 69 6b 65 20 69 6e 20 4a 75 6e 4f 53 29 20 61 6e 64 20 61 62	mmit.test".like.in.JunOS).and.ab
ace0	6f 72 74 20 63 6f 6d 6d 69 74 20 62 65 66 6f 72 65 20 6d 61 6b 69 6e 67 20 61 6e 79 20 63 68 61	ort.commit.before.making.any.cha
ad00	6e 67 65 73 20 74 6f 20 74 68 65 20 73 79 73 74 65 6d 20 69 66 20 61 6e 20 65 72 72 6f 72 20 69	nges.to.the.system.if.an.error.i
ad20	73 20 66 6f 75 6e 64 20 69 6e 20 61 6e 79 20 63 6f 6d 70 6f 6e 65 6e 74 2e 00 54 68 65 20 62 61	s.found.in.any.component..The.ba
ad40	73 68 20 28 6f 72 20 62 65 74 74 65 72 20 76 62 61 73 68 29 20 63 6f 6d 70 6c 65 74 69 6f 6e 20	sh.(or.better.vbash).completion.
ad60	69 6e 20 56 79 4f 53 20 69 73 20 64 65 66 69 6e 65 64 20 69 6e 20 2a 74 65 6d 70 6c 61 74 65 73	in.VyOS.is.defined.in.*templates
ad80	2a 2e 20 54 65 6d 70 6c 61 74 65 73 20 61 72 65 20 74 65 78 74 20 66 69 6c 65 73 20 28 63 61 6c	*..Templates.are.text.files.(cal
ada0	6c 65 64 20 60 60 6e 6f 64 65 2e 64 65 66 60 60 29 20 73 74 6f 72 65 64 20 69 6e 20 61 20 64 69	led.``node.def``).stored.in.a.di
adc0	72 65 63 74 6f 72 79 20 74 72 65 65 2e 20 54 68 65 20 64 69 72 65 63 74 6f 72 79 20 6e 61 6d 65	rectory.tree..The.directory.name
ade0	73 20 64 65 66 69 6e 65 20 74 68 65 20 63 6f 6d 6d 61 6e 64 20 6e 61 6d 65 73 2c 20 61 6e 64 20	s.define.the.command.names,.and.
ae00	74 65 6d 70 6c 61 74 65 20 66 69 6c 65 73 20 64 65 66 69 6e 65 20 74 68 65 20 63 6f 6d 6d 61 6e	template.files.define.the.comman
ae20	64 20 62 65 68 61 76 69 6f 75 72 2e 20 42 65 66 6f 72 65 20 56 79 4f 53 20 31 2e 32 20 28 63 72	d.behaviour..Before.VyOS.1.2.(cr
ae40	75 78 29 20 74 68 69 73 20 66 69 6c 65 73 20 77 65 72 65 20 63 72 65 61 74 65 64 20 62 79 20 68	ux).this.files.were.created.by.h
ae60	61 6e 64 2e 20 41 66 74 65 72 20 61 20 63 6f 6d 70 6c 65 78 20 72 65 64 65 73 69 67 6e 20 70 72	and..After.a.complex.redesign.pr
ae80	6f 63 65 73 73 5f 20 74 68 65 20 6e 65 77 20 73 74 79 6c 65 20 74 65 6d 70 6c 61 74 65 20 61 72	ocess_.the.new.style.template.ar
aea0	65 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 67 65 6e 65 72 61 74 65 64 20 66 72 6f 6d 20 61	e.automatically.generated.from.a
aec0	20 58 4d 4c 20 69 6e 70 75 74 20 66 69 6c 65 2e 00 54 68 65 20 62 65 68 61 76 69 6f 72 20 79 6f	.XML.input.file..The.behavior.yo
aee0	75 20 65 78 70 65 63 74 20 61 6e 64 20 68 6f 77 20 69 74 27 73 20 64 69 66 66 65 72 65 6e 74 20	u.expect.and.how.it's.different.
af00	66 72 6f 6d 20 74 68 65 20 62 65 68 61 76 69 6f 72 20 79 6f 75 20 6f 62 73 65 72 76 65 2e 20 44	from.the.behavior.you.observe..D
af20	6f 6e 27 74 20 6a 75 73 74 20 69 6e 63 6c 75 64 65 20 63 6f 6d 6d 61 6e 64 20 6f 75 74 70 75 74	on't.just.include.command.output
af40	73 20 6f 72 20 74 72 61 66 66 69 63 20 64 75 6d 70 73 20 e2 80 94 20 74 72 79 20 74 6f 20 65 78	s.or.traffic.dumps.....try.to.ex
af60	70 6c 61 69 6e 20 61 74 20 6c 65 61 73 74 20 62 72 69 65 66 6c 79 20 77 68 79 20 74 68 65 79 20	plain.at.least.briefly.why.they.
af80	61 72 65 20 77 72 6f 6e 67 20 61 6e 64 20 77 68 61 74 20 74 68 65 79 20 73 68 6f 75 6c 64 20 62	are.wrong.and.what.they.should.b
afa0	65 2e 00 54 68 65 20 62 75 69 6c 64 20 70 72 6f 63 65 73 73 20 6e 65 65 64 73 20 74 6f 20 62 65	e..The.build.process.needs.to.be
afc0	20 62 75 69 6c 74 20 6f 6e 20 61 20 6c 6f 63 61 6c 20 66 69 6c 65 20 73 79 73 74 65 6d 2c 20 62	.built.on.a.local.file.system,.b
afe0	75 69 6c 64 69 6e 67 20 6f 6e 20 53 4d 42 20 6f 72 20 4e 46 53 20 73 68 61 72 65 73 20 77 69 6c	uilding.on.SMB.or.NFS.shares.wil
b000	6c 20 72 65 73 75 6c 74 20 69 6e 20 74 68 65 20 63 6f 6e 74 61 69 6e 65 72 20 66 61 69 6c 69 6e	l.result.in.the.container.failin
b020	67 20 74 6f 20 62 75 69 6c 64 20 70 72 6f 70 65 72 6c 79 21 20 56 69 72 74 75 61 6c 42 6f 78 20	g.to.build.properly!.VirtualBox.
b040	44 72 69 76 65 20 53 68 61 72 65 20 69 73 20 61 6c 73 6f 20 6e 6f 74 20 61 6e 20 6f 70 74 69 6f	Drive.Share.is.also.not.an.optio
b060	6e 20 61 73 20 62 6c 6f 63 6b 20 64 65 76 69 63 65 20 6f 70 65 72 61 74 69 6f 6e 73 20 61 72 65	n.as.block.device.operations.are
b080	20 6e 6f 74 20 69 6d 70 6c 65 6d 65 6e 74 65 64 20 61 6e 64 20 74 68 65 20 64 72 69 76 65 20 69	.not.implemented.and.the.drive.i
b0a0	73 20 61 6c 77 61 79 73 20 6d 6f 75 6e 74 65 64 20 61 73 20 22 6e 6f 64 65 76 22 00 54 68 65 20	s.always.mounted.as."nodev".The.
b0c0	63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 73 20 61 72 65 20 61 6c 6c 20 64 65 72 69 76 65 64 20 66	configurations.are.all.derived.f
b0e0	72 6f 6d 20 70 72 6f 64 75 63 74 69 6f 6e 20 73 79 73 74 65 6d 73 20 61 6e 64 20 63 61 6e 20 6e	rom.production.systems.and.can.n
b100	6f 74 20 6f 6e 6c 79 20 61 63 74 20 61 73 20 61 20 74 65 73 74 63 61 73 65 20 62 75 74 20 61 6c	ot.only.act.as.a.testcase.but.al
b120	73 6f 20 61 73 20 72 65 66 65 72 65 6e 63 65 20 69 66 20 6f 6e 65 20 77 61 6e 74 73 20 74 6f 20	so.as.reference.if.one.wants.to.
b140	65 6e 61 62 6c 65 20 61 20 63 65 72 74 61 69 6e 20 66 65 61 74 75 72 65 2e 20 54 68 65 20 63 6f	enable.a.certain.feature..The.co
b160	6e 66 69 67 75 72 61 74 69 6f 6e 73 20 63 61 6e 20 62 65 20 66 6f 75 6e 64 20 68 65 72 65 3a 20	nfigurations.can.be.found.here:.
b180	68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 76 79 6f 73 2f 76 79 6f 73 2d 31 78 2f	https://github.com/vyos/vyos-1x/
b1a0	74 72 65 65 2f 63 75 72 72 65 6e 74 2f 73 6d 6f 6b 65 74 65 73 74 2f 63 6f 6e 66 69 67 73 00 54	tree/current/smoketest/configs.T
b1c0	68 65 20 63 6f 6e 74 61 69 6e 65 72 20 63 61 6e 20 61 6c 73 6f 20 62 65 20 62 75 69 6c 74 20 64	he.container.can.also.be.built.d
b1e0	69 72 65 63 74 6c 79 20 66 72 6f 6d 20 73 6f 75 72 63 65 3a 00 54 68 65 20 63 6f 6e 74 61 69 6e	irectly.from.source:.The.contain
b200	65 72 20 63 61 6e 20 62 65 20 62 75 69 6c 74 20 62 79 20 68 61 6e 64 20 6f 72 20 62 79 20 66 65	er.can.be.built.by.hand.or.by.fe
b220	74 63 68 69 6e 67 20 74 68 65 20 70 72 65 2d 62 75 69 6c 74 20 6f 6e 65 20 66 72 6f 6d 20 44 6f	tching.the.pre-built.one.from.Do
b240	63 6b 65 72 48 75 62 2e 20 55 73 69 6e 67 20 74 68 65 20 70 72 65 2d 62 75 69 6c 74 20 63 6f 6e	ckerHub..Using.the.pre-built.con
b260	74 61 69 6e 65 72 73 20 66 72 6f 6d 20 74 68 65 20 60 56 79 4f 53 20 44 6f 63 6b 65 72 48 75 62	tainers.from.the.`VyOS.DockerHub
b280	20 6f 72 67 61 6e 69 73 61 74 69 6f 6e 60 5f 20 77 69 6c 6c 20 65 6e 73 75 72 65 20 74 68 61 74	.organisation`_.will.ensure.that
b2a0	20 74 68 65 20 63 6f 6e 74 61 69 6e 65 72 20 69 73 20 61 6c 77 61 79 73 20 75 70 2d 74 6f 2d 64	.the.container.is.always.up-to-d
b2c0	61 74 65 2e 20 41 20 72 65 62 75 69 6c 64 20 69 73 20 74 72 69 67 67 65 72 65 64 20 6f 6e 63 65	ate..A.rebuild.is.triggered.once
b2e0	20 74 68 65 20 63 6f 6e 74 61 69 6e 65 72 20 63 68 61 6e 67 65 73 20 28 70 6c 65 61 73 65 20 6e	.the.container.changes.(please.n
b300	6f 74 65 20 74 68 69 73 20 77 69 6c 6c 20 74 61 6b 65 20 32 2d 33 20 68 6f 75 72 73 20 61 66 74	ote.this.will.take.2-3.hours.aft
b320	65 72 20 70 75 73 68 69 6e 67 20 74 6f 20 74 68 65 20 76 79 6f 73 2d 62 75 69 6c 64 20 72 65 70	er.pushing.to.the.vyos-build.rep
b340	6f 73 69 74 6f 72 79 29 2e 00 54 68 65 20 64 65 66 61 75 6c 74 20 74 65 6d 70 6c 61 74 65 20 70	ository)..The.default.template.p
b360	72 6f 63 65 73 73 6f 72 20 66 6f 72 20 56 79 4f 53 20 63 6f 64 65 20 69 73 20 4a 69 6e 6a 61 32	rocessor.for.VyOS.code.is.Jinja2
b380	5f 2e 00 54 68 65 20 65 61 73 69 65 73 74 20 77 61 79 20 74 6f 20 63 6f 6d 70 69 6c 65 20 79 6f	_..The.easiest.way.to.compile.yo
b3a0	75 72 20 70 61 63 6b 61 67 65 20 69 73 20 77 69 74 68 20 74 68 65 20 61 62 6f 76 65 20 6d 65 6e	ur.package.is.with.the.above.men
b3c0	74 69 6f 6e 65 64 20 3a 72 65 66 3a 60 62 75 69 6c 64 5f 64 6f 63 6b 65 72 60 20 63 6f 6e 74 61	tioned.:ref:`build_docker`.conta
b3e0	69 6e 65 72 2c 20 69 74 20 69 6e 63 6c 75 64 65 73 20 61 6c 6c 20 72 65 71 75 69 72 65 64 20 64	iner,.it.includes.all.required.d
b400	65 70 65 6e 64 65 6e 63 69 65 73 20 66 6f 72 20 61 6c 6c 20 56 79 4f 53 20 72 65 6c 61 74 65 64	ependencies.for.all.VyOS.related
b420	20 70 61 63 6b 61 67 65 73 2e 00 54 68 65 20 65 6e 74 69 72 65 20 74 65 73 74 20 69 73 20 63 6f	.packages..The.entire.test.is.co
b440	6e 74 72 6f 6c 6c 65 64 20 62 79 20 74 68 65 20 6d 61 69 6e 20 77 72 61 70 70 65 72 20 73 63 72	ntrolled.by.the.main.wrapper.scr
b460	69 70 74 20 60 60 2f 75 73 72 2f 62 69 6e 2f 76 79 6f 73 2d 63 6f 6e 66 69 67 74 65 73 74 60 60	ipt.``/usr/bin/vyos-configtest``
b480	20 77 68 69 63 68 20 62 65 68 61 76 65 73 20 69 6e 20 74 68 65 20 73 61 6d 65 20 77 61 79 20 61	.which.behaves.in.the.same.way.a
b4a0	73 20 74 68 65 20 6d 61 69 6e 20 73 6d 6f 6b 65 74 65 73 74 20 73 63 72 69 70 74 2e 20 49 74 20	s.the.main.smoketest.script..It.
b4c0	73 63 61 6e 73 20 74 68 65 20 66 6f 6c 64 65 72 20 66 6f 72 20 70 6f 74 65 6e 74 69 61 6c 20 63	scans.the.folder.for.potential.c
b4e0	6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 66 69 6c 65 73 20 61 6e 64 20 69 73 73 75 65 73 20 61 20	onfiguration.files.and.issues.a.
b500	60 60 6c 6f 61 64 60 60 20 63 6f 6d 6d 61 6e 64 20 6f 6e 65 20 61 66 74 65 72 20 61 6e 6f 74 68	``load``.command.one.after.anoth
b520	65 72 2e 00 54 68 65 20 66 69 6c 65 20 63 61 6e 20 62 65 20 70 6c 61 63 65 64 20 69 6e 20 60 60	er..The.file.can.be.placed.in.``
b540	2f 74 6d 70 60 60 20 66 6f 72 20 6f 6e 65 20 74 69 6d 65 20 64 65 62 75 67 67 69 6e 67 20 28 61	/tmp``.for.one.time.debugging.(a
b560	73 20 74 68 65 20 66 69 6c 65 20 77 69 6c 6c 20 62 65 20 72 65 6d 6f 76 65 64 20 6f 6e 20 72 65	s.the.file.will.be.removed.on.re
b580	62 6f 6f 74 29 20 6f 72 20 70 6c 61 63 65 64 20 69 6e 20 27 2f 63 6f 6e 66 69 67 27 20 74 6f 20	boot).or.placed.in.'/config'.to.
b5a0	73 74 61 79 20 70 65 72 6d 61 6e 65 6e 74 6c 79 2e 00 54 68 65 20 66 69 72 73 74 20 77 6f 72 64	stay.permanently..The.first.word
b5c0	20 6f 66 20 65 76 65 72 79 20 68 65 6c 70 20 73 74 72 69 6e 67 20 2a 2a 6d 75 73 74 2a 2a 20 62	.of.every.help.string.**must**.b
b5e0	65 20 63 61 70 69 74 61 6c 69 7a 65 64 2e 20 54 68 65 72 65 20 2a 2a 6d 75 73 74 20 6e 6f 74 2a	e.capitalized..There.**must.not*
b600	2a 20 62 65 20 61 20 70 65 72 69 6f 64 20 61 74 20 74 68 65 20 65 6e 64 20 6f 66 20 68 65 6c 70	*.be.a.period.at.the.end.of.help
b620	20 73 74 72 69 6e 67 73 2e 00 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 69 6e 63 6c 75 64 65 73	.strings..The.following.includes
b640	20 74 68 65 20 62 75 69 6c 64 20 70 72 6f 63 65 73 73 20 66 6f 72 20 56 79 4f 53 20 31 2e 32 20	.the.build.process.for.VyOS.1.2.
b660	74 6f 20 74 68 65 20 6c 61 74 65 73 74 20 76 65 72 73 69 6f 6e 2e 00 54 68 65 20 66 6f 72 6d 61	to.the.latest.version..The.forma
b680	74 20 73 68 6f 75 6c 64 20 62 65 20 61 6e 64 20 69 73 20 69 6e 73 70 69 72 65 64 20 62 79 3a 20	t.should.be.and.is.inspired.by:.
b6a0	68 74 74 70 73 3a 2f 2f 67 69 74 2d 73 63 6d 2e 63 6f 6d 2f 62 6f 6f 6b 2f 63 68 35 2d 32 2e 68	https://git-scm.com/book/ch5-2.h
b6c0	74 6d 6c 20 49 74 20 69 73 20 61 6c 73 6f 20 77 6f 72 74 68 20 72 65 61 64 69 6e 67 20 68 74 74	tml.It.is.also.worth.reading.htt
b6e0	70 73 3a 2f 2f 63 68 72 69 73 2e 62 65 61 6d 73 2e 69 6f 2f 70 6f 73 74 73 2f 67 69 74 2d 63 6f	ps://chris.beams.io/posts/git-co
b700	6d 6d 69 74 2f 00 54 68 65 20 67 72 65 61 74 20 74 68 69 6e 67 20 61 62 6f 75 74 20 73 63 68 65	mmit/.The.great.thing.about.sche
b720	6d 61 73 20 69 73 20 6e 6f 74 20 6f 6e 6c 79 20 74 68 61 74 20 70 65 6f 70 6c 65 20 63 61 6e 20	mas.is.not.only.that.people.can.
b740	6b 6e 6f 77 20 74 68 65 20 63 6f 6d 70 6c 65 74 65 20 67 72 61 6d 6d 61 72 20 66 6f 72 20 63 65	know.the.complete.grammar.for.ce
b760	72 74 61 69 6e 2c 20 62 75 74 20 61 6c 73 6f 20 74 68 61 74 20 69 74 20 63 61 6e 20 62 65 20 61	rtain,.but.also.that.it.can.be.a
b780	75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 76 65 72 69 66 69 65 64 2e 20 54 68 65 20 60 73 63 72 69	utomatically.verified..The.`scri
b7a0	70 74 73 2f 62 75 69 6c 64 2d 63 6f 6d 6d 61 6e 64 2d 74 65 6d 70 6c 61 74 65 73 60 20 73 63 72	pts/build-command-templates`.scr
b7c0	69 70 74 20 74 68 61 74 20 63 6f 6e 76 65 72 74 73 20 74 68 65 20 58 4d 4c 20 64 65 66 69 6e 69	ipt.that.converts.the.XML.defini
b7e0	74 69 6f 6e 73 20 74 6f 20 6f 6c 64 20 73 74 79 6c 65 20 74 65 6d 70 6c 61 74 65 73 20 61 6c 73	tions.to.old.style.templates.als
b800	6f 20 76 65 72 69 66 69 65 73 20 74 68 65 6d 20 61 67 61 69 6e 73 74 20 74 68 65 20 73 63 68 65	o.verifies.them.against.the.sche
b820	6d 61 2c 20 73 6f 20 61 20 62 61 64 20 64 65 66 69 6e 69 74 69 6f 6e 20 77 69 6c 6c 20 63 61 75	ma,.so.a.bad.definition.will.cau
b840	73 65 20 74 68 65 20 70 61 63 6b 61 67 65 20 62 75 69 6c 64 20 74 6f 20 66 61 69 6c 2e 20 49 20	se.the.package.build.to.fail..I.
b860	64 6f 20 61 67 72 65 65 20 74 68 61 74 20 74 68 65 20 66 6f 72 6d 61 74 20 69 73 20 76 65 72 62	do.agree.that.the.format.is.verb
b880	6f 73 65 2c 20 62 75 74 20 74 68 65 72 65 20 69 73 20 6e 6f 20 6f 74 68 65 72 20 66 6f 72 6d 61	ose,.but.there.is.no.other.forma
b8a0	74 20 6e 6f 77 20 74 68 61 74 20 77 6f 75 6c 64 20 61 6c 6c 6f 77 20 74 68 69 73 2e 20 42 65 73	t.now.that.would.allow.this..Bes
b8c0	69 64 65 73 2c 20 61 20 73 70 65 63 69 61 6c 69 7a 65 64 20 58 4d 4c 20 65 64 69 74 6f 72 20 63	ides,.a.specialized.XML.editor.c
b8e0	61 6e 20 61 6c 6c 65 76 69 61 74 65 20 74 68 65 20 69 73 73 75 65 20 77 69 74 68 20 76 65 72 62	an.alleviate.the.issue.with.verb
b900	6f 73 69 74 79 2e 00 54 68 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 69 73 20 75 73 65 64 20 69	osity..The.information.is.used.i
b920	6e 20 74 68 72 65 65 20 77 61 79 73 3a 00 54 68 65 20 6b 65 72 6e 65 6c 20 62 75 69 6c 64 20 69	n.three.ways:.The.kernel.build.i
b940	73 20 71 75 69 74 65 20 65 61 73 79 2c 20 6d 6f 73 74 20 6f 66 20 74 68 65 20 72 65 71 75 69 72	s.quite.easy,.most.of.the.requir
b960	65 64 20 73 74 65 70 73 20 63 61 6e 20 62 65 20 66 6f 75 6e 64 20 69 6e 20 74 68 65 20 60 60 76	ed.steps.can.be.found.in.the.``v
b980	79 6f 73 2d 62 75 69 6c 64 2f 70 61 63 6b 61 67 65 73 2f 6c 69 6e 75 78 2d 6b 65 72 6e 65 6c 2f	yos-build/packages/linux-kernel/
b9a0	4a 65 6e 6b 69 6e 73 66 69 6c 65 60 60 20 62 75 74 20 77 65 20 77 69 6c 6c 20 77 61 6c 6b 20 79	Jenkinsfile``.but.we.will.walk.y
b9c0	6f 75 20 74 68 72 6f 75 67 68 20 69 74 2e 00 54 68 65 20 6d 6f 73 74 20 6f 62 76 69 6f 75 73 20	ou.through.it..The.most.obvious.
b9e0	72 65 61 73 6f 6e 73 20 63 6f 75 6c 64 20 62 65 3a 00 54 68 65 20 6f 72 69 67 69 6e 61 6c 20 72	reasons.could.be:.The.original.r
ba00	65 70 6f 20 69 73 20 61 74 20 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 64 6d 62	epo.is.at.https://github.com/dmb
ba20	61 74 75 72 69 6e 2f 68 76 69 6e 66 6f 00 54 68 65 20 6f 74 68 65 72 20 70 61 72 74 20 6f 66 20	aturin/hvinfo.The.other.part.of.
ba40	6f 75 72 20 74 65 73 74 73 20 61 72 65 20 63 61 6c 6c 65 64 20 22 63 6f 6e 66 69 67 20 6c 6f 61	our.tests.are.called."config.loa
ba60	64 20 74 65 73 74 73 22 2e 20 54 68 65 20 63 6f 6e 66 69 67 20 6c 6f 61 64 20 74 65 73 74 73 20	d.tests"..The.config.load.tests.
ba80	77 69 6c 6c 20 6c 6f 61 64 20 2d 20 6f 6e 65 20 61 66 74 65 72 20 61 6e 6f 74 68 65 72 20 2d 20	will.load.-.one.after.another.-.
baa0	61 72 62 69 74 72 61 72 79 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 66 69 6c 65 73 20 74 6f	arbitrary.configuration.files.to
bac0	20 74 65 73 74 20 69 66 20 74 68 65 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 6d 69 67 72 61	.test.if.the.configuration.migra
bae0	74 69 6f 6e 20 73 63 72 69 70 74 73 20 77 6f 72 6b 20 61 73 20 64 65 73 69 67 6e 65 64 20 61 6e	tion.scripts.work.as.designed.an
bb00	64 20 74 68 61 74 20 61 20 67 69 76 65 6e 20 73 65 74 20 6f 66 20 66 75 6e 63 74 69 6f 6e 61 6c	d.that.a.given.set.of.functional
bb20	69 74 79 20 73 74 69 6c 6c 20 63 61 6e 20 62 65 20 6c 6f 61 64 65 64 20 77 69 74 68 20 61 20 66	ity.still.can.be.loaded.with.a.f
bb40	72 65 73 68 20 56 79 4f 53 20 49 53 4f 20 69 6d 61 67 65 2e 00 54 68 65 20 6f 75 74 70 75 74 20	resh.VyOS.ISO.image..The.output.
bb60	79 6f 75 20 67 65 74 20 77 68 65 6e 20 79 6f 75 20 66 69 6e 64 20 61 20 62 75 67 20 63 61 6e 20	you.get.when.you.find.a.bug.can.
bb80	70 72 6f 76 69 64 65 20 6c 6f 74 73 20 6f 66 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e 20 49 66 20	provide.lots.of.information..If.
bba0	79 6f 75 20 67 65 74 20 61 6e 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65 20 6f 6e 20 74 68 65 20	you.get.an.error.message.on.the.
bbc0	73 63 72 65 65 6e 2c 20 63 6f 70 79 20 69 74 20 65 78 61 63 74 6c 79 2e 20 48 61 76 69 6e 67 20	screen,.copy.it.exactly..Having.
bbe0	74 68 65 20 65 78 61 63 74 20 6d 65 73 73 61 67 65 20 63 61 6e 20 70 72 6f 76 69 64 65 20 64 65	the.exact.message.can.provide.de
bc00	74 61 69 6c 20 74 68 61 74 20 74 68 65 20 64 65 76 65 6c 6f 70 65 72 73 20 63 61 6e 20 75 73 65	tail.that.the.developers.can.use
bc20	2e 20 4c 69 6b 65 20 77 69 73 65 20 69 66 20 79 6f 75 20 68 61 76 65 20 61 6e 79 20 6c 6f 67 20	..Like.wise.if.you.have.any.log.
bc40	6d 65 73 73 61 67 65 73 20 74 68 61 74 20 61 6c 73 6f 20 61 72 65 20 66 72 6f 6d 20 74 68 65 20	messages.that.also.are.from.the.
bc60	74 69 6d 65 20 6f 66 20 74 68 65 20 69 73 73 75 65 2c 20 69 6e 63 6c 75 64 65 20 74 68 6f 73 65	time.of.the.issue,.include.those
bc80	2e 20 54 68 65 79 20 6d 61 79 20 61 6c 73 6f 20 63 6f 6e 74 61 69 6e 20 69 6e 66 6f 72 6d 61 74	..They.may.also.contain.informat
bca0	69 6f 6e 20 74 68 61 74 20 69 73 20 68 65 6c 70 66 75 6c 20 66 6f 72 20 74 68 65 20 64 65 76 65	ion.that.is.helpful.for.the.deve
bcc0	6c 6f 70 6d 65 6e 74 20 74 65 61 6d 2e 00 54 68 65 20 70 61 63 6b 61 67 65 20 65 6e 64 73 20 75	lopment.team..The.package.ends.u
bce0	70 20 69 6e 20 64 65 62 5f 64 69 73 74 20 64 69 72 2e 00 54 68 65 20 72 65 61 73 6f 6e 20 69 73	p.in.deb_dist.dir..The.reason.is
bd00	20 74 68 61 74 20 74 68 65 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 6d 69 67 72 61 74 69 6f	.that.the.configuration.migratio
bd20	6e 20 62 61 63 6b 65 6e 64 20 69 73 20 72 65 77 72 69 74 74 65 6e 20 61 6e 64 20 75 73 65 73 20	n.backend.is.rewritten.and.uses.
bd40	61 20 6e 65 77 20 66 6f 72 6d 20 6f 66 20 22 6d 61 67 69 63 20 73 74 72 69 6e 67 22 20 77 68 69	a.new.form.of."magic.string".whi
bd60	63 68 20 69 73 20 61 70 70 6c 69 65 64 20 6f 6e 20 64 65 6d 61 6e 64 20 77 68 65 6e 20 72 65 61	ch.is.applied.on.demand.when.rea
bd80	6c 20 63 6f 6e 66 69 67 20 6d 69 67 72 61 74 69 6f 6e 20 69 73 20 72 75 6e 20 6f 6e 20 62 6f 6f	l.config.migration.is.run.on.boo
bda0	74 2e 20 57 68 65 6e 20 72 75 6e 6e 69 6e 67 20 69 6e 64 69 76 69 64 75 61 6c 20 6d 69 67 72 61	t..When.running.individual.migra
bdc0	74 6f 72 73 20 66 6f 72 20 74 65 73 74 69 6e 67 2c 20 79 6f 75 20 6e 65 65 64 20 74 6f 20 63 6f	tors.for.testing,.you.need.to.co
bde0	6e 76 65 72 74 20 74 68 65 20 22 6d 61 67 69 63 20 73 74 72 69 6e 67 22 20 6f 6e 20 79 6f 75 72	nvert.the."magic.string".on.your
be00	20 6f 77 6e 20 62 79 3a 00 54 68 65 20 72 65 61 73 6f 6e 20 69 73 20 74 68 61 74 20 74 68 65 20	.own.by:.The.reason.is.that.the.
be20	63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 6d 69 67 72 61 74 69 6f 6e 20 62 61 63 6b 65 6e 64 20	configuration.migration.backend.
be40	69 73 20 72 65 77 72 69 74 74 65 6e 20 61 6e 64 20 75 73 65 73 20 61 20 6e 65 77 20 66 6f 72 6d	is.rewritten.and.uses.a.new.form
be60	20 6f 66 20 22 6d 61 67 69 63 20 73 74 72 69 6e 67 22 20 77 68 69 63 68 20 69 73 20 61 70 70 6c	.of."magic.string".which.is.appl
be80	69 65 64 20 6f 6e 20 64 65 6d 61 6e 64 20 77 68 65 6e 20 72 65 61 6c 20 63 6f 6e 66 69 67 20 6d	ied.on.demand.when.real.config.m
bea0	69 67 72 61 74 69 6f 6e 20 69 73 20 72 75 6e 20 6f 6e 20 62 6f 6f 74 2e 20 57 68 65 6e 20 72 75	igration.is.run.on.boot..When.ru
bec0	6e 6e 69 6e 74 20 69 6e 64 69 76 69 64 75 61 6c 20 6d 69 67 72 61 74 6f 72 73 20 66 6f 72 20 74	nnint.individual.migrators.for.t
bee0	65 73 74 69 6e 67 2c 20 79 6f 75 20 6e 65 65 64 20 74 6f 20 63 6f 6e 76 65 72 74 20 74 68 65 20	esting,.you.need.to.convert.the.
bf00	22 6d 61 67 69 63 20 73 74 72 69 6e 67 22 20 6f 6e 20 79 6f 75 72 20 6f 77 6e 20 62 79 3a 00 54	"magic.string".on.your.own.by:.T
bf20	68 65 20 72 65 70 6f 73 69 74 6f 72 79 20 74 68 61 74 20 63 6f 6e 74 61 69 6e 73 20 61 6c 6c 20	he.repository.that.contains.all.
bf40	74 68 65 20 49 53 4f 20 62 75 69 6c 64 20 73 63 72 69 70 74 73 20 69 73 3a 20 68 74 74 70 73 3a	the.ISO.build.scripts.is:.https:
bf60	2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 76 79 6f 73 2f 76 79 6f 73 2d 62 75 69 6c 64 00 54 68 65	//github.com/vyos/vyos-build.The
bf80	20 73 63 72 69 70 74 20 6f 6e 6c 79 20 73 65 61 72 63 68 65 73 20 66 6f 72 20 65 78 65 63 75 74	.script.only.searches.for.execut
bfa0	61 62 6c 65 20 22 74 65 73 74 2d 63 61 73 65 73 22 20 75 6e 64 65 72 20 60 60 2f 75 73 72 2f 6c	able."test-cases".under.``/usr/l
bfc0	69 62 65 78 65 63 2f 76 79 6f 73 2f 74 65 73 74 73 2f 73 6d 6f 6b 65 2f 63 6c 69 2f 60 60 20 61	ibexec/vyos/tests/smoke/cli/``.a
bfe0	6e 64 20 65 78 65 63 75 74 65 73 20 74 68 65 6d 20 6f 6e 65 20 62 79 20 6f 6e 65 2e 00 54 68 65	nd.executes.them.one.by.one..The
c000	20 73 6f 75 72 63 65 20 63 6f 64 65 20 72 65 6d 61 69 6e 73 20 70 75 62 6c 69 63 20 61 6e 64 20	.source.code.remains.public.and.
c020	61 6e 20 49 53 4f 20 63 61 6e 20 62 65 20 62 75 69 6c 74 20 75 73 69 6e 67 20 74 68 65 20 70 72	an.ISO.can.be.built.using.the.pr
c040	6f 63 65 73 73 20 6f 75 74 6c 69 6e 65 64 20 69 6e 20 74 68 69 73 20 63 68 61 70 74 65 72 2e 00	ocess.outlined.in.this.chapter..
c060	54 68 65 20 73 6f 75 72 63 65 20 69 73 20 61 74 20 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e	The.source.is.at.https://github.
c080	63 6f 6d 2f 76 79 6f 73 2f 76 79 6f 73 2d 73 74 72 6f 6e 67 73 77 61 6e 00 54 68 65 20 73 6f 75	com/vyos/vyos-strongswan.The.sou
c0a0	72 63 65 20 69 73 20 6c 6f 63 61 74 65 64 20 61 74 20 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62	rce.is.located.at.https://github
c0c0	2e 63 6f 6d 2f 76 79 6f 73 2f 76 79 6f 73 2d 6e 65 74 70 6c 75 67 00 54 68 65 20 73 77 69 74 63	.com/vyos/vyos-netplug.The.switc
c0e0	68 20 74 6f 20 74 68 65 20 50 79 74 68 6f 6e 20 70 72 6f 67 72 61 6d 6d 69 6e 67 20 6c 61 6e 67	h.to.the.Python.programming.lang
c100	75 61 67 65 20 66 6f 72 20 6e 65 77 20 63 6f 64 65 20 69 73 20 6e 6f 74 20 6d 65 72 65 6c 79 20	uage.for.new.code.is.not.merely.
c120	61 20 63 68 61 6e 67 65 20 6f 66 20 74 68 65 20 6c 61 6e 67 75 61 67 65 2c 20 62 75 74 20 61 20	a.change.of.the.language,.but.a.
c140	63 68 61 6e 63 65 20 74 6f 20 72 65 74 68 69 6e 6b 20 61 6e 64 20 69 6d 70 72 6f 76 65 20 74 68	chance.to.rethink.and.improve.th
c160	65 20 70 72 6f 67 72 61 6d 6d 69 6e 67 20 61 70 70 72 6f 61 63 68 2e 00 54 68 65 20 73 79 73 74	e.programming.approach..The.syst
c180	65 6d 20 73 74 61 72 74 75 70 20 63 61 6e 20 62 65 20 64 65 62 75 67 67 65 64 20 28 6c 69 6b 65	em.startup.can.be.debugged.(like
c1a0	20 6c 6f 61 64 69 6e 67 20 69 6e 20 74 68 65 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 66 69	.loading.in.the.configuration.fi
c1c0	6c 65 20 66 72 6f 6d 20 60 60 2f 63 6f 6e 66 69 67 2f 63 6f 6e 66 69 67 2e 62 6f 6f 74 60 60 2e	le.from.``/config/config.boot``.
c1e0	20 54 68 69 73 20 63 61 6e 20 62 65 20 61 63 68 69 65 76 65 20 62 79 20 65 78 74 65 6e 64 69 6e	.This.can.be.achieve.by.extendin
c200	67 20 74 68 65 20 4b 65 72 6e 65 6c 20 63 6f 6d 6d 61 6e 64 2d 6c 69 6e 65 20 69 6e 20 74 68 65	g.the.Kernel.command-line.in.the
c220	20 62 6f 6f 74 6c 6f 61 64 65 72 2e 00 54 68 65 72 65 20 61 72 65 20 28 72 61 72 65 29 20 73 69	.bootloader..There.are.(rare).si
c240	74 75 61 74 69 6f 6e 73 20 77 68 65 72 65 20 62 75 69 6c 64 69 6e 67 20 61 6e 20 49 53 4f 20 69	tuations.where.building.an.ISO.i
c260	6d 61 67 65 20 69 73 20 6e 6f 74 20 70 6f 73 73 69 62 6c 65 20 61 74 20 61 6c 6c 20 64 75 65 20	mage.is.not.possible.at.all.due.
c280	74 6f 20 61 20 62 72 6f 6b 65 6e 20 70 61 63 6b 61 67 65 20 66 65 65 64 20 69 6e 20 74 68 65 20	to.a.broken.package.feed.in.the.
c2a0	62 61 63 6b 67 72 6f 75 6e 64 2e 20 41 50 54 20 69 73 20 6e 6f 74 20 76 65 72 79 20 67 6f 6f 64	background..APT.is.not.very.good
c2c0	20 61 74 20 72 65 70 6f 72 74 69 6e 67 20 74 68 65 20 72 6f 6f 74 20 63 61 75 73 65 20 6f 66 20	.at.reporting.the.root.cause.of.
c2e0	74 68 65 20 69 73 73 75 65 2e 20 59 6f 75 72 20 49 53 4f 20 62 75 69 6c 64 20 77 69 6c 6c 20 6c	the.issue..Your.ISO.build.will.l
c300	69 6b 65 6c 79 20 66 61 69 6c 20 77 69 74 68 20 61 20 6d 6f 72 65 20 6f 72 20 6c 65 73 73 20 73	ikely.fail.with.a.more.or.less.s
c320	69 6d 69 6c 61 72 20 6c 6f 6f 6b 69 6e 67 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65 3a 00 54 68	imilar.looking.error.message:.Th
c340	65 72 65 20 61 72 65 20 64 69 66 66 65 72 65 6e 74 20 77 61 79 73 20 79 6f 75 20 63 61 6e 20 62	ere.are.different.ways.you.can.b
c360	75 69 6c 64 20 56 79 4f 53 2e 00 54 68 65 72 65 20 61 72 65 20 65 78 74 65 6e 73 69 6f 6e 73 20	uild.VyOS..There.are.extensions.
c380	74 6f 20 65 2e 67 2e 20 56 49 4d 20 28 78 6d 6c 6c 69 6e 74 29 20 77 68 69 63 68 20 77 69 6c 6c	to.e.g..VIM.(xmllint).which.will
c3a0	20 68 65 6c 70 20 79 6f 75 20 74 6f 20 67 65 74 20 79 6f 75 72 20 69 6e 64 65 6e 74 69 6f 6e 20	.help.you.to.get.your.indention.
c3c0	6c 65 76 65 6c 73 20 63 6f 72 72 65 63 74 2e 20 41 64 64 20 74 6f 20 66 6f 6c 6c 6f 77 69 6e 67	levels.correct..Add.to.following
c3e0	20 74 6f 20 79 6f 75 72 20 2e 76 69 6d 72 63 20 66 69 6c 65 3a 20 60 60 61 75 20 46 69 6c 65 54	.to.your..vimrc.file:.``au.FileT
c400	79 70 65 20 78 6d 6c 20 73 65 74 6c 6f 63 61 6c 20 65 71 75 61 6c 70 72 67 3d 78 6d 6c 6c 69 6e	ype.xml.setlocal.equalprg=xmllin
c420	74 5c 20 2d 2d 66 6f 72 6d 61 74 5c 20 2d 2d 72 65 63 6f 76 65 72 5c 20 2d 5c 20 32 3e 2f 64 65	t\.--format\.--recover\.-\.2>/de
c440	76 2f 6e 75 6c 6c 60 60 20 6e 6f 77 20 79 6f 75 20 63 61 6e 20 63 61 6c 6c 20 74 68 65 20 6c 69	v/null``.now.you.can.call.the.li
c460	6e 74 65 72 20 75 73 69 6e 67 20 60 60 67 67 3d 47 60 60 20 69 6e 20 63 6f 6d 6d 61 6e 64 20 6d	nter.using.``gg=G``.in.command.m
c480	6f 64 65 2e 00 54 68 65 72 65 20 61 72 65 20 74 77 6f 20 66 6c 61 67 73 20 61 76 61 69 6c 61 62	ode..There.are.two.flags.availab
c4a0	6c 65 20 74 6f 20 61 69 64 20 69 6e 20 64 65 62 75 67 67 69 6e 67 20 63 6f 6e 66 69 67 75 72 61	le.to.aid.in.debugging.configura
c4c0	74 69 6f 6e 20 73 63 72 69 70 74 73 2e 20 53 69 6e 63 65 20 63 6f 6e 66 69 67 75 72 61 74 69 6f	tion.scripts..Since.configuratio
c4e0	6e 20 6c 6f 61 64 69 6e 67 20 69 73 73 75 65 73 20 77 69 6c 6c 20 6d 61 6e 69 66 65 73 74 20 64	n.loading.issues.will.manifest.d
c500	75 72 69 6e 67 20 62 6f 6f 74 2c 20 74 68 65 20 66 6c 61 67 73 20 61 72 65 20 70 61 73 73 65 64	uring.boot,.the.flags.are.passed
c520	20 61 73 20 6b 65 72 6e 65 6c 20 62 6f 6f 74 20 70 61 72 61 6d 65 74 65 72 73 2e 00 54 68 65 72	.as.kernel.boot.parameters..Ther
c540	65 20 69 73 20 61 20 73 70 65 63 69 61 6c 20 73 74 61 74 75 73 20 66 6f 72 20 74 61 73 6b 73 20	e.is.a.special.status.for.tasks.
c560	77 68 65 72 65 20 61 6c 6c 20 77 6f 72 6b 20 6f 6e 20 74 68 65 20 73 69 64 65 20 6f 66 20 6d 61	where.all.work.on.the.side.of.ma
c580	69 6e 74 61 69 6e 65 72 73 20 61 6e 64 20 63 6f 6e 74 72 69 62 75 74 6f 72 73 20 69 73 20 63 6f	intainers.and.contributors.is.co
c5a0	6d 70 6c 65 74 65 3a 20 22 4e 65 65 64 73 20 72 65 70 6f 72 74 65 72 20 61 63 74 69 6f 6e 22 2e	mplete:."Needs.reporter.action".
c5c0	00 54 68 69 73 20 49 53 4f 20 63 61 6e 20 62 65 20 63 75 73 74 6f 6d 69 7a 65 64 20 77 69 74 68	.This.ISO.can.be.customized.with
c5e0	20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 6c 69 73 74 20 6f 66 20 63 6f 6e 66 69 67 75 72 65	.the.following.list.of.configure
c600	20 6f 70 74 69 6f 6e 73 2e 20 54 68 65 20 66 75 6c 6c 20 61 6e 64 20 63 75 72 72 65 6e 74 20 6c	.options..The.full.and.current.l
c620	69 73 74 20 63 61 6e 20 62 65 20 67 65 6e 65 72 61 74 65 64 20 77 69 74 68 20 60 60 2e 2f 62 75	ist.can.be.generated.with.``./bu
c640	69 6c 64 2d 76 79 6f 73 2d 69 6d 61 67 65 20 2d 2d 68 65 6c 70 60 60 3a 00 54 68 69 73 20 63 61	ild-vyos-image.--help``:.This.ca
c660	6e 20 61 6c 73 6f 20 62 65 20 64 6f 6e 65 20 70 65 72 6d 61 6e 65 6e 74 6c 79 20 62 79 20 63 68	n.also.be.done.permanently.by.ch
c680	61 6e 67 69 6e 67 20 60 60 2f 62 6f 6f 74 2f 67 72 75 62 2f 67 72 75 62 2e 63 66 67 60 60 2e 00	anging.``/boot/grub/grub.cfg``..
c6a0	54 68 69 73 20 63 68 61 70 74 65 72 20 6c 69 73 74 73 20 74 68 6f 73 65 20 65 78 63 65 70 74 69	This.chapter.lists.those.excepti
c6c0	6f 6e 73 20 61 6e 64 20 67 69 76 65 73 20 79 6f 75 20 61 20 62 72 69 65 66 20 6f 76 65 72 76 69	ons.and.gives.you.a.brief.overvi
c6e0	65 77 20 77 68 61 74 20 77 65 20 68 61 76 65 20 64 6f 6e 65 20 6f 6e 20 74 68 6f 73 65 20 70 61	ew.what.we.have.done.on.those.pa
c700	63 6b 61 67 65 73 2e 20 49 66 20 79 6f 75 20 6f 6e 6c 79 20 77 61 6e 74 20 74 6f 20 62 75 69 6c	ckages..If.you.only.want.to.buil
c720	64 20 79 6f 75 72 73 65 6c 66 20 61 20 66 72 65 73 68 20 49 53 4f 20 79 6f 75 20 63 61 6e 20 63	d.yourself.a.fresh.ISO.you.can.c
c740	6f 6d 70 6c 65 74 65 6c 79 20 73 6b 69 70 20 74 68 69 73 20 63 68 61 70 74 65 72 2e 20 49 74 20	ompletely.skip.this.chapter..It.
c760	6d 61 79 20 62 65 63 6f 6d 65 20 69 6e 74 65 72 65 73 74 69 6e 67 20 6f 6e 63 65 20 79 6f 75 20	may.become.interesting.once.you.
c780	68 61 76 65 20 61 20 56 79 4f 53 20 64 65 65 70 20 64 69 76 65 2e 00 54 68 69 73 20 69 73 20 64	have.a.VyOS.deep.dive..This.is.d
c7a0	6f 6e 65 20 62 79 20 75 74 69 6c 69 7a 69 6e 67 20 74 68 65 20 60 60 73 79 73 74 65 6d 64 2d 62	one.by.utilizing.the.``systemd-b
c7c0	6f 6f 74 63 68 61 72 74 60 60 20 70 61 63 6b 61 67 65 20 77 68 69 63 68 20 69 73 20 6e 6f 77 20	ootchart``.package.which.is.now.
c7e0	69 6e 73 74 61 6c 6c 65 64 20 62 79 20 64 65 66 61 75 6c 74 20 6f 6e 20 74 68 65 20 56 79 4f 53	installed.by.default.on.the.VyOS
c800	20 31 2e 33 20 28 65 71 75 75 6c 65 75 73 29 20 62 72 61 6e 63 68 2e 20 54 68 65 20 63 6f 6e 66	.1.3.(equuleus).branch..The.conf
c820	69 67 75 72 61 74 69 6f 6e 20 69 73 20 61 6c 73 6f 20 76 65 72 73 69 6f 6e 65 64 20 73 6f 20 77	iguration.is.also.versioned.so.w
c840	65 20 67 65 74 20 63 6f 6d 70 61 72 61 62 6c 65 20 72 65 73 75 6c 74 73 2e 20 60 60 73 79 73 74	e.get.comparable.results..``syst
c860	65 6d 64 2d 62 6f 6f 74 63 68 61 72 74 60 60 20 69 73 20 63 6f 6e 66 69 67 75 72 65 64 20 75 73	emd-bootchart``.is.configured.us
c880	69 6e 67 20 74 68 69 73 20 66 69 6c 65 3a 20 62 6f 6f 74 63 68 61 72 74 2e 63 6f 6e 66 5f 00 54	ing.this.file:.bootchart.conf_.T
c8a0	68 69 73 20 69 73 20 77 68 61 74 20 77 69 6c 6c 20 68 61 70 70 65 6e 20 77 68 65 6e 20 61 20 74	his.is.what.will.happen.when.a.t
c8c0	61 73 6b 20 69 73 20 73 65 74 20 74 6f 20 22 4e 65 65 64 73 20 72 65 70 6f 72 74 65 72 20 61 63	ask.is.set.to."Needs.reporter.ac
c8e0	74 69 6f 6e 22 3a 00 54 68 69 73 20 6d 65 61 6e 73 20 74 68 65 20 66 69 6c 65 20 69 6e 20 71 75	tion":.This.means.the.file.in.qu
c900	65 73 74 69 6f 6e 20 28 60 60 2f 6f 70 74 2f 76 79 61 74 74 61 2f 73 62 69 6e 2f 76 79 61 74 74	estion.(``/opt/vyatta/sbin/vyatt
c920	61 2d 75 70 64 61 74 65 2d 77 65 62 70 72 6f 78 79 2e 70 6c 60 60 29 20 69 73 20 6c 6f 63 61 74	a-update-webproxy.pl``).is.locat
c940	65 64 20 69 6e 20 74 68 65 20 60 60 76 79 61 74 74 61 2d 77 65 62 70 72 6f 78 79 60 60 20 70 61	ed.in.the.``vyatta-webproxy``.pa
c960	63 6b 61 67 65 20 77 68 69 63 68 20 63 61 6e 20 62 65 20 66 6f 75 6e 64 20 68 65 72 65 3a 20 68	ckage.which.can.be.found.here:.h
c980	74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 76 79 6f 73 2f 76 79 61 74 74 61 2d 77 65	ttps://github.com/vyos/vyatta-we
c9a0	62 70 72 6f 78 79 00 54 68 69 73 20 70 61 63 6b 61 67 65 20 64 6f 65 73 6e 27 74 20 65 78 69 73	bproxy.This.package.doesn't.exis
c9c0	74 20 69 6e 20 44 65 62 69 61 6e 2e 20 41 20 64 65 62 69 61 6e 69 7a 65 64 20 66 6f 72 6b 20 69	t.in.Debian..A.debianized.fork.i
c9e0	73 20 6b 65 70 74 20 61 74 20 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 76 79 6f	s.kept.at.https://github.com/vyo
ca00	73 2f 6d 64 6e 73 2d 72 65 70 65 61 74 65 72 00 54 68 69 73 20 70 61 63 6b 61 67 65 20 64 6f 65	s/mdns-repeater.This.package.doe
ca20	73 6e 27 74 20 65 78 69 73 74 20 69 6e 20 44 65 62 69 61 6e 2e 20 41 20 64 65 62 69 61 6e 69 7a	sn't.exist.in.Debian..A.debianiz
ca40	65 64 20 66 6f 72 6b 20 69 73 20 6b 65 70 74 20 61 74 20 68 74 74 70 73 3a 2f 2f 67 69 74 68 75	ed.fork.is.kept.at.https://githu
ca60	62 2e 63 6f 6d 2f 76 79 6f 73 2f 75 64 70 2d 62 72 6f 61 64 63 61 73 74 2d 72 65 6c 61 79 00 54	b.com/vyos/udp-broadcast-relay.T
ca80	68 69 73 20 74 72 69 65 73 20 74 6f 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 64 65 74 65 63	his.tries.to.automatically.detec
caa0	74 20 77 68 69 63 68 20 62 6c 6f 62 73 20 61 72 65 20 6e 65 65 64 65 64 20 62 61 73 65 64 20 6f	t.which.blobs.are.needed.based.o
cac0	6e 20 77 68 69 63 68 20 64 72 69 76 65 72 73 20 77 65 72 65 20 62 75 69 6c 74 2e 20 49 66 20 69	n.which.drivers.were.built..If.i
cae0	74 20 66 61 69 6c 73 20 74 6f 20 66 69 6e 64 20 74 68 65 20 63 6f 72 72 65 63 74 20 66 69 6c 65	t.fails.to.find.the.correct.file
cb00	73 20 79 6f 75 20 63 61 6e 20 61 64 64 20 74 68 65 6d 20 6d 61 6e 75 61 6c 6c 79 20 74 6f 20 60	s.you.can.add.them.manually.to.`
cb20	60 76 79 6f 73 2d 62 75 69 6c 64 2f 70 61 63 6b 61 67 65 73 2f 6c 69 6e 75 78 2d 6b 65 72 6e 65	`vyos-build/packages/linux-kerne
cb40	6c 2f 62 75 69 6c 64 2d 6c 69 6e 75 78 2d 66 69 72 6d 77 61 72 65 2e 73 68 60 60 3a 00 54 68 69	l/build-linux-firmware.sh``:.Thi
cb60	73 20 77 69 6c 6c 20 67 75 69 64 65 20 79 6f 75 20 74 68 72 6f 75 67 68 20 74 68 65 20 70 72 6f	s.will.guide.you.through.the.pro
cb80	63 65 73 73 20 6f 66 20 62 75 69 6c 64 69 6e 67 20 61 20 56 79 4f 53 20 49 53 4f 20 75 73 69 6e	cess.of.building.a.VyOS.ISO.usin
cba0	67 20 44 6f 63 6b 65 72 2e 20 54 68 69 73 20 70 72 6f 63 65 73 73 20 68 61 73 20 62 65 65 6e 20	g.Docker..This.process.has.been.
cbc0	74 65 73 74 65 64 20 6f 6e 20 63 6c 65 61 6e 20 69 6e 73 74 61 6c 6c 73 20 6f 66 20 44 65 62 69	tested.on.clean.installs.of.Debi
cbe0	61 6e 20 42 75 6c 6c 73 65 79 65 20 28 31 31 29 20 61 6e 64 20 42 6f 6f 6b 77 6f 72 6d 20 28 31	an.Bullseye.(11).and.Bookworm.(1
cc00	32 29 2e 00 54 68 69 73 20 77 69 6c 6c 20 67 75 69 64 65 20 79 6f 75 20 74 68 72 6f 75 67 68 20	2)..This.will.guide.you.through.
cc20	74 68 65 20 70 72 6f 63 65 73 73 20 6f 66 20 62 75 69 6c 64 69 6e 67 20 61 20 56 79 4f 53 20 49	the.process.of.building.a.VyOS.I
cc40	53 4f 20 75 73 69 6e 67 20 44 6f 63 6b 65 72 5f 2e 20 54 68 69 73 20 70 72 6f 63 65 73 73 20 68	SO.using.Docker_..This.process.h
cc60	61 73 20 62 65 65 6e 20 74 65 73 74 65 64 20 6f 6e 20 63 6c 65 61 6e 20 69 6e 73 74 61 6c 6c 73	as.been.tested.on.clean.installs
cc80	20 6f 66 20 44 65 62 69 61 6e 20 4a 65 73 73 69 65 2c 20 53 74 72 65 74 63 68 2c 20 61 6e 64 20	.of.Debian.Jessie,.Stretch,.and.
cca0	42 75 73 74 65 72 2e 00 54 68 69 73 20 77 69 6c 6c 20 6c 69 6d 69 74 20 74 68 65 20 60 62 6f 6e	Buster..This.will.limit.the.`bon
ccc0	64 60 20 69 6e 74 65 72 66 61 63 65 20 74 65 73 74 20 74 6f 20 6f 6e 6c 79 20 6d 61 6b 65 20 75	d`.interface.test.to.only.make.u
cce0	73 65 20 6f 66 20 60 65 74 68 31 60 20 61 6e 64 20 60 65 74 68 32 60 20 61 73 20 6d 65 6d 62 65	se.of.`eth1`.and.`eth2`.as.membe
cd00	72 20 70 6f 72 74 73 2e 00 54 68 6f 73 65 20 63 6f 6d 6d 6f 6e 20 74 65 73 74 73 20 63 6f 6e 73	r.ports..Those.common.tests.cons
cd20	69 73 74 73 20 6f 75 74 20 6f 66 3a 00 54 69 70 73 20 61 6e 64 20 54 72 69 63 6b 73 00 54 6f 20	ists.out.of:.Tips.and.Tricks.To.
cd40	62 65 20 61 62 6c 65 20 74 6f 20 75 73 65 20 44 6f 63 6b 65 72 5f 20 77 69 74 68 6f 75 74 20 60	be.able.to.use.Docker_.without.`
cd60	60 73 75 64 6f 60 60 2c 20 74 68 65 20 63 75 72 72 65 6e 74 20 6e 6f 6e 2d 72 6f 6f 74 20 75 73	`sudo``,.the.current.non-root.us
cd80	65 72 20 6d 75 73 74 20 62 65 20 61 64 64 65 64 20 74 6f 20 74 68 65 20 60 60 64 6f 63 6b 65 72	er.must.be.added.to.the.``docker
cda0	60 60 20 67 72 6f 75 70 20 62 79 20 63 61 6c 6c 69 6e 67 3a 20 60 60 73 75 64 6f 20 75 73 65 72	``.group.by.calling:.``sudo.user
cdc0	6d 6f 64 20 2d 61 47 20 64 6f 63 6b 65 72 20 79 6f 75 72 75 73 65 72 6e 61 6d 65 60 60 2e 00 54	mod.-aG.docker.yourusername``..T
cde0	6f 20 62 75 69 6c 64 20 56 79 4f 53 20 6e 61 74 69 76 65 6c 79 20 79 6f 75 20 72 65 71 75 69 72	o.build.VyOS.natively.you.requir
ce00	65 20 61 20 70 72 6f 70 65 72 6c 79 20 63 6f 6e 66 69 67 75 72 65 64 20 62 75 69 6c 64 20 68 6f	e.a.properly.configured.build.ho
ce20	73 74 20 77 69 74 68 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 44 65 62 69 61 6e 20 76 65 72	st.with.the.following.Debian.ver
ce40	73 69 6f 6e 73 20 69 6e 73 74 61 6c 6c 65 64 3a 00 54 6f 20 62 75 69 6c 64 20 6f 75 72 20 6d 6f	sions.installed:.To.build.our.mo
ce60	64 75 6c 65 73 20 77 65 20 75 74 69 6c 69 7a 65 20 61 20 43 49 2f 43 44 20 50 69 70 65 6c 69 6e	dules.we.utilize.a.CI/CD.Pipelin
ce80	65 20 73 63 72 69 70 74 2e 20 45 61 63 68 20 61 6e 64 20 65 76 65 72 79 20 56 79 4f 53 20 63 6f	e.script..Each.and.every.VyOS.co
cea0	6d 70 6f 6e 65 6e 74 20 63 6f 6d 65 73 20 77 69 74 68 20 69 74 27 73 20 6f 77 6e 20 60 60 4a 65	mponent.comes.with.it's.own.``Je
cec0	6e 6b 69 6e 73 66 69 6c 65 60 60 20 77 68 69 63 68 20 69 73 20 28 6d 6f 72 65 20 6f 72 20 6c 65	nkinsfile``.which.is.(more.or.le
cee0	73 73 29 20 61 20 63 6f 70 79 2e 20 54 68 65 20 50 69 70 65 6c 69 6e 65 20 75 74 69 6c 69 7a 65	ss).a.copy..The.Pipeline.utilize
cf00	73 20 74 68 65 20 44 6f 63 6b 65 72 20 63 6f 6e 74 61 69 6e 65 72 20 66 72 6f 6d 20 74 68 65 20	s.the.Docker.container.from.the.
cf20	3a 72 65 66 3a 60 62 75 69 6c 64 5f 69 73 6f 60 20 73 65 63 74 69 6f 6e 20 2d 20 62 75 74 20 69	:ref:`build_iso`.section.-.but.i
cf40	6e 73 74 65 61 64 20 6f 66 20 62 75 69 6c 64 69 6e 67 20 69 74 20 66 72 6f 6d 20 73 6f 75 72 63	nstead.of.building.it.from.sourc
cf60	65 20 6f 6e 20 65 76 65 72 79 20 72 75 6e 2c 20 77 65 20 72 61 74 68 65 72 20 61 6c 77 61 79 73	e.on.every.run,.we.rather.always
cf80	20 66 65 74 63 68 20 61 20 66 72 65 73 68 20 63 6f 70 79 20 28 69 66 20 6e 65 65 64 65 64 29 20	.fetch.a.fresh.copy.(if.needed).
cfa0	66 72 6f 6d 20 44 6f 63 6b 65 72 68 75 62 5f 2e 00 54 6f 20 64 65 62 75 67 20 69 73 73 75 65 73	from.Dockerhub_..To.debug.issues
cfc0	20 69 6e 20 70 72 69 6f 72 69 74 69 65 73 20 6f 72 20 74 6f 20 73 65 65 20 77 68 61 74 27 73 20	.in.priorities.or.to.see.what's.
cfe0	67 6f 69 6e 67 20 6f 6e 20 69 6e 20 74 68 65 20 62 61 63 6b 67 72 6f 75 6e 64 20 79 6f 75 20 63	going.on.in.the.background.you.c
d000	61 6e 20 75 73 65 20 74 68 65 20 60 60 2f 6f 70 74 2f 76 79 61 74 74 61 2f 73 62 69 6e 2f 70 72	an.use.the.``/opt/vyatta/sbin/pr
d020	69 6f 72 69 74 79 2e 70 6c 60 60 20 73 63 72 69 70 74 20 77 68 69 63 68 20 6c 69 73 74 73 20 74	iority.pl``.script.which.lists.t
d040	6f 20 79 6f 75 20 74 68 65 20 65 78 65 63 75 74 69 6f 6e 20 6f 72 64 65 72 20 6f 66 20 74 68 65	o.you.the.execution.order.of.the
d060	20 73 63 72 69 70 74 73 2e 00 54 6f 20 64 65 62 75 67 20 74 68 65 20 62 75 69 6c 64 20 70 72 6f	.scripts..To.debug.the.build.pro
d080	63 65 73 73 20 61 6e 64 20 67 61 69 6e 20 61 64 64 69 74 69 6f 6e 61 6c 20 69 6e 66 6f 72 6d 61	cess.and.gain.additional.informa
d0a0	74 69 6f 6e 20 6f 66 20 77 68 61 74 20 63 6f 75 6c 64 20 62 65 20 74 68 65 20 72 6f 6f 74 20 63	tion.of.what.could.be.the.root.c
d0c0	61 75 73 65 2c 20 79 6f 75 20 6e 65 65 64 20 74 6f 20 75 73 65 20 60 63 68 72 6f 6f 74 60 20 74	ause,.you.need.to.use.`chroot`.t
d0e0	6f 20 63 68 61 6e 67 65 20 69 6e 74 6f 20 74 68 65 20 62 75 69 6c 64 20 64 69 72 65 63 74 6f 72	o.change.into.the.build.director
d100	79 2e 20 54 68 69 73 20 69 73 20 65 78 70 6c 61 69 6e 65 64 20 69 6e 20 74 68 65 20 66 6f 6c 6c	y..This.is.explained.in.the.foll
d120	6f 77 69 6e 67 20 73 74 65 70 20 62 79 20 73 74 65 70 20 70 72 6f 63 65 64 75 72 65 3a 00 54 6f	owing.step.by.step.procedure:.To
d140	20 64 65 62 75 67 20 74 68 65 20 62 75 69 6c 64 20 70 72 6f 63 65 73 73 20 61 6e 64 20 67 61 69	.debug.the.build.process.and.gai
d160	6e 20 61 64 64 69 74 69 6f 6e 61 6c 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 6f 66 20 77 68 61 74	n.additional.information.of.what
d180	20 63 6f 75 6c 64 20 62 65 20 74 68 65 20 72 6f 6f 74 20 63 61 75 73 65 2c 20 79 6f 75 20 6e 65	.could.be.the.root.cause,.you.ne
d1a0	65 64 20 74 6f 20 75 73 65 20 60 63 68 72 6f 6f 74 60 20 74 6f 20 63 68 61 6e 67 65 20 69 6e 74	ed.to.use.`chroot`.to.change.int
d1c0	6f 20 74 68 65 20 62 75 69 6c 64 20 64 69 72 65 63 74 72 79 2e 20 54 68 69 73 20 69 73 20 65 78	o.the.build.directry..This.is.ex
d1e0	70 6c 61 69 6e 65 64 20 69 6e 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 65 70 20 62 79	plained.in.the.following.step.by
d200	20 73 74 65 70 20 70 72 6f 63 65 64 75 72 65 3a 00 54 6f 20 65 6e 61 62 6c 65 20 62 6f 6f 74 20	.step.procedure:.To.enable.boot.
d220	74 69 6d 65 20 67 72 61 70 68 69 6e 67 20 63 68 61 6e 67 65 20 74 68 65 20 4b 65 72 6e 65 6c 20	time.graphing.change.the.Kernel.
d240	63 6f 6d 6d 61 6e 64 6c 69 6e 65 20 61 6e 64 20 61 64 64 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e	commandline.and.add.the.followin
d260	67 20 73 74 72 69 6e 67 3a 20 60 60 69 6e 69 74 3d 2f 75 73 72 2f 6c 69 62 2f 73 79 73 74 65 6d	g.string:.``init=/usr/lib/system
d280	64 2f 73 79 73 74 65 6d 64 2d 62 6f 6f 74 63 68 61 72 74 60 60 00 54 6f 20 65 6e 61 62 6c 65 20	d/systemd-bootchart``.To.enable.
d2a0	62 6f 6f 74 20 74 69 6d 65 20 67 72 61 70 68 69 6e 67 20 63 68 61 6e 67 65 20 74 68 65 20 4b 65	boot.time.graphing.change.the.Ke
d2c0	72 6e 65 6c 20 63 6f 6d 6d 61 6e 64 6c 69 6e 65 20 61 6e 64 20 61 64 64 20 74 68 65 20 66 6f 6c	rnel.commandline.and.add.the.fol
d2e0	6f 77 69 6e 67 20 73 74 72 69 6e 67 3a 20 60 60 69 6e 69 74 3d 2f 75 73 72 2f 6c 69 62 2f 73 79	owing.string:.``init=/usr/lib/sy
d300	73 74 65 6d 64 2f 73 79 73 74 65 6d 64 2d 62 6f 6f 74 63 68 61 72 74 60 60 00 54 6f 20 65 6e 61	stemd/systemd-bootchart``.To.ena
d320	62 6c 65 20 64 65 62 75 67 67 69 6e 67 20 6a 75 73 74 20 72 75 6e 3a 20 60 60 24 20 74 6f 75 63	ble.debugging.just.run:.``$.touc
d340	68 20 2f 74 6d 70 2f 76 79 6f 73 2e 66 72 72 2e 64 65 62 75 67 60 60 00 54 6f 20 65 6e 61 62 6c	h./tmp/vyos.frr.debug``.To.enabl
d360	65 20 73 6d 6f 6b 65 74 65 73 74 20 64 65 62 75 67 67 69 6e 67 20 28 70 72 69 6e 74 20 6f 66 20	e.smoketest.debugging.(print.of.
d380	74 68 65 20 43 4c 49 20 73 65 74 20 63 6f 6d 6d 61 6e 64 73 20 75 73 65 64 29 20 79 6f 75 20 63	the.CLI.set.commands.used).you.c
d3a0	61 6e 20 72 75 6e 3a 20 60 60 74 6f 75 63 68 20 2f 74 6d 70 2f 76 79 6f 73 2e 73 6d 6f 6b 65 74	an.run:.``touch./tmp/vyos.smoket
d3c0	65 73 74 2e 64 65 62 75 67 60 60 2e 00 54 6f 20 65 6e 73 75 72 65 20 75 6e 69 66 6f 72 6d 20 6c	est.debug``..To.ensure.uniform.l
d3e0	6f 6f 6b 20 61 6e 64 20 66 65 65 6c 2c 20 61 6e 64 20 69 6d 70 72 6f 76 65 20 72 65 61 64 61 62	ook.and.feel,.and.improve.readab
d400	69 6c 69 74 79 2c 20 77 65 20 73 68 6f 75 6c 64 20 66 6f 6c 6c 6f 77 20 61 20 73 65 74 20 6f 66	ility,.we.should.follow.a.set.of
d420	20 67 75 69 64 65 6c 69 6e 65 73 20 63 6f 6e 73 69 73 74 65 6e 74 6c 79 2e 00 54 6f 20 6d 61 6b	.guidelines.consistently..To.mak
d440	65 20 74 68 69 73 20 61 70 70 72 6f 61 63 68 20 77 6f 72 6b 2c 20 65 76 65 72 79 20 63 68 61 6e	e.this.approach.work,.every.chan
d460	67 65 20 6d 75 73 74 20 62 65 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 61 20 74 61 73	ge.must.be.associated.with.a.tas
d480	6b 20 6e 75 6d 62 65 72 20 28 70 72 65 66 69 78 65 64 20 77 69 74 68 20 2a 2a 54 2a 2a 29 20 61	k.number.(prefixed.with.**T**).a
d4a0	6e 64 20 61 20 63 6f 6d 70 6f 6e 65 6e 74 2e 20 49 66 20 74 68 65 72 65 20 69 73 20 6e 6f 20 62	nd.a.component..If.there.is.no.b
d4c0	75 67 20 72 65 70 6f 72 74 2f 66 65 61 74 75 72 65 20 72 65 71 75 65 73 74 20 66 6f 72 20 74 68	ug.report/feature.request.for.th
d4e0	65 20 63 68 61 6e 67 65 73 20 79 6f 75 20 61 72 65 20 67 6f 69 6e 67 20 74 6f 20 6d 61 6b 65 2c	e.changes.you.are.going.to.make,
d500	20 79 6f 75 20 68 61 76 65 20 74 6f 20 63 72 65 61 74 65 20 61 20 50 68 61 62 72 69 63 61 74 6f	.you.have.to.create.a.Phabricato
d520	72 5f 20 74 61 73 6b 20 66 69 72 73 74 2e 20 4f 6e 63 65 20 74 68 65 72 65 20 69 73 20 61 6e 20	r_.task.first..Once.there.is.an.
d540	65 6e 74 72 79 20 69 6e 20 50 68 61 62 72 69 63 61 74 6f 72 5f 2c 20 79 6f 75 20 73 68 6f 75 6c	entry.in.Phabricator_,.you.shoul
d560	64 20 72 65 66 65 72 65 6e 63 65 20 69 74 73 20 69 64 20 69 6e 20 79 6f 75 72 20 63 6f 6d 6d 69	d.reference.its.id.in.your.commi
d580	74 20 6d 65 73 73 61 67 65 2c 20 61 73 20 73 68 6f 77 6e 20 62 65 6c 6f 77 3a 00 54 6f 20 6d 61	t.message,.as.shown.below:.To.ma
d5a0	6e 75 61 6c 6c 79 20 64 6f 77 6e 6c 6f 61 64 20 74 68 65 20 63 6f 6e 74 61 69 6e 65 72 20 66 72	nually.download.the.container.fr
d5c0	6f 6d 20 44 6f 63 6b 65 72 48 75 62 2c 20 72 75 6e 3a 00 54 6f 20 73 74 61 72 74 2c 20 63 6c 6f	om.DockerHub,.run:.To.start,.clo
d5e0	6e 65 20 74 68 65 20 72 65 70 6f 73 69 74 6f 72 79 20 74 6f 20 79 6f 75 72 20 6c 6f 63 61 6c 20	ne.the.repository.to.your.local.
d600	6d 61 63 68 69 6e 65 3a 00 54 6f 20 74 61 6b 65 20 79 6f 75 72 20 6e 65 77 6c 79 20 63 72 65 61	machine:.To.take.your.newly.crea
d620	74 65 64 20 70 61 63 6b 61 67 65 20 6f 6e 20 61 20 74 65 73 74 20 64 72 69 76 65 20 79 6f 75 20	ted.package.on.a.test.drive.you.
d640	63 61 6e 20 73 69 6d 70 6c 79 20 53 43 50 20 69 74 20 74 6f 20 61 20 72 75 6e 6e 69 6e 67 20 56	can.simply.SCP.it.to.a.running.V
d660	79 4f 53 20 69 6e 73 74 61 6e 63 65 20 61 6e 64 20 69 6e 73 74 61 6c 6c 20 74 68 65 20 6e 65 77	yOS.instance.and.install.the.new
d680	20 60 2a 2e 64 65 62 60 20 70 61 63 6b 61 67 65 20 6f 76 65 72 20 74 68 65 20 63 75 72 72 65 6e	.`*.deb`.package.over.the.curren
d6a0	74 20 72 75 6e 6e 69 6e 67 20 6f 6e 65 2e 00 54 72 6f 75 62 6c 65 73 68 6f 6f 74 69 6e 67 00 55	t.running.one..Troubleshooting.U
d6c0	6e 6c 65 73 73 20 61 62 73 6f 6c 75 74 65 6c 79 20 6e 65 63 65 73 73 61 72 79 2c 20 63 6f 6e 66	nless.absolutely.necessary,.conf
d6e0	69 67 75 72 61 74 69 6f 6e 20 73 63 72 69 70 74 73 20 73 68 6f 75 6c 64 20 6e 6f 74 20 6d 6f 64	iguration.scripts.should.not.mod
d700	69 66 79 20 74 68 65 20 61 63 74 69 76 65 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 6f 66 20	ify.the.active.configuration.of.
d720	73 79 73 74 65 6d 20 63 6f 6d 70 6f 6e 65 6e 74 73 20 64 69 72 65 63 74 6c 79 2e 20 57 68 65 6e	system.components.directly..When
d740	65 76 65 72 20 61 74 20 61 6c 6c 20 70 6f 73 73 69 62 6c 65 2c 20 73 63 72 69 70 74 73 20 73 68	ever.at.all.possible,.scripts.sh
d760	6f 75 6c 64 20 67 65 6e 65 72 61 74 65 20 61 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 66 69	ould.generate.a.configuration.fi
d780	6c 65 20 6f 72 20 66 69 6c 65 73 20 74 68 61 74 20 63 61 6e 20 62 65 20 61 70 70 6c 69 65 64 20	le.or.files.that.can.be.applied.
d7a0	77 69 74 68 20 61 20 73 69 6e 67 6c 65 20 63 6f 6d 6d 61 6e 64 20 73 75 63 68 20 61 73 20 72 65	with.a.single.command.such.as.re
d7c0	6c 6f 61 64 69 6e 67 20 61 20 73 65 72 76 69 63 65 20 74 68 72 6f 75 67 68 20 73 79 73 74 65 6d	loading.a.service.through.system
d7e0	64 20 69 6e 69 74 2e 20 49 6e 73 65 72 74 69 6e 67 20 73 74 61 74 65 6d 65 6e 74 73 20 6f 6e 65	d.init..Inserting.statements.one
d800	20 62 79 20 6f 6e 65 20 69 73 20 70 61 72 74 69 63 75 6c 61 72 6c 79 20 64 69 73 63 6f 75 72 61	.by.one.is.particularly.discoura
d820	67 65 64 2c 20 66 6f 72 20 65 78 61 6d 70 6c 65 2c 20 77 68 65 6e 20 63 6f 6e 66 69 67 75 72 69	ged,.for.example,.when.configuri
d840	6e 67 20 6e 65 74 66 69 6c 74 65 72 20 72 75 6c 65 73 2c 20 73 61 76 69 6e 67 20 74 68 65 6d 20	ng.netfilter.rules,.saving.them.
d860	74 6f 20 61 20 66 69 6c 65 20 61 6e 64 20 6c 6f 61 64 69 6e 67 20 69 74 20 77 69 74 68 20 69 70	to.a.file.and.loading.it.with.ip
d880	74 61 62 6c 65 73 2d 72 65 73 74 6f 72 65 20 73 68 6f 75 6c 64 20 61 6c 77 61 79 73 20 62 65 20	tables-restore.should.always.be.
d8a0	70 72 65 66 65 72 72 65 64 20 74 6f 20 65 78 65 63 75 74 69 6e 67 20 69 70 74 61 62 6c 65 73 20	preferred.to.executing.iptables.
d8c0	64 69 72 65 63 74 6c 79 2e 00 55 70 73 74 72 65 61 6d 20 70 61 63 6b 61 67 65 73 00 55 73 65 20	directly..Upstream.packages.Use.
d8e0	6f 66 20 61 62 62 72 65 76 69 61 74 69 6f 6e 73 20 61 6e 64 20 61 63 72 6f 6e 79 6d 73 00 55 73	of.abbreviations.and.acronyms.Us
d900	65 20 6f 66 20 6e 75 6d 62 65 72 73 00 55 73 65 20 6f 66 20 6e 75 6d 62 65 72 73 20 69 6e 20 63	e.of.numbers.Use.of.numbers.in.c
d920	6f 6d 6d 61 6e 64 20 6e 61 6d 65 73 20 2a 2a 73 68 6f 75 6c 64 2a 2a 20 62 65 20 61 76 6f 69 64	ommand.names.**should**.be.avoid
d940	65 64 20 75 6e 6c 65 73 73 20 61 20 6e 75 6d 62 65 72 20 69 73 20 61 20 70 61 72 74 20 6f 66 20	ed.unless.a.number.is.a.part.of.
d960	61 20 70 72 6f 74 6f 63 6f 6c 20 6e 61 6d 65 20 6f 72 20 73 69 6d 69 6c 61 72 2e 20 54 68 75 73	a.protocol.name.or.similar..Thus
d980	2c 20 60 60 70 72 6f 74 6f 63 6f 6c 73 20 6f 73 70 66 76 33 60 60 20 69 73 20 70 65 72 66 65 63	,.``protocols.ospfv3``.is.perfec
d9a0	74 6c 79 20 66 69 6e 65 2c 20 62 75 74 20 73 6f 6d 65 74 68 69 6e 67 20 6c 69 6b 65 20 60 60 73	tly.fine,.but.something.like.``s
d9c0	65 72 76 65 72 2d 31 60 60 20 69 73 20 71 75 65 73 74 69 6f 6e 61 62 6c 65 20 61 74 20 62 65 73	erver-1``.is.questionable.at.bes
d9e0	74 2e 00 55 73 65 20 6f 66 20 76 65 72 62 73 00 55 73 65 20 72 65 67 65 78 00 55 73 65 66 75 6c	t..Use.of.verbs.Use.regex.Useful
da00	20 63 6f 6d 6d 61 6e 64 73 20 61 72 65 3a 00 56 49 46 20 28 69 6e 63 6c 2e 20 56 49 46 2d 53 2f	.commands.are:.VIF.(incl..VIF-S/
da20	56 49 46 2d 43 29 00 56 4c 41 4e 73 20 28 51 69 6e 51 20 61 6e 64 20 72 65 67 75 6c 61 72 20 38	VIF-C).VLANs.(QinQ.and.regular.8
da40	30 32 2e 31 71 29 00 56 4d 77 61 72 65 00 56 65 72 62 73 20 2a 2a 73 68 6f 75 6c 64 2a 2a 20 62	02.1q).VMware.Verbs.**should**.b
da60	65 20 61 76 6f 69 64 65 64 2e 20 49 66 20 61 20 76 65 72 62 20 63 61 6e 20 62 65 20 6f 6d 69 74	e.avoided..If.a.verb.can.be.omit
da80	74 65 64 2c 20 6f 6d 69 74 20 69 74 2e 00 56 65 72 62 73 2c 20 77 68 65 6e 20 74 68 65 79 20 61	ted,.omit.it..Verbs,.when.they.a
daa0	72 65 20 6e 65 63 65 73 73 61 72 79 2c 20 2a 2a 73 68 6f 75 6c 64 2a 2a 20 62 65 20 69 6e 20 74	re.necessary,.**should**.be.in.t
dac0	68 65 69 72 20 69 6e 66 69 6e 69 74 69 76 65 20 66 6f 72 6d 2e 00 56 69 72 74 75 61 6c 69 7a 61	heir.infinitive.form..Virtualiza
dae0	74 69 6f 6e 20 50 6c 61 74 66 6f 72 6d 73 00 56 79 4f 53 20 43 4c 49 20 69 73 20 61 6c 6c 20 61	tion.Platforms.VyOS.CLI.is.all.a
db00	62 6f 75 74 20 70 72 69 6f 72 69 74 69 65 73 2e 20 45 76 65 72 79 20 43 4c 49 20 6e 6f 64 65 20	bout.priorities..Every.CLI.node.
db20	68 61 73 20 61 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 60 60 6e 6f 64 65 2e 64 65 66 60 60	has.a.corresponding.``node.def``
db40	20 66 69 6c 65 20 61 6e 64 20 70 6f 73 73 69 62 6c 79 20 61 6e 20 61 74 74 61 63 68 65 64 20 73	.file.and.possibly.an.attached.s
db60	63 72 69 70 74 20 74 68 61 74 20 69 73 20 65 78 65 63 75 74 65 64 20 77 68 65 6e 20 74 68 65 20	cript.that.is.executed.when.the.
db80	6e 6f 64 65 20 69 73 20 70 72 65 73 65 6e 74 2e 20 4e 6f 64 65 73 20 63 61 6e 20 68 61 76 65 20	node.is.present..Nodes.can.have.
dba0	61 20 70 72 69 6f 72 69 74 79 2c 20 61 6e 64 20 6f 6e 20 73 79 73 74 65 6d 20 62 6f 6f 74 75 70	a.priority,.and.on.system.bootup
dbc0	20 2d 20 6f 72 20 61 6e 79 20 6f 74 68 65 72 20 60 60 63 6f 6d 6d 69 74 60 60 20 74 6f 20 74 68	.-.or.any.other.``commit``.to.th
dbe0	65 20 63 6f 6e 66 69 67 20 61 6c 6c 20 73 63 72 69 70 74 73 20 61 72 65 20 65 78 65 63 75 74 65	e.config.all.scripts.are.execute
dc00	64 20 66 72 6f 6d 20 6c 6f 77 65 73 74 20 74 6f 20 68 69 67 65 73 74 20 70 72 69 6f 72 69 74 79	d.from.lowest.to.higest.priority
dc20	2e 20 54 68 69 73 20 69 73 20 67 6f 6f 64 20 61 73 20 74 68 69 73 20 67 69 76 65 73 20 61 20 64	..This.is.good.as.this.gives.a.d
dc40	65 74 65 72 6d 69 6e 69 73 74 69 63 20 62 65 68 61 76 69 6f 72 2e 00 56 79 4f 53 20 43 4c 49 20	eterministic.behavior..VyOS.CLI.
dc60	69 73 20 61 6c 6c 20 61 62 6f 75 74 20 70 72 69 6f 72 69 74 69 65 73 2e 20 45 76 65 72 79 20 43	is.all.about.priorities..Every.C
dc80	4c 49 20 6e 6f 64 65 20 68 61 73 20 61 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 60 60 6e 6f	LI.node.has.a.corresponding.``no
dca0	64 65 2e 64 65 66 60 60 20 66 69 6c 65 20 61 6e 64 20 70 6f 73 73 69 62 6c 79 20 61 6e 20 61 74	de.def``.file.and.possibly.an.at
dcc0	74 61 63 68 65 64 20 73 63 72 69 70 74 20 74 68 61 74 20 69 73 20 65 78 65 63 75 74 65 64 20 77	tached.script.that.is.executed.w
dce0	68 65 6e 20 74 68 65 20 6e 6f 64 65 20 69 73 20 70 72 65 73 65 6e 74 2e 20 4e 6f 64 65 73 20 63	hen.the.node.is.present..Nodes.c
dd00	61 6e 20 68 61 76 65 20 61 20 70 72 69 6f 72 69 74 79 2c 20 61 6e 64 20 6f 6e 20 73 79 73 74 65	an.have.a.priority,.and.on.syste
dd20	6d 20 62 6f 6f 74 75 70 20 2d 20 6f 72 20 61 6e 79 20 6f 74 68 65 72 20 60 60 63 6f 6d 6d 69 74	m.bootup.-.or.any.other.``commit
dd40	60 60 20 74 6f 20 74 68 65 20 63 6f 6e 66 69 67 20 61 6c 6c 20 73 63 72 69 70 74 73 20 61 72 65	``.to.the.config.all.scripts.are
dd60	20 65 78 65 63 75 74 65 64 20 66 72 6f 6d 20 6c 6f 77 65 73 74 20 74 6f 20 68 69 67 68 65 73 74	.executed.from.lowest.to.highest
dd80	20 70 72 69 6f 72 69 74 79 2e 20 54 68 69 73 20 69 73 20 67 6f 6f 64 20 61 73 20 74 68 69 73 20	.priority..This.is.good.as.this.
dda0	67 69 76 65 73 20 61 20 64 65 74 65 72 6d 69 6e 69 73 74 69 63 20 62 65 68 61 76 69 6f 72 2e 00	gives.a.deterministic.behavior..
ddc0	56 79 4f 53 20 68 61 73 20 73 77 69 74 63 68 65 64 20 74 6f 20 44 65 62 69 61 6e 20 28 31 32 29	VyOS.has.switched.to.Debian.(12)
dde0	20 42 6f 6f 6b 77 6f 72 6d 20 69 6e 20 69 74 73 20 60 60 63 75 72 72 65 6e 74 60 60 20 62 72 61	.Bookworm.in.its.``current``.bra
de00	6e 63 68 2c 20 44 75 65 20 74 6f 20 73 6f 66 74 77 61 72 65 20 76 65 72 73 69 6f 6e 20 75 70 64	nch,.Due.to.software.version.upd
de20	61 74 65 73 2c 20 69 74 20 69 73 20 72 65 63 6f 6d 6d 65 6e 64 65 64 20 74 6f 20 75 73 65 20 74	ates,.it.is.recommended.to.use.t
de40	68 65 20 6f 66 66 69 63 69 61 6c 20 44 6f 63 6b 65 72 20 48 75 62 20 69 6d 61 67 65 20 74 6f 20	he.official.Docker.Hub.image.to.
de60	62 75 69 6c 64 20 56 79 4f 53 20 49 53 4f 2e 00 56 79 4f 53 20 69 74 73 65 6c 66 20 63 6f 6d 65	build.VyOS.ISO..VyOS.itself.come
de80	73 20 77 69 74 68 20 61 20 62 75 6e 63 68 20 6f 66 20 70 61 63 6b 61 67 65 73 20 74 68 61 74 20	s.with.a.bunch.of.packages.that.
dea0	61 72 65 20 73 70 65 63 69 66 69 63 20 74 6f 20 6f 75 72 20 73 79 73 74 65 6d 20 61 6e 64 20 74	are.specific.to.our.system.and.t
dec0	68 75 73 20 63 61 6e 6e 6f 74 20 62 65 20 66 6f 75 6e 64 20 69 6e 20 61 6e 79 20 44 65 62 69 61	hus.cannot.be.found.in.any.Debia
dee0	6e 20 6d 69 72 72 6f 72 2e 20 54 68 6f 73 65 20 70 61 63 6b 61 67 65 73 20 63 61 6e 20 62 65 20	n.mirror..Those.packages.can.be.
df00	66 6f 75 6e 64 20 61 74 20 74 68 65 20 60 56 79 4f 53 20 47 69 74 48 75 62 20 70 72 6f 6a 65 63	found.at.the.`VyOS.GitHub.projec
df20	74 60 5f 20 69 6e 20 74 68 65 69 72 20 73 6f 75 72 63 65 20 66 6f 72 6d 61 74 20 63 61 6e 20 65	t`_.in.their.source.format.can.e
df40	61 73 69 6c 79 20 62 65 20 63 6f 6d 70 69 6c 65 64 20 69 6e 74 6f 20 61 20 63 75 73 74 6f 6d 20	asily.be.compiled.into.a.custom.
df60	44 65 62 69 61 6e 20 28 60 2a 2e 64 65 62 60 29 20 70 61 63 6b 61 67 65 2e 00 56 79 4f 53 20 6d	Debian.(`*.deb`).package..VyOS.m
df80	61 6b 65 73 20 75 73 65 20 6f 66 20 4a 65 6e 6b 69 6e 73 5f 20 61 73 20 6f 75 72 20 43 6f 6e 74	akes.use.of.Jenkins_.as.our.Cont
dfa0	69 6e 75 6f 75 73 20 49 6e 74 65 67 72 61 74 69 6f 6e 20 28 43 49 29 20 73 65 72 76 69 63 65 2e	inuous.Integration.(CI).service.
dfc0	20 4f 75 72 20 60 56 79 4f 53 20 43 49 60 5f 20 73 65 72 76 65 72 20 69 73 20 70 75 62 6c 69 63	.Our.`VyOS.CI`_.server.is.public
dfe0	6c 79 20 61 63 63 65 73 73 69 62 6c 65 20 68 65 72 65 3a 20 68 74 74 70 73 3a 2f 2f 63 69 2e 76	ly.accessible.here:.https://ci.v
e000	79 6f 73 2e 6e 65 74 2e 20 59 6f 75 20 63 61 6e 20 67 65 74 20 61 20 62 72 69 65 66 20 6f 76 65	yos.net..You.can.get.a.brief.ove
e020	72 76 69 65 77 20 6f 66 20 61 6c 6c 20 72 65 71 75 69 72 65 64 20 63 6f 6d 70 6f 6e 65 6e 74 73	rview.of.all.required.components
e040	20 73 68 69 70 70 65 64 20 69 6e 20 61 20 56 79 4f 53 20 49 53 4f 2e 00 57 65 20 61 67 61 69 6e	.shipped.in.a.VyOS.ISO..We.again
e060	20 6d 61 6b 65 20 75 73 65 20 6f 66 20 61 20 68 65 6c 70 65 72 20 73 63 72 69 70 74 20 61 6e 64	.make.use.of.a.helper.script.and
e080	20 73 6f 6d 65 20 70 61 74 63 68 65 73 20 74 6f 20 6d 61 6b 65 20 74 68 65 20 62 75 69 6c 64 20	.some.patches.to.make.the.build.
e0a0	77 6f 72 6b 2e 20 4a 75 73 74 20 72 75 6e 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 63 6f 6d	work..Just.run.the.following.com
e0c0	6d 61 6e 64 3a 00 57 65 20 61 73 73 69 67 6e 20 74 68 61 74 20 73 74 61 74 75 73 20 74 6f 3a 00	mand:.We.assign.that.status.to:.
e0e0	57 65 20 64 69 66 66 65 72 65 6e 74 69 61 74 65 20 69 6e 20 74 77 6f 20 69 6e 64 65 70 65 6e 64	We.differentiate.in.two.independ
e100	65 6e 74 20 74 65 73 74 73 2c 20 77 68 69 63 68 20 61 72 65 20 62 6f 74 68 20 72 75 6e 20 69 6e	ent.tests,.which.are.both.run.in
e120	20 70 61 72 61 6c 6c 65 6c 20 62 79 20 74 77 6f 20 73 65 70 61 72 61 74 65 20 51 45 6d 75 20 69	.parallel.by.two.separate.QEmu.i
e140	6e 73 74 61 6e 63 65 73 20 77 68 69 63 68 20 61 72 65 20 6c 61 75 6e 63 68 65 64 20 76 69 61 20	nstances.which.are.launched.via.
e160	60 60 6d 61 6b 65 20 74 65 73 74 60 60 20 61 6e 64 20 60 60 6d 61 6b 65 20 74 65 73 74 63 60 60	``make.test``.and.``make.testc``
e180	20 66 72 6f 6d 20 77 69 74 68 69 6e 20 74 68 65 20 76 79 6f 73 2d 62 75 69 6c 64 5f 20 72 65 70	.from.within.the.vyos-build_.rep
e1a0	6f 73 69 74 6f 72 79 2e 00 57 65 20 6e 6f 77 20 61 72 65 20 66 72 65 65 20 74 6f 20 72 75 6e 20	ository..We.now.are.free.to.run.
e1c0	61 6e 79 20 63 6f 6d 6d 61 6e 64 20 77 65 20 77 6f 75 6c 64 20 6c 69 6b 65 20 74 6f 20 75 73 65	any.command.we.would.like.to.use
e1e0	20 66 6f 72 20 64 65 62 75 67 67 69 6e 67 2c 20 65 2e 67 2e 20 72 65 2d 69 6e 73 74 61 6c 6c 69	.for.debugging,.e.g..re-installi
e200	6e 67 20 74 68 65 20 66 61 69 6c 65 64 20 70 61 63 6b 61 67 65 20 61 66 74 65 72 20 75 70 64 61	ng.the.failed.package.after.upda
e220	74 69 6e 67 20 74 68 65 20 72 65 70 6f 73 69 74 6f 72 79 2e 00 57 65 20 6e 6f 77 20 6e 65 65 64	ting.the.repository..We.now.need
e240	20 74 6f 20 6d 6f 75 6e 74 20 73 6f 6d 65 20 72 65 71 75 69 72 65 64 2c 20 76 6f 6c 61 74 69 6c	.to.mount.some.required,.volatil
e260	65 20 66 69 6c 65 73 79 73 74 65 6d 73 00 57 65 20 6f 6e 6c 79 20 61 63 63 65 70 74 20 62 75 67	e.filesystems.We.only.accept.bug
e280	66 69 78 65 73 20 69 6e 20 70 61 63 6b 61 67 65 73 20 6f 74 68 65 72 20 74 68 61 6e 20 68 74 74	fixes.in.packages.other.than.htt
e2a0	70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 76 79 6f 73 2f 76 79 6f 73 2d 31 78 20 61 73 20	ps://github.com/vyos/vyos-1x.as.
e2c0	6e 6f 20 6e 65 77 20 66 75 6e 63 74 69 6f 6e 61 6c 69 74 79 20 73 68 6f 75 6c 64 20 75 73 65 20	no.new.functionality.should.use.
e2e0	74 68 65 20 6f 6c 64 20 73 74 79 6c 65 20 74 65 6d 70 6c 61 74 65 73 20 28 60 60 6e 6f 64 65 2e	the.old.style.templates.(``node.
e300	64 65 66 60 60 20 61 6e 64 20 50 65 72 6c 2f 42 41 53 48 20 63 6f 64 65 2e 20 55 73 65 20 74 68	def``.and.Perl/BASH.code..Use.th
e320	65 20 6e 65 77 20 73 74 79 6c 65 20 58 4d 4c 2f 50 79 74 68 6f 6e 20 69 6e 74 65 72 66 61 63 65	e.new.style.XML/Python.interface
e340	20 69 6e 73 74 65 61 64 2e 00 57 65 20 77 69 6c 6c 20 6e 6f 74 20 61 75 74 6f 2d 63 6c 6f 73 65	.instead..We.will.not.auto-close
e360	20 74 61 73 6b 73 20 77 69 74 68 20 61 6e 79 20 6f 74 68 65 72 20 73 74 61 74 75 73 20 61 6e 64	.tasks.with.any.other.status.and
e380	20 77 69 6c 6c 20 6e 6f 74 20 63 6c 6f 73 65 20 74 61 73 6b 73 20 66 6f 72 20 74 68 65 20 6c 61	.will.not.close.tasks.for.the.la
e3a0	63 6b 20 6f 66 20 6d 61 69 6e 74 61 69 6e 65 72 20 61 63 74 69 76 69 74 79 21 00 57 68 61 74 20	ck.of.maintainer.activity!.What.
e3c0	63 6f 6d 6d 61 6e 64 73 20 64 69 64 20 79 6f 75 20 75 73 65 3f 20 55 73 65 20 65 2e 67 2e 20 60	commands.did.you.use?.Use.e.g..`
e3e0	60 72 75 6e 20 73 68 6f 77 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 63 6f 6d 6d 61 6e 64 73	`run.show.configuration.commands
e400	60 60 00 57 68 61 74 20 77 61 73 20 74 68 65 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 70 72	``.What.was.the.configuration.pr
e420	69 6f 72 20 74 6f 20 74 68 65 20 63 68 61 6e 67 65 3f 00 57 68 61 74 20 77 65 72 65 20 79 6f 75	ior.to.the.change?.What.were.you
e440	20 61 74 74 65 6d 70 74 69 6e 67 20 74 6f 20 61 63 68 69 65 76 65 3f 00 57 68 61 74 2f 77 68 79	.attempting.to.achieve?.What/why
e460	2f 68 6f 77 20 73 6f 6d 65 74 68 69 6e 67 20 68 61 73 20 62 65 65 6e 20 63 68 61 6e 67 65 64 2c	/how.something.has.been.changed,
e480	20 6d 61 6b 65 73 20 65 76 65 72 79 6f 6e 65 27 73 20 6c 69 66 65 20 65 61 73 69 65 72 20 77 68	.makes.everyone's.life.easier.wh
e4a0	65 6e 20 77 6f 72 6b 69 6e 67 20 77 69 74 68 20 60 67 69 74 20 62 69 73 65 63 74 60 00 57 68 65	en.working.with.`git.bisect`.Whe
e4c0	6e 20 61 6e 64 20 49 53 4f 20 69 6d 61 67 65 20 69 73 20 61 73 73 65 6d 62 6c 65 64 20 62 79 20	n.and.ISO.image.is.assembled.by.
e4e0	74 68 65 20 60 56 79 4f 53 20 43 49 60 5f 2c 20 74 68 65 20 60 60 42 55 49 4c 44 5f 53 4d 4f 4b	the.`VyOS.CI`_,.the.``BUILD_SMOK
e500	45 54 45 53 54 60 60 20 70 61 72 61 6d 65 74 65 72 20 69 73 20 65 6e 61 62 6c 65 64 20 62 79 20	ETEST``.parameter.is.enabled.by.
e520	64 65 66 61 75 6c 74 2c 20 77 68 69 63 68 20 77 69 6c 6c 20 65 78 74 65 6e 64 20 74 68 65 20 49	default,.which.will.extend.the.I
e540	53 4f 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 6c 69 6e 65 20 77 69 74 68 20 74 68 65 20 66	SO.configuration.line.with.the.f
e560	6f 6c 6c 6f 77 69 6e 67 20 70 61 63 6b 61 67 65 73 3a 00 57 68 65 6e 20 68 61 76 69 6e 67 20 74	ollowing.packages:.When.having.t
e580	72 6f 75 62 6c 65 20 63 6f 6d 70 69 6c 69 6e 67 20 79 6f 75 72 20 6f 77 6e 20 49 53 4f 20 69 6d	rouble.compiling.your.own.ISO.im
e5a0	61 67 65 20 6f 72 20 64 65 62 75 67 67 69 6e 67 20 4a 65 6e 6b 69 6e 73 20 69 73 73 75 65 73 20	age.or.debugging.Jenkins.issues.
e5c0	79 6f 75 20 63 61 6e 20 66 6f 6c 6c 6f 77 20 74 68 65 20 73 74 65 70 73 20 61 74 20 3a 72 65 66	you.can.follow.the.steps.at.:ref
e5e0	3a 60 69 73 6f 5f 62 75 69 6c 64 5f 69 73 73 75 65 73 60 2e 00 57 68 65 6e 20 6d 6f 64 69 66 79	:`iso_build_issues`..When.modify
e600	69 6e 67 20 74 68 65 20 73 6f 75 72 63 65 20 63 6f 64 65 2c 20 72 65 6d 65 6d 62 65 72 20 74 68	ing.the.source.code,.remember.th
e620	65 73 65 20 72 75 6c 65 73 20 6f 66 20 74 68 65 20 6c 65 67 61 63 79 20 65 6c 69 6d 69 6e 61 74	ese.rules.of.the.legacy.eliminat
e640	69 6f 6e 20 63 61 6d 70 61 69 67 6e 3a 00 57 68 65 6e 20 74 68 65 20 62 75 69 6c 64 20 69 73 20	ion.campaign:.When.the.build.is.
e660	73 75 63 63 65 73 73 66 75 6c 2c 20 74 68 65 20 72 65 73 75 6c 74 69 6e 67 20 69 73 6f 20 63 61	successful,.the.resulting.iso.ca
e680	6e 20 62 65 20 66 6f 75 6e 64 20 69 6e 73 69 64 65 20 74 68 65 20 60 60 62 75 69 6c 64 60 60 20	n.be.found.inside.the.``build``.
e6a0	64 69 72 65 63 74 6f 72 79 20 61 73 20 60 60 6c 69 76 65 2d 69 6d 61 67 65 2d 5b 61 72 63 68 69	directory.as.``live-image-[archi
e6c0	74 65 63 74 75 72 65 5d 2e 68 79 62 72 69 64 2e 69 73 6f 60 60 2e 00 57 68 65 6e 20 77 72 69 74	tecture].hybrid.iso``..When.writ
e6e0	69 6e 67 20 61 20 6e 65 77 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 6d 69 67 72 61 74 6f 72	ing.a.new.configuration.migrator
e700	20 69 74 20 6d 61 79 20 68 61 70 70 65 6e 20 74 68 61 74 20 79 6f 75 20 73 65 65 20 61 6e 20 65	.it.may.happen.that.you.see.an.e
e720	72 72 6f 72 20 77 68 65 6e 20 79 6f 75 20 74 72 79 20 74 6f 20 69 6e 76 6f 6b 65 20 69 74 20 6d	rror.when.you.try.to.invoke.it.m
e740	61 6e 75 61 6c 6c 79 20 6f 6e 20 61 20 64 65 76 65 6c 6f 70 6d 65 6e 74 20 73 79 73 74 65 6d 2e	anually.on.a.development.system.
e760	20 54 68 69 73 20 65 72 72 6f 72 20 77 69 6c 6c 20 6c 6f 6f 6b 20 6c 69 6b 65 3a 00 57 68 65 6e	.This.error.will.look.like:.When
e780	20 79 6f 75 20 61 72 65 20 61 62 6c 65 20 74 6f 20 76 65 72 69 66 79 20 74 68 61 74 20 69 74 20	.you.are.able.to.verify.that.it.
e7a0	69 73 20 61 63 74 75 61 6c 6c 79 20 61 20 62 75 67 2c 20 73 70 65 6e 64 20 73 6f 6d 65 20 74 69	is.actually.a.bug,.spend.some.ti
e7c0	6d 65 20 74 6f 20 64 6f 63 75 6d 65 6e 74 20 68 6f 77 20 74 6f 20 72 65 70 72 6f 64 75 63 65 20	me.to.document.how.to.reproduce.
e7e0	74 68 65 20 69 73 73 75 65 2e 20 54 68 69 73 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 63 61	the.issue..This.documentation.ca
e800	6e 20 62 65 20 69 6e 76 61 6c 75 61 62 6c 65 2e 00 57 68 65 6e 20 79 6f 75 20 61 72 65 20 77 6f	n.be.invaluable..When.you.are.wo
e820	72 6b 69 6e 67 20 6f 6e 20 69 6e 74 65 72 66 61 63 65 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e	rking.on.interface.configuration
e840	20 61 6e 64 20 79 6f 75 20 61 6c 73 6f 20 77 61 6e 27 74 20 74 6f 20 74 65 73 74 20 69 66 20 74	.and.you.also.wan't.to.test.if.t
e860	68 65 20 53 6d 6f 6b 65 74 65 73 74 73 20 70 61 73 73 20 79 6f 75 20 77 6f 75 6c 64 20 6e 6f 72	he.Smoketests.pass.you.would.nor
e880	6d 61 6c 6c 79 20 6c 6f 6f 73 65 20 74 68 65 20 72 65 6d 6f 74 65 20 53 53 48 20 63 6f 6e 6e 65	mally.loose.the.remote.SSH.conne
e8a0	63 74 69 6f 6e 20 74 6f 20 79 6f 75 72 20 3a 61 62 62 72 3a 60 44 55 54 20 28 44 65 76 69 63 65	ction.to.your.:abbr:`DUT.(Device
e8c0	20 55 6e 64 65 72 20 54 65 73 74 29 60 2e 20 54 6f 20 68 61 6e 64 6c 65 20 74 68 69 73 20 69 73	.Under.Test)`..To.handle.this.is
e8e0	73 75 65 2c 20 73 6f 6d 65 20 6f 66 20 74 68 65 20 69 6e 74 65 72 66 61 63 65 20 62 61 73 65 64	sue,.some.of.the.interface.based
e900	20 74 65 73 74 73 20 63 61 6e 20 62 65 20 63 61 6c 6c 65 64 20 77 69 74 68 20 61 6e 20 65 6e 76	.tests.can.be.called.with.an.env
e920	69 72 6f 6e 6d 65 6e 74 20 76 61 72 69 61 62 6c 65 20 62 65 66 6f 72 65 68 61 6e 64 20 74 6f 20	ironment.variable.beforehand.to.
e940	6c 69 6d 69 74 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 69 6e 74 65 72 66 61 63 65 73 20 75	limit.the.number.of.interfaces.u
e960	73 65 64 20 69 6e 20 74 68 65 20 74 65 73 74 2e 20 42 79 20 64 65 66 61 75 6c 74 20 61 6c 6c 20	sed.in.the.test..By.default.all.
e980	69 6e 74 65 72 66 61 63 65 20 65 2e 67 2e 20 61 6c 6c 20 45 74 68 65 72 6e 65 74 20 69 6e 74 65	interface.e.g..all.Ethernet.inte
e9a0	72 66 61 63 65 73 20 61 72 65 20 75 73 65 64 2e 00 57 68 65 6e 20 79 6f 75 20 61 72 65 20 77 6f	rfaces.are.used..When.you.are.wo
e9c0	72 6b 69 6e 67 20 6f 6e 20 69 6e 74 65 72 66 61 63 65 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e	rking.on.interface.configuration
e9e0	20 61 6e 64 20 79 6f 75 20 61 6c 73 6f 20 77 61 6e 74 20 74 6f 20 74 65 73 74 20 69 66 20 74 68	.and.you.also.want.to.test.if.th
ea00	65 20 53 6d 6f 6b 65 74 65 73 74 73 20 70 61 73 73 20 79 6f 75 20 77 6f 75 6c 64 20 6e 6f 72 6d	e.Smoketests.pass.you.would.norm
ea20	61 6c 6c 79 20 6c 6f 6f 73 65 20 74 68 65 20 72 65 6d 6f 74 65 20 53 53 48 20 63 6f 6e 6e 65 63	ally.loose.the.remote.SSH.connec
ea40	74 69 6f 6e 20 74 6f 20 79 6f 75 72 20 3a 61 62 62 72 3a 60 44 55 54 20 28 44 65 76 69 63 65 20	tion.to.your.:abbr:`DUT.(Device.
ea60	55 6e 64 65 72 20 54 65 73 74 29 60 2e 20 54 6f 20 68 61 6e 64 6c 65 20 74 68 69 73 20 69 73 73	Under.Test)`..To.handle.this.iss
ea80	75 65 2c 20 73 6f 6d 65 20 6f 66 20 74 68 65 20 69 6e 74 65 72 66 61 63 65 20 62 61 73 65 64 20	ue,.some.of.the.interface.based.
eaa0	74 65 73 74 73 20 63 61 6e 20 62 65 20 63 61 6c 6c 65 64 20 77 69 74 68 20 61 6e 20 65 6e 76 69	tests.can.be.called.with.an.envi
eac0	72 6f 6e 6d 65 6e 74 20 76 61 72 69 61 62 6c 65 20 62 65 66 6f 72 65 68 61 6e 64 20 74 6f 20 6c	ronment.variable.beforehand.to.l
eae0	69 6d 69 74 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 69 6e 74 65 72 66 61 63 65 73 20 75 73	imit.the.number.of.interfaces.us
eb00	65 64 20 69 6e 20 74 68 65 20 74 65 73 74 2e 20 42 79 20 64 65 66 61 75 6c 74 20 61 6c 6c 20 69	ed.in.the.test..By.default.all.i
eb20	6e 74 65 72 66 61 63 65 20 65 2e 67 2e 20 61 6c 6c 20 45 74 68 65 72 6e 65 74 20 69 6e 74 65 72	nterface.e.g..all.Ethernet.inter
eb40	66 61 63 65 73 20 61 72 65 20 75 73 65 64 2e 00 57 68 65 6e 20 79 6f 75 20 62 65 6c 69 65 76 65	faces.are.used..When.you.believe
eb60	20 79 6f 75 20 68 61 76 65 20 66 6f 75 6e 64 20 61 20 62 75 67 2c 20 69 74 20 69 73 20 61 6c 77	.you.have.found.a.bug,.it.is.alw
eb80	61 79 73 20 61 20 67 6f 6f 64 20 69 64 65 61 20 74 6f 20 76 65 72 69 66 79 20 74 68 65 20 69 73	ays.a.good.idea.to.verify.the.is
eba0	73 75 65 20 70 72 69 6f 72 20 74 6f 20 6f 70 65 6e 69 6e 67 20 61 20 62 75 67 20 72 65 71 75 65	sue.prior.to.opening.a.bug.reque
ebc0	73 74 2e 00 57 68 65 6e 20 79 6f 75 20 77 69 73 68 20 74 6f 20 68 61 76 65 20 61 20 64 65 76 65	st..When.you.wish.to.have.a.deve
ebe0	6c 6f 70 65 72 20 66 69 78 20 61 20 62 75 67 20 74 68 61 74 20 79 6f 75 20 66 6f 75 6e 64 2c 20	loper.fix.a.bug.that.you.found,.
ec00	68 65 6c 70 69 6e 67 20 74 68 65 6d 20 72 65 70 72 6f 64 75 63 65 20 74 68 65 20 69 73 73 75 65	helping.them.reproduce.the.issue
ec20	20 69 73 20 62 65 6e 65 66 69 63 69 61 6c 20 74 6f 20 65 76 65 72 79 6f 6e 65 2e 20 42 65 20 73	.is.beneficial.to.everyone..Be.s
ec40	75 72 65 20 74 6f 20 69 6e 63 6c 75 64 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 61 62 6f 75 74	ure.to.include.information.about
ec60	20 74 68 65 20 68 61 72 64 77 61 72 65 20 79 6f 75 20 61 72 65 20 75 73 69 6e 67 2c 20 63 6f 6d	.the.hardware.you.are.using,.com
ec80	6d 61 6e 64 73 20 74 68 61 74 20 79 6f 75 20 77 65 72 65 20 72 75 6e 6e 69 6e 67 2c 20 61 6e 79	mands.that.you.were.running,.any
eca0	20 6f 74 68 65 72 20 61 63 74 69 76 69 74 69 65 73 20 74 68 61 74 20 79 6f 75 20 6d 61 79 20 68	.other.activities.that.you.may.h
ecc0	61 76 65 20 62 65 65 6e 20 64 6f 69 6e 67 20 61 74 20 74 68 65 20 74 69 6d 65 2e 20 54 68 69 73	ave.been.doing.at.the.time..This
ece0	20 61 64 64 69 74 69 6f 6e 61 6c 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 63 61 6e 20 62 65 20 76	.additional.information.can.be.v
ed00	65 72 79 20 75 73 65 66 75 6c 2e 00 57 68 69 63 68 20 76 65 72 73 69 6f 6e 20 6f 66 20 56 79 4f	ery.useful..Which.version.of.VyO
ed20	53 20 61 72 65 20 79 6f 75 20 75 73 69 6e 67 3f 20 60 60 72 75 6e 20 73 68 6f 77 20 76 65 72 73	S.are.you.using?.``run.show.vers
ed40	69 6f 6e 60 60 00 57 69 72 65 47 75 61 72 64 00 57 72 69 74 69 6e 67 20 67 6f 6f 64 20 63 6f 6d	ion``.WireGuard.Writing.good.com
ed60	6d 69 74 20 6d 65 73 73 61 67 65 73 00 58 4d 4c 20 28 75 73 65 64 20 66 6f 72 20 43 4c 49 20 64	mit.messages.XML.(used.for.CLI.d
ed80	65 66 69 6e 69 74 69 6f 6e 73 29 00 58 4d 4c 20 69 6e 74 65 72 66 61 63 65 20 64 65 66 69 6e 69	efinitions).XML.interface.defini
eda0	74 69 6f 6e 20 66 69 6c 65 73 20 75 73 65 20 74 68 65 20 60 78 6d 6c 2e 69 6e 60 20 66 69 6c 65	tion.files.use.the.`xml.in`.file
edc0	20 65 78 74 65 6e 73 69 6f 6e 20 77 68 69 63 68 20 77 61 73 20 69 6d 70 6c 65 6d 65 6e 74 65 64	.extension.which.was.implemented
ede0	20 69 6e 20 3a 76 79 74 61 73 6b 3a 60 54 31 38 34 33 60 2e 20 58 4d 4c 20 69 6e 74 65 72 66 61	.in.:vytask:`T1843`..XML.interfa
ee00	63 65 20 64 65 66 69 6e 69 74 69 6f 6e 73 20 74 65 6e 64 20 74 6f 20 68 61 76 65 20 61 20 6c 6f	ce.definitions.tend.to.have.a.lo
ee20	74 20 6f 66 20 64 75 70 6c 69 63 61 74 65 64 20 63 6f 64 65 20 69 6e 20 61 72 65 61 73 20 73 75	t.of.duplicated.code.in.areas.su
ee40	63 68 20 61 73 3a 00 58 4d 4c 20 69 6e 74 65 72 66 61 63 65 20 64 65 66 69 6e 69 74 69 6f 6e 73	ch.as:.XML.interface.definitions
ee60	20 66 6f 72 20 56 79 4f 53 20 63 6f 6d 65 20 77 69 74 68 20 61 20 52 65 6c 61 78 4e 47 20 73 63	.for.VyOS.come.with.a.RelaxNG.sc
ee80	68 65 6d 61 20 61 6e 64 20 61 72 65 20 6c 6f 63 61 74 65 64 20 69 6e 20 74 68 65 20 76 79 6f 73	hema.and.are.located.in.the.vyos
eea0	2d 31 78 5f 20 6d 6f 64 75 6c 65 2e 20 54 68 69 73 20 73 63 68 65 6d 61 20 69 73 20 61 20 73 6c	-1x_.module..This.schema.is.a.sl
eec0	69 67 68 74 6c 79 20 6d 6f 64 69 66 69 65 64 20 73 63 68 65 6d 61 20 66 72 6f 6d 20 56 79 43 6f	ightly.modified.schema.from.VyCo
eee0	6e 66 5f 20 61 6c 69 61 73 20 56 79 4f 53 20 32 2e 30 20 53 6f 20 56 79 4f 53 20 31 2e 32 2e 78	nf_.alias.VyOS.2.0.So.VyOS.1.2.x
ef00	20 69 6e 74 65 72 66 61 63 65 20 64 65 66 69 6e 69 74 69 6f 6e 73 20 77 69 6c 6c 20 62 65 20 72	.interface.definitions.will.be.r
ef20	65 75 73 61 62 6c 65 20 69 6e 20 4e 65 78 74 67 65 6e 20 56 79 4f 53 20 56 65 72 73 69 6f 6e 73	eusable.in.Nextgen.VyOS.Versions
ef40	20 77 69 74 68 20 76 65 72 79 20 6d 69 6e 69 6d 61 6c 20 63 68 61 6e 67 65 73 2e 00 58 4d 4c 3a	.with.very.minimal.changes..XML:
ef60	20 54 61 62 73 20 2a 2a 73 68 61 6c 6c 20 6e 6f 74 2a 2a 20 62 65 20 75 73 65 64 2e 20 45 76 65	.Tabs.**shall.not**.be.used..Eve
ef80	72 79 20 69 6e 64 65 6e 74 61 74 69 6f 6e 20 6c 65 76 65 6c 20 73 68 6f 75 6c 64 20 62 65 20 32	ry.indentation.level.should.be.2
efa0	20 73 70 61 63 65 73 00 59 6f 75 20 63 61 6e 20 61 6c 73 6f 20 70 6c 61 63 65 20 74 68 65 20 67	.spaces.You.can.also.place.the.g
efc0	65 6e 65 72 61 74 65 64 20 60 2a 2e 64 65 62 60 20 69 6e 74 6f 20 79 6f 75 72 20 49 53 4f 20 62	enerated.`*.deb`.into.your.ISO.b
efe0	75 69 6c 64 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 74 6f 20 69 6e 63 6c 75 64 65 20 69 74 20 69	uild.environment.to.include.it.i
f000	6e 20 61 20 63 75 73 74 6f 6d 20 69 73 6f 2c 20 73 65 65 20 3a 72 65 66 3a 60 62 75 69 6c 64 5f	n.a.custom.iso,.see.:ref:`build_
f020	63 75 73 74 6f 6d 5f 70 61 63 6b 61 67 65 73 60 20 66 6f 72 20 6d 6f 72 65 20 69 6e 66 6f 72 6d	custom_packages`.for.more.inform
f040	61 74 69 6f 6e 2e 00 59 6f 75 20 63 61 6e 20 63 72 65 61 74 65 20 79 6f 75 72 73 65 6c 66 20 73	ation..You.can.create.yourself.s
f060	6f 6d 65 20 68 61 6e 64 79 20 42 61 73 68 20 61 6c 69 61 73 65 73 20 74 6f 20 61 6c 77 61 79 73	ome.handy.Bash.aliases.to.always
f080	20 6c 61 75 6e 63 68 20 74 68 65 20 6c 61 74 65 73 74 20 2d 20 70 65 72 20 72 65 6c 65 61 73 65	.launch.the.latest.-.per.release
f0a0	20 74 72 61 69 6e 20 28 60 63 75 72 72 65 6e 74 60 20 6f 72 20 60 63 72 75 78 60 29 20 2d 20 63	.train.(`current`.or.`crux`).-.c
f0c0	6f 6e 74 61 69 6e 65 72 2e 20 41 64 64 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 74 6f 20 79	ontainer..Add.the.following.to.y
f0e0	6f 75 72 20 60 60 2e 62 61 73 68 5f 61 6c 69 61 73 65 73 60 60 20 66 69 6c 65 3a 00 59 6f 75 20	our.``.bash_aliases``.file:.You.
f100	63 61 6e 20 74 79 70 65 20 60 60 68 65 6c 70 60 60 20 74 6f 20 67 65 74 20 61 6e 20 6f 76 65 72	can.type.``help``.to.get.an.over
f120	76 69 65 77 20 6f 66 20 74 68 65 20 61 76 61 69 6c 61 62 6c 65 20 63 6f 6d 6d 61 6e 64 73 2c 20	view.of.the.available.commands,.
f140	61 6e 64 20 60 60 68 65 6c 70 20 63 6f 6d 6d 61 6e 64 60 60 20 74 6f 20 67 65 74 20 6d 6f 72 65	and.``help.command``.to.get.more
f160	20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 6f 6e 20 65 61 63 68 20 63 6f 6d 6d 61 6e 64 2e 00 59 6f	.information.on.each.command..Yo
f180	75 20 68 61 76 65 20 61 6e 20 69 64 65 61 20 6f 66 20 68 6f 77 20 74 6f 20 6d 61 6b 65 20 56 79	u.have.an.idea.of.how.to.make.Vy
f1a0	4f 53 20 62 65 74 74 65 72 20 6f 72 20 79 6f 75 20 61 72 65 20 69 6e 20 6e 65 65 64 20 6f 66 20	OS.better.or.you.are.in.need.of.
f1c0	61 20 73 70 65 63 69 66 69 63 20 66 65 61 74 75 72 65 20 77 68 69 63 68 20 61 6c 6c 20 75 73 65	a.specific.feature.which.all.use
f1e0	72 73 20 6f 66 20 56 79 4f 53 20 77 6f 75 6c 64 20 62 65 6e 65 66 69 74 20 66 72 6f 6d 3f 20 54	rs.of.VyOS.would.benefit.from?.T
f200	6f 20 73 65 6e 64 20 61 20 66 65 61 74 75 72 65 20 72 65 71 75 65 73 74 20 70 6c 65 61 73 65 20	o.send.a.feature.request.please.
f220	73 65 61 72 63 68 20 50 68 61 62 72 69 63 61 74 6f 72 5f 20 69 66 20 74 68 65 72 65 20 69 73 20	search.Phabricator_.if.there.is.
f240	61 6c 72 65 61 64 79 20 61 20 72 65 71 75 65 73 74 20 70 65 6e 64 69 6e 67 2e 20 59 6f 75 20 63	already.a.request.pending..You.c
f260	61 6e 20 65 6e 68 61 6e 63 65 20 69 74 20 6f 72 20 69 66 20 79 6f 75 20 64 6f 6e 27 74 20 66 69	an.enhance.it.or.if.you.don't.fi
f280	6e 64 20 6f 6e 65 2c 20 63 72 65 61 74 65 20 61 20 6e 65 77 20 6f 6e 65 20 62 79 20 75 73 65 20	nd.one,.create.a.new.one.by.use.
f2a0	74 68 65 20 71 75 69 63 6b 20 6c 69 6e 6b 20 69 6e 20 74 68 65 20 6c 65 66 74 20 73 69 64 65 20	the.quick.link.in.the.left.side.
f2c0	75 6e 64 65 72 20 74 68 65 20 73 70 65 63 69 66 69 63 20 70 72 6f 6a 65 63 74 2e 00 59 6f 75 20	under.the.specific.project..You.
f2e0	68 61 76 65 20 61 6e 20 69 64 65 61 20 6f 66 20 68 6f 77 20 74 6f 20 6d 61 6b 65 20 56 79 4f 53	have.an.idea.of.how.to.make.VyOS
f300	20 62 65 74 74 65 72 20 6f 72 20 79 6f 75 20 61 72 65 20 69 6e 20 6e 65 65 64 20 6f 66 20 61 20	.better.or.you.are.in.need.of.a.
f320	73 70 65 63 69 66 69 63 20 66 65 61 74 75 72 65 20 77 68 69 63 68 20 61 6c 6c 20 75 73 65 72 73	specific.feature.which.all.users
f340	20 6f 66 20 56 79 4f 53 20 77 6f 75 6c 64 20 62 65 6e 65 66 69 74 20 66 72 6f 6d 3f 20 54 6f 20	.of.VyOS.would.benefit.from?.To.
f360	73 65 6e 64 20 61 20 66 65 61 74 75 72 65 20 72 65 71 75 65 73 74 20 70 6c 65 61 73 65 20 73 65	send.a.feature.request.please.se
f380	61 72 63 68 20 50 68 61 62 72 69 63 61 74 6f 72 5f 20 74 6f 20 63 68 65 63 6b 20 69 66 20 74 68	arch.Phabricator_.to.check.if.th
f3a0	65 72 65 20 69 73 20 61 6c 72 65 61 64 79 20 61 20 72 65 71 75 65 73 74 20 70 65 6e 64 69 6e 67	ere.is.already.a.request.pending
f3c0	2e 20 59 6f 75 20 63 61 6e 20 65 6e 68 61 6e 63 65 20 69 74 20 6f 72 20 69 66 20 79 6f 75 20 64	..You.can.enhance.it.or.if.you.d
f3e0	6f 6e 27 74 20 66 69 6e 64 20 6f 6e 65 2c 20 63 72 65 61 74 65 20 61 20 6e 65 77 20 6f 6e 65 20	on't.find.one,.create.a.new.one.
f400	62 79 20 75 73 65 20 74 68 65 20 71 75 69 63 6b 20 6c 69 6e 6b 20 69 6e 20 74 68 65 20 6c 65 66	by.use.the.quick.link.in.the.lef
f420	74 20 73 69 64 65 20 75 6e 64 65 72 20 74 68 65 20 73 70 65 63 69 66 69 63 20 70 72 6f 6a 65 63	t.side.under.the.specific.projec
f440	74 2e 00 59 6f 75 20 68 61 76 65 20 79 6f 75 72 20 6f 77 6e 20 63 75 73 74 6f 6d 20 6b 65 72 6e	t..You.have.your.own.custom.kern
f460	65 6c 20 60 2a 2e 64 65 62 60 20 70 61 63 6b 61 67 65 73 20 69 6e 20 74 68 65 20 60 70 61 63 6b	el.`*.deb`.packages.in.the.`pack
f480	61 67 65 73 60 20 66 6f 6c 64 65 72 20 62 75 74 20 6e 65 67 6c 65 63 74 65 64 20 74 6f 20 63 72	ages`.folder.but.neglected.to.cr
f4a0	65 61 74 65 20 61 6c 6c 20 72 65 71 75 69 72 65 64 20 6f 75 74 2d 6f 66 20 74 72 65 65 20 6d 6f	eate.all.required.out-of.tree.mo
f4c0	64 75 6c 65 73 20 6c 69 6b 65 20 41 63 63 65 6c 2d 50 50 50 2c 20 49 6e 74 65 6c 20 51 41 54 20	dules.like.Accel-PPP,.Intel.QAT.
f4e0	6f 72 20 49 6e 74 65 6c 20 4e 49 43 20 64 72 69 76 65 72 73 00 59 6f 75 20 68 61 76 65 20 79 6f	or.Intel.NIC.drivers.You.have.yo
f500	75 72 20 6f 77 6e 20 63 75 73 74 6f 6d 20 6b 65 72 6e 65 6c 20 60 2a 2e 64 65 62 60 20 70 61 63	ur.own.custom.kernel.`*.deb`.pac
f520	6b 61 67 65 73 20 69 6e 20 74 68 65 20 60 70 61 63 6b 61 67 65 73 60 20 66 6f 6c 64 65 72 20 62	kages.in.the.`packages`.folder.b
f540	75 74 20 6e 65 67 6c 65 63 74 65 64 20 74 6f 20 63 72 65 61 74 65 20 61 6c 6c 20 72 65 71 75 69	ut.neglected.to.create.all.requi
f560	72 65 64 20 6f 75 74 2d 6f 66 20 74 72 65 65 20 6d 6f 64 75 6c 65 73 20 6c 69 6b 65 20 41 63 63	red.out-of.tree.modules.like.Acc
f580	65 6c 2d 50 50 50 2c 20 57 69 72 65 47 75 61 72 64 2c 20 49 6e 74 65 6c 20 51 41 54 2c 20 49 6e	el-PPP,.WireGuard,.Intel.QAT,.In
f5a0	74 65 6c 20 4e 49 43 00 59 6f 75 20 6d 75 73 74 20 63 72 65 61 74 65 20 61 20 74 61 73 6b 20 62	tel.NIC.You.must.create.a.task.b
f5c0	65 66 6f 72 65 20 79 6f 75 20 73 74 61 72 74 20 77 6f 72 6b 69 6e 67 20 6f 6e 20 61 20 66 65 61	efore.you.start.working.on.a.fea
f5e0	74 75 72 65 2e 20 59 65 73 2c 20 65 76 65 6e 20 69 66 20 69 74 27 73 20 61 20 74 69 6e 79 20 66	ture..Yes,.even.if.it's.a.tiny.f
f600	65 61 74 75 72 65 20 e2 80 94 20 77 65 20 75 73 65 20 74 68 65 20 74 61 73 6b 20 74 72 61 63 6b	eature.....we.use.the.task.track
f620	65 72 20 74 6f 20 67 65 6e 65 72 61 74 65 20 72 65 6c 65 61 73 65 20 6e 6f 74 65 73 2c 20 73 6f	er.to.generate.release.notes,.so
f640	20 69 74 27 73 20 65 73 73 65 6e 74 69 61 6c 20 74 68 61 74 20 65 76 65 72 79 74 68 69 6e 67 20	.it's.essential.that.everything.
f660	69 73 20 72 65 66 6c 65 63 74 65 64 20 74 68 65 72 65 2e 00 59 6f 75 20 6d 75 73 74 20 69 6e 63	is.reflected.there..You.must.inc
f680	6c 75 64 65 20 61 74 20 6c 65 61 73 74 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 3a 00 59 6f 75	lude.at.least.the.following:.You
f6a0	20 73 68 6f 75 64 6c 20 6e 6f 77 20 73 65 65 20 61 20 50 79 74 68 6f 6e 20 62 61 63 6b 74 72 61	.shoudl.now.see.a.Python.backtra
f6c0	63 65 20 77 68 69 63 68 20 77 69 6c 6c 20 68 65 6c 70 20 75 73 20 74 6f 20 68 61 6e 64 6c 65 20	ce.which.will.help.us.to.handle.
f6e0	74 68 65 20 69 73 73 75 65 2c 20 70 6c 65 61 73 65 20 61 74 74 61 63 68 20 69 74 20 74 6f 20 74	the.issue,.please.attach.it.to.t
f700	68 65 20 50 68 61 62 72 69 63 61 74 6f 72 5f 20 74 61 73 6b 2e 00 59 6f 75 20 73 68 6f 75 6c 64	he.Phabricator_.task..You.should
f720	20 69 6e 63 6c 75 64 65 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 69 6e 66 6f 72 6d 61 74 69	.include.the.following.informati
f740	6f 6e 3a 00 59 6f 75 20 73 68 6f 75 6c 64 20 6e 6f 77 20 73 65 65 20 61 20 50 79 74 68 6f 6e 20	on:.You.should.now.see.a.Python.
f760	62 61 63 6b 74 72 61 63 65 20 77 68 69 63 68 20 77 69 6c 6c 20 68 65 6c 70 20 75 73 20 74 6f 20	backtrace.which.will.help.us.to.
f780	68 61 6e 64 6c 65 20 74 68 65 20 69 73 73 75 65 2c 20 70 6c 65 61 73 65 20 61 74 74 61 63 68 20	handle.the.issue,.please.attach.
f7a0	69 74 20 74 6f 20 74 68 65 20 50 68 61 62 72 69 63 61 74 6f 72 5f 20 74 61 73 6b 2e 00 59 6f 75	it.to.the.Phabricator_.task..You
f7c0	20 74 68 65 6e 20 63 61 6e 20 70 72 6f 63 65 65 64 20 77 69 74 68 20 63 6c 6f 6e 69 6e 67 20 79	.then.can.proceed.with.cloning.y
f7e0	6f 75 72 20 66 6f 72 6b 20 6f 72 20 61 64 64 20 61 20 6e 65 77 20 72 65 6d 6f 74 65 20 74 6f 20	our.fork.or.add.a.new.remote.to.
f800	79 6f 75 72 20 6c 6f 63 61 6c 20 72 65 70 6f 73 69 74 6f 72 79 3a 00 59 6f 75 72 20 63 6f 6e 66	your.local.repository:.Your.conf
f820	69 67 75 72 61 74 69 6f 6e 20 73 63 72 69 70 74 20 6f 72 20 6f 70 65 72 61 74 69 6f 6e 20 6d 6f	iguration.script.or.operation.mo
f840	64 65 20 73 63 72 69 70 74 20 77 68 69 63 68 20 69 73 20 61 6c 73 6f 20 77 72 69 74 74 65 6e 20	de.script.which.is.also.written.
f860	69 6e 20 50 79 74 68 6f 6e 33 20 73 68 6f 75 6c 64 20 68 61 76 65 20 61 20 6c 69 6e 65 20 62 72	in.Python3.should.have.a.line.br
f880	65 61 6b 20 6f 6e 20 38 30 20 63 68 61 72 61 63 74 65 72 73 2e 20 54 68 69 73 20 73 65 65 6d 73	eak.on.80.characters..This.seems
f8a0	20 74 6f 20 62 65 20 61 20 62 69 74 20 6f 64 64 20 6e 6f 77 61 64 61 79 73 20 62 75 74 20 61 73	.to.be.a.bit.odd.nowadays.but.as
f8c0	20 73 6f 6d 65 20 70 65 6f 70 6c 65 20 61 6c 73 6f 20 77 6f 72 6b 20 72 65 6d 6f 74 65 6c 79 20	.some.people.also.work.remotely.
f8e0	6f 72 20 70 72 6f 67 72 61 6d 20 75 73 69 6e 67 20 76 69 28 6d 29 20 74 68 69 73 20 69 73 20 61	or.program.using.vi(m).this.is.a
f900	20 66 61 69 72 20 67 6f 6f 64 20 73 74 61 6e 64 61 72 64 20 77 68 69 63 68 20 49 20 68 6f 70 65	.fair.good.standard.which.I.hope
f920	20 77 65 20 63 61 6e 20 72 65 6c 79 20 6f 6e 2e 00 60 2e 2f 63 6f 6e 66 69 67 75 72 65 20 2d 2d	.we.can.rely.on..`./configure.--
f940	65 6e 61 62 6c 65 2d 70 79 74 68 6f 6e 2d 65 67 67 73 60 00 60 49 50 76 34 2c 20 49 50 76 36 20	enable-python-eggs`.`IPv4,.IPv6.
f960	61 6e 64 20 44 48 43 50 28 76 36 29 60 5f 20 61 64 64 72 65 73 73 20 61 73 73 69 67 6e 6d 65 6e	and.DHCP(v6)`_.address.assignmen
f980	74 00 60 49 50 76 34 2c 20 49 50 76 36 60 5f 20 61 64 64 72 65 73 73 20 61 73 73 69 67 6e 6d 65	t.`IPv4,.IPv6`_.address.assignme
f9a0	6e 74 00 60 4d 41 43 20 61 64 64 72 65 73 73 60 5f 20 61 73 73 69 67 6e 6d 65 6e 74 00 60 56 4c	nt.`MAC.address`_.assignment.`VL
f9c0	41 4e 20 28 56 49 46 29 60 5f 20 64 65 66 69 6e 69 74 69 6f 6e 00 60 60 4a 65 6e 6b 69 6e 73 3a	AN.(VIF)`_.definition.``Jenkins:
f9e0	20 61 64 64 20 63 75 72 72 65 6e 74 20 47 69 74 20 63 6f 6d 6d 69 74 20 49 44 20 74 6f 20 62 75	.add.current.Git.commit.ID.to.bu
fa00	69 6c 64 20 64 65 73 63 72 69 70 74 69 6f 6e 60 60 00 60 60 63 6f 6d 6d 61 6e 64 60 60 20 2d 20	ild.description``.``command``.-.
fa20	4f 6e 63 65 20 73 65 74 2c 20 61 6c 6c 20 63 6f 6d 6d 61 6e 64 73 20 75 73 65 64 2c 20 61 6e 64	Once.set,.all.commands.used,.and
fa40	20 74 68 65 69 72 20 72 65 73 70 6f 6e 73 65 73 20 72 65 63 65 69 76 65 64 20 66 72 6f 6d 20 74	.their.responses.received.from.t
fa60	68 65 20 4f 53 2c 20 77 69 6c 6c 20 62 65 20 70 72 65 73 65 6e 74 65 64 20 6f 6e 20 74 68 65 20	he.OS,.will.be.presented.on.the.
fa80	73 63 72 65 65 6e 20 66 6f 72 20 69 6e 73 70 65 63 74 69 6f 6e 2e 00 60 60 63 6f 6d 6d 69 74 60	screen.for.inspection..``commit`
faa0	60 00 60 60 64 64 63 6c 69 65 6e 74 3a 20 54 31 30 33 30 3a 20 61 75 74 6f 20 63 72 65 61 74 65	`.``ddclient:.T1030:.auto.create
fac0	20 72 75 6e 74 69 6d 65 20 64 69 72 65 63 74 6f 72 69 65 73 60 60 00 60 60 64 65 76 65 6c 6f 70	.runtime.directories``.``develop
fae0	65 72 60 60 20 2d 20 53 68 6f 75 6c 64 20 61 20 63 6f 6d 6d 61 6e 64 20 66 61 69 6c 2c 20 69 6e	er``.-.Should.a.command.fail,.in
fb00	73 74 65 61 64 20 6f 66 20 70 72 69 6e 74 69 6e 67 20 61 20 6d 65 73 73 61 67 65 20 74 6f 20 74	stead.of.printing.a.message.to.t
fb20	68 65 20 75 73 65 72 20 65 78 70 6c 61 69 6e 69 6e 67 20 68 6f 77 20 74 6f 20 72 65 70 6f 72 74	he.user.explaining.how.to.report
fb40	20 69 73 73 75 65 73 2c 20 74 68 65 20 70 79 74 68 6f 6e 20 69 6e 74 65 72 70 72 65 74 65 72 20	.issues,.the.python.interpreter.
fb60	77 69 6c 6c 20 73 74 61 72 74 20 61 20 50 42 44 20 70 6f 73 74 2d 6d 6f 72 74 65 6d 20 73 65 73	will.start.a.PBD.post-mortem.ses
fb80	73 69 6f 6e 20 74 6f 20 61 6c 6c 6f 77 20 74 68 65 20 64 65 76 65 6c 6f 70 65 72 20 74 6f 20 64	sion.to.allow.the.developer.to.d
fba0	65 62 75 67 20 74 68 65 20 69 73 73 75 65 2e 20 41 73 20 74 68 65 20 64 65 62 75 67 67 65 72 20	ebug.the.issue..As.the.debugger.
fbc0	77 69 6c 6c 20 77 61 69 74 20 66 72 6f 6d 20 69 6e 70 75 74 20 66 72 6f 6d 20 74 68 65 20 64 65	will.wait.from.input.from.the.de
fbe0	76 65 6c 6f 70 65 72 2c 20 69 74 20 68 61 73 20 74 68 65 20 63 61 70 61 63 69 74 79 20 74 6f 20	veloper,.it.has.the.capacity.to.
fc00	70 72 65 76 65 6e 74 20 61 20 72 6f 75 74 65 72 20 74 6f 20 62 6f 6f 74 20 61 6e 64 20 74 68 65	prevent.a.router.to.boot.and.the
fc20	72 65 66 6f 72 65 20 73 68 6f 75 6c 64 20 6f 6e 6c 79 20 62 65 20 70 65 72 6d 61 6e 65 6e 74 6c	refore.should.only.be.permanentl
fc40	79 20 73 65 74 20 75 70 20 6f 6e 20 70 72 6f 64 75 63 74 69 6f 6e 20 69 66 20 79 6f 75 20 61 72	y.set.up.on.production.if.you.ar
fc60	65 20 72 65 61 64 79 20 74 6f 20 73 65 65 20 74 68 65 20 4f 53 20 66 61 69 6c 20 74 6f 20 62 6f	e.ready.to.see.the.OS.fail.to.bo
fc80	6f 74 2e 00 60 60 69 66 63 6f 6e 66 69 67 60 60 20 2d 20 4f 6e 63 65 20 73 65 74 2c 20 61 6c 6c	ot..``ifconfig``.-.Once.set,.all
fca0	20 63 6f 6d 6d 61 6e 64 73 20 75 73 65 64 2c 20 61 6e 64 20 74 68 65 69 72 20 72 65 73 70 6f 6e	.commands.used,.and.their.respon
fcc0	73 65 73 20 72 65 63 65 69 76 65 64 20 66 72 6f 6d 20 74 68 65 20 4f 53 2c 20 77 69 6c 6c 20 62	ses.received.from.the.OS,.will.b
fce0	65 20 70 72 65 73 65 6e 74 65 64 20 6f 6e 20 74 68 65 20 73 63 72 65 65 6e 20 66 6f 72 20 69 6e	e.presented.on.the.screen.for.in
fd00	73 70 65 63 74 69 6f 6e 2e 00 60 60 6c 6f 67 60 60 20 2d 20 49 6e 20 73 6f 6d 65 20 72 61 72 65	spection..``log``.-.In.some.rare
fd20	20 63 61 73 65 73 2c 20 69 74 20 6d 61 79 20 62 65 20 75 73 65 66 75 6c 20 74 6f 20 73 65 65 20	.cases,.it.may.be.useful.to.see.
fd40	77 68 61 74 20 74 68 65 20 4f 53 20 69 73 20 64 6f 69 6e 67 2c 20 69 6e 63 6c 75 64 69 6e 67 20	what.the.OS.is.doing,.including.
fd60	64 75 72 69 6e 67 20 62 6f 6f 74 2e 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 73 65 6e 64 73 20 61	during.boot..This.option.sends.a
fd80	6c 6c 20 63 6f 6d 6d 61 6e 64 73 20 75 73 65 64 20 62 79 20 56 79 4f 53 20 74 6f 20 61 20 66 69	ll.commands.used.by.VyOS.to.a.fi
fda0	6c 65 2e 20 54 68 65 20 64 65 66 61 75 6c 74 20 66 69 6c 65 20 69 73 20 60 60 2f 74 6d 70 2f 66	le..The.default.file.is.``/tmp/f
fdc0	75 6c 6c 2d 6c 6f 67 60 60 20 62 75 74 20 69 74 20 63 61 6e 20 62 65 20 63 68 61 6e 67 65 64 2e	ull-log``.but.it.can.be.changed.
fde0	00 60 60 73 65 74 60 60 00 60 60 76 79 6f 73 2d 62 75 69 6c 64 60 60 20 72 65 70 6f 20 69 73 20	.``set``.``vyos-build``.repo.is.
fe00	6f 75 74 64 61 74 65 64 2c 20 70 6c 65 61 73 65 20 60 60 67 69 74 20 70 75 6c 6c 60 60 20 74 6f	outdated,.please.``git.pull``.to
fe20	20 75 70 64 61 74 65 20 74 6f 20 74 68 65 20 6c 61 74 65 73 74 20 72 65 6c 65 61 73 65 20 6b 65	.update.to.the.latest.release.ke
fe40	72 6e 65 6c 20 76 65 72 73 69 6f 6e 20 66 72 6f 6d 20 75 73 2e 00 60 60 76 79 6f 73 2d 63 6f 6e	rnel.version.from.us..``vyos-con
fe60	66 69 67 2d 64 65 62 75 67 60 60 20 2d 20 44 75 72 69 6e 67 20 64 65 76 65 6c 6f 70 6d 65 6e 74	fig-debug``.-.During.development
fe80	2c 20 63 6f 64 69 6e 67 20 65 72 72 6f 72 73 20 63 61 6e 20 6c 65 61 64 20 74 6f 20 61 20 63 6f	,.coding.errors.can.lead.to.a.co
fea0	6d 6d 69 74 20 66 61 69 6c 75 72 65 20 6f 6e 20 62 6f 6f 74 2c 20 70 6f 73 73 69 62 6c 79 20 72	mmit.failure.on.boot,.possibly.r
fec0	65 73 75 6c 74 69 6e 67 20 69 6e 20 61 20 66 61 69 6c 65 64 20 69 6e 69 74 69 61 6c 69 7a 61 74	esulting.in.a.failed.initializat
fee0	69 6f 6e 20 6f 66 20 74 68 65 20 43 4c 49 2e 20 49 6e 20 74 68 69 73 20 63 69 72 63 75 6d 73 74	ion.of.the.CLI..In.this.circumst
ff00	61 6e 63 65 2c 20 74 68 65 20 6b 65 72 6e 65 6c 20 62 6f 6f 74 20 70 61 72 61 6d 65 74 65 72 20	ance,.the.kernel.boot.parameter.
ff20	60 60 76 79 6f 73 2d 63 6f 6e 66 69 67 2d 64 65 62 75 67 60 60 20 77 69 6c 6c 20 65 6e 73 75 72	``vyos-config-debug``.will.ensur
ff40	65 20 61 63 63 65 73 73 20 74 6f 20 74 68 65 20 73 79 73 74 65 6d 20 61 73 20 75 73 65 72 20 60	e.access.to.the.system.as.user.`
ff60	60 76 79 6f 73 60 60 2c 20 61 6e 64 20 77 69 6c 6c 20 6c 6f 67 20 61 20 50 79 74 68 6f 6e 20 73	`vyos``,.and.will.log.a.Python.s
ff80	74 61 63 6b 20 74 72 61 63 65 20 74 6f 20 74 68 65 20 66 69 6c 65 20 60 60 2f 74 6d 70 2f 62 6f	tack.trace.to.the.file.``/tmp/bo
ffa0	6f 74 2d 63 6f 6e 66 69 67 2d 74 72 61 63 65 60 60 2e 20 46 69 6c 65 20 60 60 62 6f 6f 74 2d 63	ot-config-trace``..File.``boot-c
ffc0	6f 6e 66 69 67 2d 74 72 61 63 65 60 60 20 77 69 6c 6c 20 67 65 6e 65 72 61 74 65 20 6f 6e 6c 79	onfig-trace``.will.generate.only
ffe0	20 69 66 20 63 6f 6e 66 69 67 20 6c 6f 61 64 65 64 20 77 69 74 68 20 61 20 66 61 69 6c 75 72 65	.if.config.loaded.with.a.failure
10000	20 73 74 61 74 75 73 2e 00 60 60 76 79 6f 73 2d 64 65 62 75 67 60 60 20 2d 20 41 64 64 69 6e 67	.status..``vyos-debug``.-.Adding
10020	20 74 68 65 20 70 61 72 61 6d 65 74 65 72 20 74 6f 20 74 68 65 20 6c 69 6e 75 78 20 62 6f 6f 74	.the.parameter.to.the.linux.boot
10040	20 6c 69 6e 65 20 77 69 6c 6c 20 70 72 6f 64 75 63 65 20 74 69 6d 69 6e 67 20 72 65 73 75 6c 74	.line.will.produce.timing.result
10060	73 20 66 6f 72 20 74 68 65 20 65 78 65 63 75 74 69 6f 6e 20 6f 66 20 73 63 72 69 70 74 73 20 64	s.for.the.execution.of.scripts.d
10080	75 72 69 6e 67 20 63 6f 6d 6d 69 74 2e 20 49 66 20 6f 6e 65 20 69 73 20 73 65 65 69 6e 67 20 61	uring.commit..If.one.is.seeing.a
100a0	6e 20 75 6e 65 78 70 65 63 74 65 64 20 64 65 6c 61 79 20 64 75 72 69 6e 67 20 6d 61 6e 75 61 6c	n.unexpected.delay.during.manual
100c0	20 6f 72 20 62 6f 6f 74 20 63 6f 6d 6d 69 74 2c 20 74 68 69 73 20 6d 61 79 20 62 65 20 75 73 65	.or.boot.commit,.this.may.be.use
100e0	66 75 6c 20 69 6e 20 69 64 65 6e 74 69 66 79 69 6e 67 20 62 6f 74 74 6c 65 6e 65 63 6b 73 2e 20	ful.in.identifying.bottlenecks..
10100	54 68 65 20 69 6e 74 65 72 6e 61 6c 20 66 6c 61 67 20 69 73 20 60 60 56 59 4f 53 5f 44 45 42 55	The.internal.flag.is.``VYOS_DEBU
10120	47 60 60 2c 20 61 6e 64 20 69 73 20 66 6f 75 6e 64 20 69 6e 20 76 79 61 74 74 61 2d 63 66 67 5f	G``,.and.is.found.in.vyatta-cfg_
10140	2e 20 4f 75 74 70 75 74 20 69 73 20 64 69 72 65 63 74 65 64 20 74 6f 20 60 60 2f 76 61 72 2f 6c	..Output.is.directed.to.``/var/l
10160	6f 67 2f 76 79 61 74 74 61 2f 63 66 67 2d 73 74 64 6f 75 74 2e 6c 6f 67 60 60 2e 00 60 63 64 20	og/vyatta/cfg-stdout.log``..`cd.
10180	73 72 63 2f 6c 69 62 63 68 61 72 6f 6e 2f 70 6c 75 67 69 6e 73 2f 76 69 63 69 2f 70 79 74 68 6f	src/libcharon/plugins/vici/pytho
101a0	6e 60 00 60 63 64 20 76 79 6f 73 2d 73 74 72 6f 6e 67 73 77 61 6e 60 00 60 6d 61 6b 65 60 00 60	n`.`cd.vyos-strongswan`.`make`.`
101c0	70 79 74 68 6f 6e 33 20 73 65 74 75 70 2e 70 79 20 2d 2d 63 6f 6d 6d 61 6e 64 2d 70 61 63 6b 61	python3.setup.py.--command-packa
101e0	67 65 73 3d 73 74 64 65 62 2e 63 6f 6d 6d 61 6e 64 20 62 64 69 73 74 5f 64 65 62 60 00 61 6c 6c	ges=stdeb.command.bdist_deb`.all
10200	6f 77 65 64 3a 20 2f 70 61 74 68 2f 74 6f 2f 73 63 72 69 70 74 00 61 6c 6c 6f 77 65 64 3a 20 63	owed:./path/to/script.allowed:.c
10220	6c 69 2d 73 68 65 6c 6c 2d 61 70 69 20 6c 69 73 74 4e 6f 64 65 73 20 76 70 6e 20 69 70 73 65 63	li-shell-api.listNodes.vpn.ipsec
10240	20 65 73 70 2d 67 72 6f 75 70 00 61 6c 6c 6f 77 65 64 3a 20 65 63 68 6f 20 66 6f 6f 20 62 61 72	.esp-group.allowed:.echo.foo.bar
10260	00 62 65 67 69 6e 3a 2f 63 72 65 61 74 65 3a 2f 64 65 6c 65 74 65 3a 00 63 6f 6d 6d 69 74 3a 65	.begin:/create:/delete:.commit:e
10280	78 70 72 65 73 73 69 6f 6e 3a 00 63 6f 6e 74 69 6e 65 20 65 78 65 63 75 74 69 6f 6e 20 75 73 69	xpression:.contine.execution.usi
102a0	6e 67 20 60 60 63 6f 6e 74 60 60 00 63 6f 6e 74 69 6e 75 65 20 65 78 65 63 75 74 69 6f 6e 20 75	ng.``cont``.continue.execution.u
102c0	73 69 6e 67 20 60 60 63 6f 6e 74 60 60 00 64 65 66 61 75 6c 74 3a 00 65 78 61 6d 69 6e 65 20 76	sing.``cont``.default:.examine.v
102e0	61 72 69 61 62 6c 65 73 20 75 73 69 6e 67 20 60 60 70 70 28 76 61 72 29 60 60 00 67 65 74 20 61	ariables.using.``pp(var)``.get.a
10300	20 62 61 63 6b 74 72 61 63 65 20 75 73 69 6e 67 20 60 60 62 74 60 60 00 68 65 6c 70 3a 20 4d 79	.backtrace.using.``bt``.help:.My
10320	20 6e 6f 64 65 00 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 76 79 6f 73 2f 76 79	.node.https://github.com/vyos/vy
10340	61 74 74 61 2d 63 66 67 2f 62 6c 6f 62 2f 30 66 34 32 37 38 36 61 30 62 33 2f 73 72 63 2f 63 6f	atta-cfg/blob/0f42786a0b3/src/co
10360	6d 6d 69 74 2f 63 6f 6d 6d 69 74 2d 61 6c 67 6f 72 69 74 68 6d 2e 63 70 70 23 4c 31 32 35 32 00	mmit/commit-algorithm.cpp#L1252.
10380	68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 76 79 6f 73 2f 76 79 61 74 74 61 2d 63	https://github.com/vyos/vyatta-c
103a0	66 67 2f 62 6c 6f 62 2f 30 66 34 32 37 38 36 61 30 62 33 2f 73 72 63 2f 63 73 74 6f 72 65 2f 63	fg/blob/0f42786a0b3/src/cstore/c
103c0	73 74 6f 72 65 2e 63 70 70 23 4c 32 35 34 39 00 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63	store.cpp#L2549.https://github.c
103e0	6f 6d 2f 76 79 6f 73 2f 76 79 61 74 74 61 2d 63 66 67 2f 62 6c 6f 62 2f 30 66 34 32 37 38 36 61	om/vyos/vyatta-cfg/blob/0f42786a
10400	30 62 33 2f 73 72 63 2f 63 73 74 6f 72 65 2f 63 73 74 6f 72 65 2e 63 70 70 23 4c 33 35 32 00 68	0b3/src/cstore/cstore.cpp#L352.h
10420	76 69 6e 66 6f 00 6b 65 65 70 61 6c 69 76 65 64 00 6d 64 6e 73 2d 72 65 70 65 61 74 65 72 00 6d	vinfo.keepalived.mdns-repeater.m
10440	75 6c 74 69 3a 00 6d 79 6e 6f 64 65 2f 6e 6f 64 65 2e 64 65 66 00 6d 79 6e 6f 64 65 2f 6e 6f 64	ulti:.mynode/node.def.mynode/nod
10460	65 2e 74 61 67 20 2c 20 74 61 67 3a 00 70 72 69 6f 72 69 74 79 3a 20 39 39 39 00 73 74 72 6f 6e	e.tag.,.tag:.priority:.999.stron
10480	67 73 77 61 6e 00 73 74 72 6f 6e 67 73 77 61 6e 2d 6e 6d 20 70 61 63 6b 61 67 65 20 62 75 69 6c	gswan.strongswan-nm.package.buil
104a0	64 20 69 73 20 64 69 73 61 62 6c 65 64 20 73 69 6e 63 65 20 77 65 20 64 6f 6e 27 74 20 75 73 65	d.is.disabled.since.we.don't.use
104c0	20 4e 65 74 77 6f 72 6b 4d 61 6e 61 67 65 72 00 73 79 6e 74 61 78 3a 65 78 70 72 65 73 73 69 6f	.NetworkManager.syntax:expressio
104e0	6e 3a 20 24 56 41 52 28 40 29 20 69 6e 20 22 66 6f 6f 22 2c 20 22 62 61 72 22 2c 20 22 62 61 7a	n:.$VAR(@).in."foo",."bar",."baz
10500	22 00 73 79 6e 74 61 78 3a 65 78 70 72 65 73 73 69 6f 6e 3a 20 28 61 72 69 74 68 6d 65 74 69 63	".syntax:expression:.(arithmetic
10520	20 65 78 70 72 65 73 73 69 6f 6e 29 00 73 79 6e 74 61 78 3a 65 78 70 72 65 73 73 69 6f 6e 3a 20	.expression).syntax:expression:.
10540	65 78 65 63 20 2e 2e 2e 00 73 79 6e 74 61 78 3a 65 78 70 72 65 73 73 69 6f 6e 3a 20 70 61 74 74	exec.....syntax:expression:.patt
10560	65 72 6e 00 75 64 70 2d 62 72 6f 61 64 63 61 73 74 2d 72 65 6c 61 79 00 76 61 6c 5f 68 65 6c 70	ern.udp-broadcast-relay.val_help
10580	3a 20 3c 66 6f 72 6d 61 74 3e 3b 20 73 6f 6d 65 20 73 74 72 69 6e 67 00 76 79 6f 73 2d 6e 65 74	:.<format>;.some.string.vyos-net
105a0	70 6c 75 67 00 4d 49 4d 45 2d 56 65 72 73 69 6f 6e 3a 20 31 2e 30 0a 43 6f 6e 74 65 6e 74 2d 54	plug.MIME-Version:.1.0.Content-T
105c0	79 70 65 3a 20 74 65 78 74 2f 70 6c 61 69 6e 3b 20 63 68 61 72 73 65 74 3d 55 54 46 2d 38 0a 43	ype:.text/plain;.charset=UTF-8.C
105e0	6f 6e 74 65 6e 74 2d 54 72 61 6e 73 66 65 72 2d 45 6e 63 6f 64 69 6e 67 3a 20 38 62 69 74 0a 58	ontent-Transfer-Encoding:.8bit.X
10600	2d 47 65 6e 65 72 61 74 6f 72 3a 20 4c 6f 63 61 6c 61 7a 79 20 28 68 74 74 70 73 3a 2f 2f 6c 6f	-Generator:.Localazy.(https://lo
10620	63 61 6c 61 7a 79 2e 63 6f 6d 29 0a 50 72 6f 6a 65 63 74 2d 49 64 2d 56 65 72 73 69 6f 6e 3a 20	calazy.com).Project-Id-Version:.
10640	0a 4c 61 6e 67 75 61 67 65 3a 20 70 74 0a 50 6c 75 72 61 6c 2d 46 6f 72 6d 73 3a 20 6e 70 6c 75	.Language:.pt.Plural-Forms:.nplu
10660	72 61 6c 73 3d 32 3b 20 70 6c 75 72 61 6c 3d 28 6e 3e 3d 30 20 26 26 20 6e 3c 3d 31 29 20 3f 20	rals=2;.plural=(n>=0.&&.n<=1).?.
10680	30 20 3a 20 31 3b 0a 00 22 24 7b 76 79 6f 73 5f 6c 69 62 65 78 65 63 64 69 72 7d 2f 76 61 6c 69	0.:.1;.."${vyos_libexecdir}/vali
106a0	64 61 74 6f 72 73 2f 66 6f 6f 20 62 61 72 20 24 56 41 52 28 40 29 22 20 77 69 6c 6c 20 62 65 20	dators/foo.bar.$VAR(@)".will.be.
106c0	65 78 65 63 75 74 65 64 2c 20 3c 63 6f 6e 73 74 72 61 69 6e 74 45 72 72 6f 72 4d 65 73 73 61 67	executed,.<constraintErrorMessag
106e0	65 3e 20 77 69 6c 6c 20 62 65 20 64 69 73 70 6c 61 79 65 64 20 6f 6e 20 66 61 69 6c 75 72 65 00	e>.will.be.displayed.on.failure.
10700	2e 2e 2e 00 3c 63 6f 6e 73 74 72 61 69 6e 74 45 72 72 6f 72 4d 65 73 73 61 67 65 3e 20 77 69 6c	....<constraintErrorMessage>.wil
10720	6c 20 62 65 20 64 69 73 70 6c 61 79 65 64 20 6f 6e 20 66 61 69 6c 75 72 65 00 3c 6e 6f 64 65 20	l.be.displayed.on.failure.<node.
10740	6e 61 6d 65 3d 22 6d 79 6e 6f 64 65 22 3e 20 3c 2f 6e 6f 64 65 3e 00 3c 70 72 6f 70 65 72 74 69	name="mynode">.</node>.<properti
10760	65 73 3e 20 3c 63 6f 6d 70 6c 65 74 69 6f 6e 48 65 6c 70 3e 20 3c 6c 69 73 74 3e 20 66 6f 6f 20	es>.<completionHelp>.<list>.foo.
10780	62 61 72 20 3c 2f 6c 69 73 74 3e 00 3c 70 72 6f 70 65 72 74 69 65 73 3e 20 3c 63 6f 6d 70 6c 65	bar.</list>.<properties>.<comple
107a0	74 69 6f 6e 48 65 6c 70 3e 20 3c 70 61 74 68 3e 20 76 70 6e 20 69 70 73 65 63 20 65 73 70 2d 67	tionHelp>.<path>.vpn.ipsec.esp-g
107c0	72 6f 75 70 20 3c 2f 70 61 74 68 3e 20 2e 2e 2e 00 3c 70 72 6f 70 65 72 74 69 65 73 3e 20 3c 63	roup.</path>.....<properties>.<c
107e0	6f 6d 70 6c 65 74 69 6f 6e 48 65 6c 70 3e 20 3c 73 63 72 69 70 74 3e 20 2f 70 61 74 68 2f 74 6f	ompletionHelp>.<script>./path/to
10800	2f 73 63 72 69 70 74 20 3c 2f 73 63 72 69 70 74 3e 20 2e 2e 2e 00 3c 70 72 6f 70 65 72 74 69 65	/script.</script>.....<propertie
10820	73 3e 20 3c 63 6f 6e 73 74 72 61 69 6e 74 3e 20 3c 72 65 67 65 78 3e 20 2e 2e 2e 00 3c 70 72 6f	s>.<constraint>.<regex>.....<pro
10840	70 65 72 74 69 65 73 3e 20 3c 63 6f 6e 73 74 72 61 69 6e 74 3e 20 3c 76 61 6c 69 64 61 74 6f 72	perties>.<constraint>.<validator
10860	3e 20 3c 6e 61 6d 65 20 3d 22 66 6f 6f 22 20 61 72 67 75 6d 65 6e 74 3d 22 62 61 72 22 3e 00 3c	>.<name.="foo".argument="bar">.<
10880	70 72 6f 70 65 72 74 69 65 73 3e 20 3c 68 65 6c 70 3e 4d 79 20 6e 6f 64 65 3c 2f 68 65 6c 70 3e	properties>.<help>My.node</help>
108a0	00 3c 70 72 6f 70 65 72 74 69 65 73 3e 20 3c 6d 75 6c 74 69 2f 3e 00 3c 70 72 6f 70 65 72 74 69	.<properties>.<multi/>.<properti
108c0	65 73 3e 20 3c 70 72 69 6f 72 69 74 79 3e 39 39 39 3c 2f 70 72 69 6f 72 69 74 79 3e 00 3c 70 72	es>.<priority>999</priority>.<pr
108e0	6f 70 65 72 74 69 65 73 3e 20 3c 76 61 6c 75 65 48 65 6c 70 3e 20 3c 66 6f 72 6d 61 74 3e 20 66	operties>.<valueHelp>.<format>.f
10900	6f 72 6d 61 74 20 3c 2f 66 6f 72 6d 61 74 3e 20 3c 64 65 73 63 72 69 70 74 69 6f 6e 3e 20 73 6f	ormat.</format>.<description>.so
10920	6d 65 20 73 74 72 69 6e 67 20 3c 2f 64 65 73 63 72 69 70 74 69 6f 6e 3e 00 3c 74 61 67 4e 6f 64	me.string.</description>.<tagNod
10940	65 20 6e 61 6d 65 3d 22 6d 79 6e 6f 64 65 3e 20 3c 2f 6e 6f 64 65 3e 00 41 20 66 6f 72 6b 20 77	e.name="mynode>.</node>.A.fork.w
10960	69 74 68 20 70 61 63 6b 61 67 69 6e 67 20 63 68 61 6e 67 65 73 20 66 6f 72 20 56 79 4f 53 20 69	ith.packaging.changes.for.VyOS.i
10980	73 20 6b 65 70 74 20 61 74 20 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 76 79 6f	s.kept.at.https://github.com/vyo
109a0	73 2f 68 76 69 6e 66 6f 00 41 20 67 6f 6f 64 20 61 70 70 72 6f 61 63 68 20 66 6f 72 20 77 72 69	s/hvinfo.A.good.approach.for.wri
109c0	74 69 6e 67 20 63 6f 6d 6d 69 74 20 6d 65 73 73 61 67 65 73 20 69 73 20 61 63 74 75 61 6c 6c 79	ting.commit.messages.is.actually
109e0	20 74 6f 20 68 61 76 65 20 61 20 6c 6f 6f 6b 20 61 74 20 74 68 65 20 66 69 6c 65 28 73 29 20 68	.to.have.a.look.at.the.file(s).h
10a00	69 73 74 6f 72 79 20 62 79 20 69 6e 76 6f 6b 69 6e 67 20 60 60 67 69 74 20 6c 6f 67 20 70 61 74	istory.by.invoking.``git.log.pat
10a20	68 2f 74 6f 2f 66 69 6c 65 2e 74 78 74 60 60 2e 00 41 20 6e 75 6d 62 65 72 20 6f 66 20 66 6c 61	h/to/file.txt``..A.number.of.fla
10a40	67 73 20 63 61 6e 20 62 65 20 73 65 74 20 75 70 20 74 6f 20 63 68 61 6e 67 65 20 74 68 65 20 62	gs.can.be.set.up.to.change.the.b
10a60	65 68 61 76 69 6f 75 72 20 6f 66 20 56 79 4f 53 20 61 74 20 72 75 6e 74 69 6d 65 2e 20 54 68 65	ehaviour.of.VyOS.at.runtime..The
10a80	73 65 20 66 6c 61 67 73 20 63 61 6e 20 62 65 20 74 6f 67 67 6c 65 64 20 75 73 69 6e 67 20 65 69	se.flags.can.be.toggled.using.ei
10aa0	74 68 65 72 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 76 61 72 69 61 62 6c 65 73 20 6f 72 20 63 72	ther.environment.variables.or.cr
10ac0	65 61 74 69 6e 67 20 66 69 6c 65 73 2e 00 41 20 72 65 61 73 6f 6e 61 62 6c 79 20 64 65 74 61 69	eating.files..A.reasonably.detai
10ae0	6c 65 64 20 64 65 73 63 72 69 70 74 69 6f 6e 20 6f 66 20 74 68 65 20 66 65 61 74 75 72 65 3a 20	led.description.of.the.feature:.
10b00	77 68 61 74 20 69 74 20 69 73 2c 20 68 6f 77 20 69 74 27 73 20 73 75 70 70 6f 73 65 64 20 74 6f	what.it.is,.how.it's.supposed.to
10b20	20 77 6f 72 6b 2c 20 61 6e 64 20 68 6f 77 20 79 6f 75 27 64 20 75 73 65 20 69 74 2e 20 54 68 65	.work,.and.how.you'd.use.it..The
10b40	20 6d 61 69 6e 74 61 69 6e 65 72 73 20 61 72 65 6e 27 74 20 66 61 6d 69 6c 69 61 72 20 77 69 74	.maintainers.aren't.familiar.wit
10b60	68 20 65 76 65 72 79 20 66 65 61 74 75 72 65 20 6f 66 20 65 76 65 72 79 20 70 72 6f 74 6f 63 6f	h.every.feature.of.every.protoco
10b80	6c 20 61 6e 64 20 74 6f 6f 6c 2c 20 61 6e 64 20 63 6f 6d 6d 75 6e 69 74 79 20 63 6f 6e 74 72 69	l.and.tool,.and.community.contri
10ba0	62 75 74 6f 72 73 20 77 68 6f 20 61 72 65 20 6c 6f 6f 6b 69 6e 67 20 66 6f 72 20 74 61 73 6b 73	butors.who.are.looking.for.tasks
10bc0	20 74 6f 20 77 6f 72 6b 20 6f 6e 20 77 69 6c 6c 20 61 6c 73 6f 20 61 70 70 72 65 63 69 61 74 65	.to.work.on.will.also.appreciate
10be0	20 6d 6f 72 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 74 68 61 74 20 68 65 6c 70 73 20 74 68 65	.more.information.that.helps.the
10c00	6d 20 69 6d 70 6c 65 6d 65 6e 74 20 61 6e 64 20 74 65 73 74 20 61 20 66 65 61 74 75 72 65 2e 00	m.implement.and.test.a.feature..
10c20	41 20 73 65 71 75 65 6e 63 65 20 6f 66 20 61 63 74 69 6f 6e 73 20 74 68 61 74 20 74 72 69 67 67	A.sequence.of.actions.that.trigg
10c40	65 72 73 20 74 68 65 20 62 75 67 2e 20 57 65 20 75 6e 64 65 72 73 74 61 6e 64 20 74 68 61 74 20	ers.the.bug..We.understand.that.
10c60	69 74 27 73 20 6e 6f 74 20 61 6c 77 61 79 73 20 70 6f 73 73 69 62 6c 65 2c 20 62 75 74 20 69 74	it's.not.always.possible,.but.it
10c80	20 6d 61 6b 65 73 20 64 65 76 65 6c 6f 70 65 72 27 73 20 6a 6f 62 20 61 20 6c 6f 74 20 65 61 73	.makes.developer's.job.a.lot.eas
10ca0	69 65 72 20 61 6e 64 20 61 6c 73 6f 20 61 6c 6c 6f 77 73 20 61 6e 79 20 63 6f 6d 6d 75 6e 69 74	ier.and.also.allows.any.communit
10cc0	79 20 6d 65 6d 62 65 72 20 74 6f 20 69 6e 64 65 70 65 6e 64 65 6e 74 6c 79 20 63 6f 6e 66 69 72	y.member.to.independently.confir
10ce0	6d 20 74 68 61 74 20 74 68 65 20 62 75 67 20 73 74 69 6c 6c 20 65 78 69 73 74 73 20 6f 72 20 69	m.that.the.bug.still.exists.or.i
10d00	66 20 69 74 27 73 20 61 6c 72 65 61 64 79 20 66 69 78 65 64 2e 00 41 20 73 65 71 75 65 6e 63 65	f.it's.already.fixed..A.sequence
10d20	20 6f 66 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 63 6f 6d 6d 61 6e 64 73 20 6f 72 20 61 20	.of.configuration.commands.or.a.
10d40	63 6f 6d 70 6c 65 74 65 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 66 69 6c 65 20 72 65 71 75	complete.configuration.file.requ
10d60	69 72 65 64 20 74 6f 20 72 65 63 72 65 61 74 65 20 61 20 73 65 74 75 70 20 77 68 65 72 65 20 74	ired.to.recreate.a.setup.where.t
10d80	68 65 20 62 75 67 20 6f 63 63 75 72 73 2e 20 50 6c 65 61 73 65 20 61 76 6f 69 64 20 70 61 72 74	he.bug.occurs..Please.avoid.part
10da0	69 61 6c 20 63 6f 6e 66 69 67 73 3a 20 61 20 73 65 71 75 65 6e 63 65 20 6f 66 20 63 6f 6d 6d 61	ial.configs:.a.sequence.of.comma
10dc0	6e 64 73 20 69 73 20 65 61 73 79 20 74 6f 20 70 61 73 74 65 20 69 6e 74 6f 20 74 68 65 20 63 6f	nds.is.easy.to.paste.into.the.co
10de0	6e 73 6f 6c 65 2c 20 61 20 63 6f 6d 70 6c 65 74 65 20 63 6f 6e 66 69 67 20 69 73 20 65 61 73 79	nsole,.a.complete.config.is.easy
10e00	20 74 6f 20 6c 6f 61 64 20 69 6e 20 61 20 56 4d 2c 20 62 75 74 20 61 20 70 61 72 74 69 61 6c 20	.to.load.in.a.VM,.but.a.partial.
10e20	63 6f 6e 66 69 67 20 69 73 20 6e 65 69 74 68 65 72 21 20 41 74 20 6c 65 61 73 74 20 6e 6f 74 20	config.is.neither!.At.least.not.
10e40	75 6e 74 69 6c 20 77 65 20 69 6d 70 6c 65 6d 65 6e 74 20 61 20 22 6d 65 72 67 65 20 66 72 6f 6d	until.we.implement.a."merge.from
10e60	20 74 68 65 20 43 4c 49 22 20 66 65 61 74 75 72 65 20 74 68 61 74 20 61 6c 6c 6f 77 73 20 70 61	.the.CLI".feature.that.allows.pa
10e80	73 74 69 6e 67 20 63 6f 6e 66 69 67 20 66 69 6c 65 20 63 68 75 6e 6b 73 20 69 6e 74 6f 20 61 20	sting.config.file.chunks.into.a.
10ea0	73 65 73 73 69 6f 6e 2e 00 41 20 73 69 6e 67 6c 65 2c 20 73 68 6f 72 74 2c 20 73 75 6d 6d 61 72	session..A.single,.short,.summar
10ec0	79 20 6f 66 20 74 68 65 20 63 6f 6d 6d 69 74 20 28 72 65 63 6f 6d 6d 65 6e 64 65 64 20 35 30 20	y.of.the.commit.(recommended.50.
10ee0	63 68 61 72 61 63 74 65 72 73 20 6f 72 20 6c 65 73 73 2c 20 6e 6f 74 20 65 78 63 65 65 64 69 6e	characters.or.less,.not.exceedin
10f00	67 20 38 30 20 63 68 61 72 61 63 74 65 72 73 29 20 63 6f 6e 74 61 69 6e 69 6e 67 20 61 20 70 72	g.80.characters).containing.a.pr
10f20	65 66 69 78 20 6f 66 20 74 68 65 20 63 68 61 6e 67 65 64 20 63 6f 6d 70 6f 6e 65 6e 74 20 61 6e	efix.of.the.changed.component.an
10f40	64 20 74 68 65 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 50 68 61 62 72 69 63 61 74 6f 72 5f	d.the.corresponding.Phabricator_
10f60	20 72 65 66 65 72 65 6e 63 65 20 65 2e 67 2e 20 60 60 73 6e 6d 70 3a 20 54 31 31 31 31 3a 60 60	.reference.e.g..``snmp:.T1111:``
10f80	20 6f 72 20 60 60 65 74 68 65 72 6e 65 74 3a 20 54 32 32 32 32 3a 60 60 20 2d 20 6d 75 6c 74 69	.or.``ethernet:.T2222:``.-.multi
10fa0	70 6c 65 20 63 6f 6d 70 6f 6e 65 6e 74 73 20 63 6f 75 6c 64 20 62 65 20 63 6f 6e 63 61 74 65 6e	ple.components.could.be.concaten
10fc0	61 74 65 64 20 61 73 20 69 6e 20 60 60 73 6e 6d 70 3a 20 65 74 68 65 72 6e 65 74 3a 20 54 33 33	ated.as.in.``snmp:.ethernet:.T33
10fe0	33 33 60 60 00 41 62 62 72 65 76 69 61 74 69 6f 6e 73 20 61 6e 64 20 61 63 72 6f 6e 79 6d 73 20	33``.Abbreviations.and.acronyms.
11000	2a 2a 6d 75 73 74 2a 2a 20 62 65 20 63 61 70 69 74 61 6c 69 7a 65 64 2e 00 41 63 63 65 6c 2d 50	**must**.be.capitalized..Accel-P
11020	50 50 00 41 63 72 6f 6e 79 6d 73 20 61 6c 73 6f 20 2a 2a 6d 75 73 74 2a 2a 20 62 65 20 63 61 70	PP.Acronyms.also.**must**.be.cap
11040	69 74 61 6c 69 7a 65 64 20 74 6f 20 76 69 73 75 61 6c 6c 79 20 64 69 73 74 69 6e 67 75 69 73 68	italized.to.visually.distinguish
11060	20 74 68 65 6d 20 66 72 6f 6d 20 6e 6f 72 6d 61 6c 20 77 6f 72 64 73 3a 00 41 64 64 20 66 69 6c	.them.from.normal.words:.Add.fil
11080	65 20 74 6f 20 47 69 74 20 69 6e 64 65 78 20 75 73 69 6e 67 20 60 60 67 69 74 20 61 64 64 20 6d	e.to.Git.index.using.``git.add.m
110a0	79 66 69 6c 65 60 60 2c 20 6f 72 20 66 6f 72 20 61 20 77 68 6f 6c 65 20 64 69 72 65 63 74 6f 72	yfile``,.or.for.a.whole.director
110c0	79 3a 20 60 60 67 69 74 20 61 64 64 20 73 6f 6d 65 64 69 72 2f 2a 60 60 00 41 64 64 20 6f 6e 65	y:.``git.add.somedir/*``.Add.one
110e0	20 6f 72 20 6d 6f 72 65 20 49 50 20 61 64 64 72 65 73 73 65 73 00 41 64 64 72 65 73 73 00 41 66	.or.more.IP.addresses.Address.Af
11100	74 65 72 20 61 20 6d 69 6e 75 74 65 20 6f 72 20 74 77 6f 20 79 6f 75 20 77 69 6c 6c 20 66 69 6e	ter.a.minute.or.two.you.will.fin
11120	64 20 74 68 65 20 67 65 6e 65 72 61 74 65 64 20 44 45 42 20 70 61 63 6b 61 67 65 73 20 6e 65 78	d.the.generated.DEB.packages.nex
11140	74 20 74 6f 20 74 68 65 20 76 79 6f 73 2d 31 78 20 73 6f 75 72 63 65 20 64 69 72 65 63 74 6f 72	t.to.the.vyos-1x.source.director
11160	79 3a 00 41 66 74 65 72 20 63 6f 6d 70 69 6c 69 6e 67 20 74 68 65 20 70 61 63 6b 61 67 65 73 20	y:.After.compiling.the.packages.
11180	79 6f 75 20 77 69 6c 6c 20 66 69 6e 64 20 79 6f 75 72 73 65 6c 66 20 74 68 65 20 6e 65 77 6c 79	you.will.find.yourself.the.newly
111a0	20 67 65 6e 65 72 61 74 65 64 20 60 2a 2e 64 65 62 60 20 62 69 6e 61 72 69 65 73 20 69 6e 20 60	.generated.`*.deb`.binaries.in.`
111c0	60 76 79 6f 73 2d 62 75 69 6c 64 2f 70 61 63 6b 61 67 65 73 2f 6c 69 6e 75 78 2d 6b 65 72 6e 65	`vyos-build/packages/linux-kerne
111e0	6c 60 60 20 66 72 6f 6d 20 77 68 69 63 68 20 79 6f 75 20 63 61 6e 20 63 6f 70 79 20 74 68 65 6d	l``.from.which.you.can.copy.them
11200	20 74 6f 20 74 68 65 20 60 60 76 79 6f 73 2d 62 75 69 6c 64 2f 70 61 63 6b 61 67 65 73 60 60 20	.to.the.``vyos-build/packages``.
11220	66 6f 6c 64 65 72 20 66 6f 72 20 69 6e 63 6c 75 73 69 6f 6e 20 64 75 72 69 6e 67 20 74 68 65 20	folder.for.inclusion.during.the.
11240	49 53 4f 20 62 75 69 6c 64 2e 00 41 66 74 65 72 20 69 74 73 20 66 69 72 73 74 20 62 6f 6f 74 20	ISO.build..After.its.first.boot.
11260	69 6e 74 6f 20 74 68 65 20 6e 65 77 6c 79 20 69 6e 73 74 61 6c 6c 65 64 20 73 79 73 74 65 6d 20	into.the.newly.installed.system.
11280	74 68 65 20 6d 61 69 6e 20 53 6d 6f 6b 65 74 65 73 74 20 73 63 72 69 70 74 20 69 73 20 65 78 65	the.main.Smoketest.script.is.exe
112a0	63 75 74 65 64 2c 20 69 74 20 63 61 6e 20 62 65 20 66 6f 75 6e 64 20 68 65 72 65 3a 20 60 2f 75	cuted,.it.can.be.found.here:.`/u
112c0	73 72 2f 62 69 6e 2f 76 79 6f 73 2d 73 6d 6f 6b 65 74 65 73 74 60 00 41 6c 6c 20 56 79 4f 53 20	sr/bin/vyos-smoketest`.All.VyOS.
112e0	73 6f 75 72 63 65 20 63 6f 64 65 20 69 73 20 68 6f 73 74 65 64 20 6f 6e 20 47 69 74 48 75 62 20	source.code.is.hosted.on.GitHub.
11300	75 6e 64 65 72 20 74 68 65 20 56 79 4f 53 20 6f 72 67 61 6e 69 7a 61 74 69 6f 6e 20 77 68 69 63	under.the.VyOS.organization.whic
11320	68 20 63 61 6e 20 62 65 20 66 6f 75 6e 64 20 68 65 72 65 3a 20 68 74 74 70 73 3a 2f 2f 67 69 74	h.can.be.found.here:.https://git
11340	68 75 62 2e 63 6f 6d 2f 76 79 6f 73 00 41 6c 6c 20 63 6f 6d 6d 69 74 20 74 69 6d 65 20 63 68 65	hub.com/vyos.All.commit.time.che
11360	63 6b 73 20 73 68 6f 75 6c 64 20 62 65 20 69 6e 20 74 68 65 20 76 65 72 69 66 79 28 29 20 66 75	cks.should.be.in.the.verify().fu
11380	6e 63 74 69 6f 6e 20 6f 66 20 74 68 65 20 73 63 72 69 70 74 00 41 6c 6c 20 69 6e 74 65 72 66 61	nction.of.the.script.All.interfa
113a0	63 65 20 64 65 66 69 6e 69 74 69 6f 6e 20 58 4d 4c 20 69 6e 70 75 74 20 66 69 6c 65 73 20 28 2e	ce.definition.XML.input.files.(.
113c0	69 6e 20 73 75 66 66 69 78 29 20 77 69 6c 6c 20 62 65 20 73 65 6e 74 20 74 6f 20 74 68 65 20 47	in.suffix).will.be.sent.to.the.G
113e0	43 43 20 70 72 65 70 72 6f 63 65 73 73 20 61 6e 64 20 74 68 65 20 6f 75 74 70 75 74 20 69 73 20	CC.preprocess.and.the.output.is.
11400	73 74 6f 72 65 64 20 69 6e 20 74 68 65 20 60 62 75 69 6c 64 2f 69 6e 74 65 72 66 61 63 65 2d 64	stored.in.the.`build/interface-d
11420	65 66 69 6e 69 74 69 6f 6e 73 60 20 66 6f 6c 64 65 72 2e 20 54 68 65 20 70 72 65 76 69 6f 75 73	efinitions`.folder..The.previous
11440	6c 79 20 6d 65 6e 74 69 6f 6e 65 64 20 60 73 63 72 69 70 74 73 2f 62 75 69 6c 64 2d 63 6f 6d 6d	ly.mentioned.`scripts/build-comm
11460	61 6e 64 2d 74 65 6d 70 6c 61 74 65 73 60 20 73 63 72 69 70 74 20 6f 70 65 72 61 74 65 73 20 6f	and-templates`.script.operates.o
11480	6e 20 74 68 65 20 60 62 75 69 6c 64 2f 69 6e 74 65 72 66 61 63 65 2d 64 65 66 69 6e 69 74 69 6f	n.the.`build/interface-definitio
114a0	6e 73 60 20 66 6f 6c 64 65 72 20 74 6f 20 67 65 6e 65 72 61 74 65 20 61 6c 6c 20 72 65 71 75 69	ns`.folder.to.generate.all.requi
114c0	72 65 64 20 43 4c 49 20 6e 6f 64 65 73 2e 00 41 6c 6c 20 69 73 73 75 65 73 20 73 68 6f 75 6c 64	red.CLI.nodes..All.issues.should
114e0	20 62 65 20 72 65 70 6f 72 74 65 64 20 74 6f 20 74 68 65 20 64 65 76 65 6c 6f 70 65 72 73 2e 20	.be.reported.to.the.developers..
11500	54 68 69 73 20 6c 65 74 73 20 74 68 65 20 64 65 76 65 6c 6f 70 65 72 73 20 6b 6e 6f 77 20 77 68	This.lets.the.developers.know.wh
11520	61 74 20 69 73 20 6e 6f 74 20 77 6f 72 6b 69 6e 67 20 70 72 6f 70 65 72 6c 79 2e 20 57 69 74 68	at.is.not.working.properly..With
11540	6f 75 74 20 74 68 69 73 20 73 6f 72 74 20 6f 66 20 66 65 65 64 62 61 63 6b 20 65 76 65 72 79 20	out.this.sort.of.feedback.every.
11560	64 65 76 65 6c 6f 70 65 72 20 77 69 6c 6c 20 62 65 6c 69 65 76 65 20 74 68 61 74 20 65 76 65 72	developer.will.believe.that.ever
11580	79 74 68 69 6e 67 20 69 73 20 77 6f 72 6b 69 6e 67 20 63 6f 72 72 65 63 74 6c 79 2e 00 41 6c 6c	ything.is.working.correctly..All
115a0	20 6c 6f 67 69 63 20 73 68 6f 75 6c 64 20 62 65 20 69 6e 20 74 68 65 20 73 63 72 69 70 74 73 00	.logic.should.be.in.the.scripts.
115c0	41 6c 6c 20 74 65 78 74 20 6f 66 20 74 68 65 20 63 6f 6d 6d 69 74 20 6d 65 73 73 61 67 65 20 73	All.text.of.the.commit.message.s
115e0	68 6f 75 6c 64 20 62 65 20 77 72 61 70 70 65 64 20 61 74 20 37 32 20 63 68 61 72 61 63 74 65 72	hould.be.wrapped.at.72.character
11600	73 20 69 66 20 70 6f 73 73 69 62 6c 65 20 77 68 69 63 68 20 6d 61 6b 65 73 20 72 65 61 64 69 6e	s.if.possible.which.makes.readin
11620	67 20 63 6f 6d 6d 69 74 20 6c 6f 67 73 20 65 61 73 69 65 72 20 77 69 74 68 20 60 60 67 69 74 20	g.commit.logs.easier.with.``git.
11640	6c 6f 67 60 60 20 6f 6e 20 61 20 73 74 61 6e 64 61 72 64 20 74 65 72 6d 69 6e 61 6c 20 28 77 68	log``.on.a.standard.terminal.(wh
11660	69 63 68 20 68 61 70 70 65 6e 73 20 74 6f 20 62 65 20 38 30 78 32 35 29 00 41 6c 77 61 79 73 20	ich.happens.to.be.80x25).Always.
11680	75 73 65 20 74 68 65 20 60 60 2d 78 60 60 20 6f 70 74 69 6f 6e 20 74 6f 20 74 68 65 20 60 60 67	use.the.``-x``.option.to.the.``g
116a0	69 74 20 63 68 65 72 72 79 2d 70 69 63 6b 60 60 20 63 6f 6d 6d 61 6e 64 20 77 68 65 6e 20 62 61	it.cherry-pick``.command.when.ba
116c0	63 6b 20 6f 72 20 66 6f 72 77 61 72 64 20 70 6f 72 74 69 6e 67 20 61 6e 20 69 6e 64 69 76 69 64	ck.or.forward.porting.an.individ
116e0	75 61 6c 20 63 6f 6d 6d 69 74 2e 20 54 68 69 73 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 61	ual.commit..This.automatically.a
11700	70 70 65 6e 64 73 20 74 68 65 20 6c 69 6e 65 3a 20 60 60 28 63 68 65 72 72 79 20 70 69 63 6b 65	ppends.the.line:.``(cherry.picke
11720	64 20 66 72 6f 6d 20 63 6f 6d 6d 69 74 20 3c 49 44 3e 29 60 60 20 74 6f 20 74 68 65 20 6f 72 69	d.from.commit.<ID>)``.to.the.ori
11740	67 69 6e 61 6c 20 61 75 74 68 6f 72 73 20 63 6f 6d 6d 69 74 20 6d 65 73 73 61 67 65 20 6d 61 6b	ginal.authors.commit.message.mak
11760	69 6e 67 20 69 74 20 65 61 73 69 65 72 20 77 68 65 6e 20 62 69 73 65 63 74 69 6e 67 20 70 72 6f	ing.it.easier.when.bisecting.pro
11780	62 6c 65 6d 73 2e 00 41 6e 6f 74 68 65 72 20 61 64 76 61 6e 74 61 67 65 20 69 73 20 74 65 73 74	blems..Another.advantage.is.test
117a0	61 62 69 6c 69 74 79 20 6f 66 20 74 68 65 20 63 6f 64 65 2e 20 4d 6f 63 6b 69 6e 67 20 74 68 65	ability.of.the.code..Mocking.the
117c0	20 65 6e 74 69 72 65 20 63 6f 6e 66 69 67 20 73 75 62 73 79 73 74 65 6d 20 69 73 20 68 61 72 64	.entire.config.subsystem.is.hard
117e0	2c 20 77 68 69 6c 65 20 63 6f 6e 73 74 72 75 63 74 69 6e 67 20 61 6e 20 69 6e 74 65 72 6e 61 6c	,.while.constructing.an.internal
11800	20 72 65 70 72 65 73 65 6e 74 61 74 69 6f 6e 20 62 79 20 68 61 6e 64 20 69 73 20 77 61 79 20 73	.representation.by.hand.is.way.s
11820	69 6d 70 6c 65 72 2e 00 41 6e 79 20 22 6d 6f 64 69 66 69 65 64 22 20 70 61 63 6b 61 67 65 20 6d	impler..Any."modified".package.m
11840	61 79 20 72 65 66 65 72 20 74 6f 20 61 6e 20 61 6c 74 65 72 65 64 20 76 65 72 73 69 6f 6e 20 6f	ay.refer.to.an.altered.version.o
11860	66 20 65 2e 67 2e 20 76 79 6f 73 2d 31 78 20 70 61 63 6b 61 67 65 20 74 68 61 74 20 79 6f 75 20	f.e.g..vyos-1x.package.that.you.
11880	77 6f 75 6c 64 20 6c 69 6b 65 20 74 6f 20 74 65 73 74 20 62 65 66 6f 72 65 20 66 69 6c 69 6e 67	would.like.to.test.before.filing
118a0	20 61 20 70 75 6c 6c 20 72 65 71 75 65 73 74 20 6f 6e 20 47 69 74 48 75 62 2e 00 41 6e 79 20 70	.a.pull.request.on.GitHub..Any.p
118c0	61 63 6b 61 67 65 73 20 69 6e 20 74 68 65 20 70 61 63 6b 61 67 65 73 20 64 69 72 65 63 74 6f 72	ackages.in.the.packages.director
118e0	79 20 77 69 6c 6c 20 62 65 20 61 64 64 65 64 20 74 6f 20 74 68 65 20 69 73 6f 20 64 75 72 69 6e	y.will.be.added.to.the.iso.durin
11900	67 20 62 75 69 6c 64 2c 20 72 65 70 6c 61 63 69 6e 67 20 74 68 65 20 75 70 73 74 72 65 61 6d 20	g.build,.replacing.the.upstream.
11920	6f 6e 65 73 2e 20 4d 61 6b 65 20 73 75 72 65 20 79 6f 75 20 64 65 6c 65 74 65 20 74 68 65 6d 20	ones..Make.sure.you.delete.them.
11940	28 62 6f 74 68 20 74 68 65 20 73 6f 75 72 63 65 20 64 69 72 65 63 74 6f 72 69 65 73 20 61 6e 64	(both.the.source.directories.and
11960	20 62 75 69 6c 74 20 64 65 62 20 70 61 63 6b 61 67 65 73 29 20 69 66 20 79 6f 75 20 77 61 6e 74	.built.deb.packages).if.you.want
11980	20 74 6f 20 62 75 69 6c 64 20 61 6e 20 69 73 6f 20 66 72 6f 6d 20 70 75 72 65 6c 79 20 75 70 73	.to.build.an.iso.from.purely.ups
119a0	74 72 65 61 6d 20 70 61 63 6b 61 67 65 73 2e 00 41 72 65 20 74 68 65 72 65 20 61 6e 79 20 61 64	tream.packages..Are.there.any.ad
119c0	76 65 72 73 65 20 6f 72 20 6e 6f 6e 2d 6f 62 76 69 6f 75 73 20 69 6e 74 65 72 61 63 74 69 6f 6e	verse.or.non-obvious.interaction
119e0	73 20 77 69 74 68 20 6f 74 68 65 72 20 66 65 61 74 75 72 65 73 3f 20 53 68 6f 75 6c 64 20 69 74	s.with.other.features?.Should.it
11a00	20 62 65 20 6d 75 74 75 61 6c 6c 79 20 65 78 63 6c 75 73 69 76 65 20 77 69 74 68 20 61 6e 79 74	.be.mutually.exclusive.with.anyt
11a20	68 69 6e 67 3f 00 41 72 65 20 74 68 65 72 65 20 61 6e 79 20 6c 69 6d 69 74 61 74 69 6f 6e 73 20	hing?.Are.there.any.limitations.
11a40	28 68 61 72 64 77 61 72 65 20 73 75 70 70 6f 72 74 2c 20 72 65 73 6f 75 72 63 65 20 75 73 61 67	(hardware.support,.resource.usag
11a60	65 29 3f 00 41 73 20 53 6d 6f 6b 65 74 65 73 74 73 20 77 69 6c 6c 20 61 6c 74 65 72 20 74 68 65	e)?.As.Smoketests.will.alter.the
11a80	20 73 79 73 74 65 6d 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 61 6e 64 20 79 6f 75 20 61 72	.system.configuration.and.you.ar
11aa0	65 20 6c 6f 67 67 65 64 20 69 6e 20 72 65 6d 6f 74 65 20 79 6f 75 20 6d 61 79 20 6c 6f 6f 73 65	e.logged.in.remote.you.may.loose
11ac0	20 79 6f 75 72 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 74 6f 20 74 68 65 20 73 79 73 74 65 6d 2e 00	.your.connection.to.the.system..
11ae0	41 73 20 74 68 65 20 56 79 4f 53 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 69 73 20 6e 6f 74	As.the.VyOS.documentation.is.not
11b00	20 6f 6e 6c 79 20 66 6f 72 20 75 73 65 72 73 20 62 75 74 20 61 6c 73 6f 20 66 6f 72 20 74 68 65	.only.for.users.but.also.for.the
11b20	20 64 65 76 65 6c 6f 70 65 72 73 20 2d 20 61 6e 64 20 77 65 20 6b 65 65 70 20 6e 6f 20 73 65 63	.developers.-.and.we.keep.no.sec
11b40	72 65 74 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 2d 20 74 68 69 73 20 73 65 63 74 69 6f 6e	ret.documentation.-.this.section
11b60	20 64 65 73 63 72 69 62 65 73 20 68 6f 77 20 74 68 65 20 61 75 74 6f 6d 61 74 65 64 20 74 65 73	.describes.how.the.automated.tes
11b80	74 69 6e 67 20 77 6f 72 6b 73 2e 00 41 73 73 75 6d 65 20 77 65 20 77 61 6e 74 20 74 6f 20 62 75	ting.works..Assume.we.want.to.bu
11ba0	69 6c 64 20 74 68 65 20 76 79 6f 73 2d 31 78 20 70 61 63 6b 61 67 65 20 6f 6e 20 6f 75 72 20 6f	ild.the.vyos-1x.package.on.our.o
11bc0	77 6e 20 61 6e 64 20 6d 6f 64 69 66 79 20 69 74 20 74 6f 20 6f 75 72 20 6e 65 65 64 73 2e 20 57	wn.and.modify.it.to.our.needs..W
11be0	65 20 66 69 72 73 74 20 6e 65 65 64 20 74 6f 20 63 6c 6f 6e 65 20 74 68 65 20 72 65 70 6f 73 69	e.first.need.to.clone.the.reposi
11c00	74 6f 72 79 20 66 72 6f 6d 20 47 69 74 48 75 62 2e 00 41 74 74 61 63 68 20 70 61 74 63 68 20 74	tory.from.GitHub..Attach.patch.t
11c20	6f 20 50 68 61 62 72 69 63 61 74 6f 72 20 74 61 73 6b 00 42 61 64 3a 20 22 44 69 73 61 62 6c 65	o.Phabricator.task.Bad:."Disable
11c40	73 20 49 50 76 36 20 66 6f 72 77 61 72 64 69 6e 67 22 00 42 61 64 3a 20 22 46 72 6f 62 6e 69 63	s.IPv6.forwarding".Bad:."Frobnic
11c60	61 74 69 6f 6e 20 61 6c 67 6f 72 69 74 68 6d 2e 22 00 42 61 64 3a 20 22 53 65 74 20 54 43 50 20	ation.algorithm.".Bad:."Set.TCP.
11c80	63 6f 6e 6e 65 63 74 69 6f 6e 20 74 69 6d 65 6f 75 74 22 00 42 61 64 3a 20 22 66 72 6f 62 6e 69	connection.timeout".Bad:."frobni
11ca0	63 61 74 69 6f 6e 20 61 6c 67 6f 72 69 74 68 6d 22 00 42 61 64 3a 20 22 74 63 70 20 63 6f 6e 6e	cation.algorithm".Bad:."tcp.conn
11cc0	65 63 74 69 6f 6e 20 74 69 6d 65 6f 75 74 22 00 42 61 64 3a 20 50 50 50 4f 45 2c 20 49 50 53 45	ection.timeout".Bad:.PPPOE,.IPSE
11ce0	43 00 42 61 64 3a 20 70 70 70 6f 65 2c 20 69 70 73 65 63 00 42 61 64 3a 20 72 61 64 69 75 73 20	C.Bad:.pppoe,.ipsec.Bad:.radius.
11d00	28 75 6e 6c 65 73 73 20 69 74 27 73 20 61 62 6f 75 74 20 74 68 65 20 64 69 73 74 61 6e 63 65 20	(unless.it's.about.the.distance.
11d20	62 65 74 77 65 65 6e 20 61 20 63 65 6e 74 65 72 20 6f 66 20 61 20 63 69 72 63 6c 65 20 61 6e 64	between.a.center.of.a.circle.and
11d40	20 61 6e 79 20 6f 66 20 69 74 73 20 70 6f 69 6e 74 73 29 00 42 65 65 69 6e 67 20 62 72 61 76 65	.any.of.its.points).Beeing.brave
11d60	20 61 6e 64 20 72 75 6e 6e 69 6e 67 20 74 68 65 20 6c 61 74 65 73 74 20 72 6f 6c 6c 69 6e 67 20	.and.running.the.latest.rolling.
11d80	72 65 6c 65 61 73 65 73 20 77 69 6c 6c 20 73 6f 6d 65 74 69 6d 65 73 20 74 72 69 67 67 65 72 20	releases.will.sometimes.trigger.
11da0	62 75 67 73 20 64 75 65 20 74 6f 20 63 6f 72 6e 65 72 20 63 61 73 65 73 20 77 65 20 6d 69 73 73	bugs.due.to.corner.cases.we.miss
11dc0	65 64 20 69 6e 20 6f 75 72 20 64 65 73 69 67 6e 2e 20 54 68 6f 73 65 20 62 75 67 73 20 73 68 6f	ed.in.our.design..Those.bugs.sho
11de0	75 6c 64 20 62 65 20 66 69 6c 65 64 20 76 69 61 20 50 68 61 62 72 69 63 61 74 6f 72 5f 20 62 75	uld.be.filed.via.Phabricator_.bu
11e00	74 20 79 6f 75 20 63 61 6e 20 68 65 6c 70 20 75 73 20 74 6f 20 6e 61 72 72 6f 77 20 64 6f 65 6e	t.you.can.help.us.to.narrow.doen
11e20	20 74 68 65 20 69 73 73 75 65 2e 20 4c 6f 67 69 6e 20 74 6f 20 79 6f 75 72 20 56 79 4f 53 20 73	.the.issue..Login.to.your.VyOS.s
11e40	79 73 74 65 6d 20 61 6e 64 20 63 68 61 6e 67 65 20 69 6e 74 6f 20 63 6f 6e 66 69 67 75 72 61 74	ystem.and.change.into.configurat
11e60	69 6f 6e 20 6d 6f 64 65 20 62 79 20 74 79 70 69 6e 67 20 60 60 63 6f 6e 66 69 67 75 72 65 60 60	ion.mode.by.typing.``configure``
11e80	2e 20 4e 6f 77 20 72 65 2d 6c 6f 61 64 20 79 6f 75 72 20 62 6f 6f 74 20 63 6f 6e 66 69 67 75 72	..Now.re-load.your.boot.configur
11ea0	61 74 69 6f 6e 20 62 79 20 73 69 6d 70 6c 79 20 74 79 70 69 6e 67 20 60 60 6c 6f 61 64 60 60 20	ation.by.simply.typing.``load``.
11ec0	66 6f 6c 6c 6f 77 65 64 20 62 79 20 72 65 74 75 72 6e 2e 00 42 65 69 6e 67 20 62 72 61 76 65 20	followed.by.return..Being.brave.
11ee0	61 6e 64 20 72 75 6e 6e 69 6e 67 20 74 68 65 20 6c 61 74 65 73 74 20 72 6f 6c 6c 69 6e 67 20 72	and.running.the.latest.rolling.r
11f00	65 6c 65 61 73 65 73 20 77 69 6c 6c 20 73 6f 6d 65 74 69 6d 65 73 20 74 72 69 67 67 65 72 20 62	eleases.will.sometimes.trigger.b
11f20	75 67 73 20 64 75 65 20 74 6f 20 63 6f 72 6e 65 72 20 63 61 73 65 73 20 77 65 20 6d 69 73 73 65	ugs.due.to.corner.cases.we.misse
11f40	64 20 69 6e 20 6f 75 72 20 64 65 73 69 67 6e 2e 20 54 68 6f 73 65 20 62 75 67 73 20 73 68 6f 75	d.in.our.design..Those.bugs.shou
11f60	6c 64 20 62 65 20 66 69 6c 65 64 20 76 69 61 20 50 68 61 62 72 69 63 61 74 6f 72 5f 20 62 75 74	ld.be.filed.via.Phabricator_.but
11f80	20 79 6f 75 20 63 61 6e 20 68 65 6c 70 20 75 73 20 74 6f 20 6e 61 72 72 6f 77 20 64 6f 77 6e 20	.you.can.help.us.to.narrow.down.
11fa0	74 68 65 20 69 73 73 75 65 2e 20 4c 6f 67 69 6e 20 74 6f 20 79 6f 75 72 20 56 79 4f 53 20 73 79	the.issue..Login.to.your.VyOS.sy
11fc0	73 74 65 6d 20 61 6e 64 20 63 68 61 6e 67 65 20 69 6e 74 6f 20 63 6f 6e 66 69 67 75 72 61 74 69	stem.and.change.into.configurati
11fe0	6f 6e 20 6d 6f 64 65 20 62 79 20 74 79 70 69 6e 67 20 60 60 63 6f 6e 66 69 67 75 72 65 60 60 2e	on.mode.by.typing.``configure``.
12000	20 4e 6f 77 20 72 65 2d 6c 6f 61 64 20 79 6f 75 72 20 62 6f 6f 74 20 63 6f 6e 66 69 67 75 72 61	.Now.re-load.your.boot.configura
12020	74 69 6f 6e 20 62 79 20 73 69 6d 70 6c 79 20 74 79 70 69 6e 67 20 60 60 6c 6f 61 64 60 60 20 66	tion.by.simply.typing.``load``.f
12040	6f 6c 6c 6f 77 65 64 20 62 79 20 72 65 74 75 72 6e 2e 00 42 6f 6f 74 20 54 69 6d 69 6e 67 00 42	ollowed.by.return..Boot.Timing.B
12060	75 67 20 52 65 70 6f 72 74 2f 49 73 73 75 65 00 42 75 67 20 72 65 70 6f 72 74 73 20 74 68 61 74	ug.Report/Issue.Bug.reports.that
12080	20 6c 61 63 6b 20 72 65 70 72 6f 64 75 63 69 6e 67 20 70 72 6f 63 65 64 75 72 65 73 2e 00 42 75	.lack.reproducing.procedures..Bu
120a0	69 6c 64 00 42 75 69 6c 64 20 43 6f 6e 74 61 69 6e 65 72 00 42 75 69 6c 64 20 49 53 4f 00 42 75	ild.Build.Container.Build.ISO.Bu
120c0	69 6c 64 20 56 79 4f 53 00 42 75 69 6c 64 20 66 72 6f 6d 20 73 6f 75 72 63 65 00 42 75 69 6c 64	ild.VyOS.Build.from.source.Build
120e0	69 6e 67 20 4f 75 74 2d 4f 66 2d 54 72 65 65 20 4d 6f 64 75 6c 65 73 00 42 75 69 6c 64 69 6e 67	ing.Out-Of-Tree.Modules.Building
12100	20 54 68 65 20 4b 65 72 6e 65 6c 00 42 75 69 6c 64 69 6e 67 20 56 79 4f 53 20 6f 6e 20 57 69 6e	.The.Kernel.Building.VyOS.on.Win
12120	64 6f 77 73 20 57 53 4c 32 20 77 69 74 68 20 44 6f 63 6b 65 72 20 69 6e 74 65 67 72 61 74 65 64	dows.WSL2.with.Docker.integrated
12140	20 69 6e 74 6f 20 57 53 4c 32 20 77 69 6c 6c 20 77 6f 72 6b 20 6c 69 6b 65 20 61 20 63 68 61 72	.into.WSL2.will.work.like.a.char
12160	6d 2e 20 4e 6f 20 70 72 6f 62 6c 65 6d 73 20 61 72 65 20 6b 6e 6f 77 6e 20 73 6f 20 66 61 72 21	m..No.problems.are.known.so.far!
12180	00 42 75 69 6c 64 69 6e 67 20 61 6e 20 49 53 4f 20 77 69 74 68 20 61 6e 79 20 63 75 73 74 6f 6d	.Building.an.ISO.with.any.custom
121a0	69 7a 65 64 20 70 61 63 6b 61 67 65 20 69 73 20 69 6e 20 6e 6f 20 77 61 79 20 64 69 66 66 65 72	ized.package.is.in.no.way.differ
121c0	65 6e 74 20 74 68 61 6e 20 62 75 69 6c 64 69 6e 67 20 61 20 72 65 67 75 6c 61 72 20 28 63 75 73	ent.than.building.a.regular.(cus
121e0	74 6f 6d 69 7a 65 64 20 6f 72 20 6e 6f 74 29 20 49 53 4f 20 69 6d 61 67 65 2e 20 53 69 6d 70 6c	tomized.or.not).ISO.image..Simpl
12200	79 20 70 6c 61 63 65 20 79 6f 75 72 20 6d 6f 64 69 66 69 65 64 20 60 2a 2e 64 65 62 60 20 70 61	y.place.your.modified.`*.deb`.pa
12220	63 6b 61 67 65 20 69 6e 73 69 64 65 20 74 68 65 20 60 70 61 63 6b 61 67 65 73 60 20 66 6f 6c 64	ckage.inside.the.`packages`.fold
12240	65 72 20 77 69 74 68 69 6e 20 60 76 79 6f 73 2d 62 75 69 6c 64 60 2e 20 54 68 65 20 62 75 69 6c	er.within.`vyos-build`..The.buil
12260	64 20 70 72 6f 63 65 73 73 20 77 69 6c 6c 20 74 68 65 6e 20 70 69 63 6b 75 70 20 79 6f 75 72 20	d.process.will.then.pickup.your.
12280	63 75 73 74 6f 6d 20 70 61 63 6b 61 67 65 20 61 6e 64 20 69 6e 74 65 67 72 61 74 65 20 69 74 20	custom.package.and.integrate.it.
122a0	69 6e 74 6f 20 79 6f 75 72 20 49 53 4f 2e 00 42 75 69 6c 64 69 6e 67 20 74 68 65 20 6b 65 72 6e	into.your.ISO..Building.the.kern
122c0	65 6c 20 69 73 20 6f 6e 65 20 70 61 72 74 2c 20 62 75 74 20 6e 6f 77 20 79 6f 75 20 61 6c 73 6f	el.is.one.part,.but.now.you.also
122e0	20 6e 65 65 64 20 74 6f 20 62 75 69 6c 64 20 74 68 65 20 72 65 71 75 69 72 65 64 20 6f 75 74 2d	.need.to.build.the.required.out-
12300	6f 66 2d 74 72 65 65 20 6d 6f 64 75 6c 65 73 20 73 6f 20 65 76 65 72 79 74 68 69 6e 67 20 69 73	of-tree.modules.so.everything.is
12320	20 6c 69 6e 65 64 20 75 70 20 61 6e 64 20 74 68 65 20 41 42 49 73 20 6d 61 74 63 68 2e 20 54 6f	.lined.up.and.the.ABIs.match..To
12340	20 64 6f 20 73 6f 2c 20 79 6f 75 20 63 61 6e 20 61 67 61 69 6e 20 74 61 6b 65 20 61 20 6c 6f 6f	.do.so,.you.can.again.take.a.loo
12360	6b 20 61 74 20 60 60 76 79 6f 73 2d 62 75 69 6c 64 2f 70 61 63 6b 61 67 65 73 2f 6c 69 6e 75 78	k.at.``vyos-build/packages/linux
12380	2d 6b 65 72 6e 65 6c 2f 4a 65 6e 6b 69 6e 73 66 69 6c 65 60 60 20 74 6f 20 73 65 65 20 61 6c 6c	-kernel/Jenkinsfile``.to.see.all
123a0	20 6f 66 20 74 68 65 20 72 65 71 75 69 72 65 64 20 6d 6f 64 75 6c 65 73 20 61 6e 64 20 74 68 65	.of.the.required.modules.and.the
123c0	69 72 20 73 65 6c 65 63 74 65 64 20 76 65 72 73 69 6f 6e 73 2e 20 57 65 20 77 69 6c 6c 20 73 68	ir.selected.versions..We.will.sh
123e0	6f 77 20 79 6f 75 20 68 6f 77 20 74 6f 20 62 75 69 6c 64 20 61 6c 6c 20 74 68 65 20 63 75 72 72	ow.you.how.to.build.all.the.curr
12400	65 6e 74 20 72 65 71 75 69 72 65 64 20 6d 6f 64 75 6c 65 73 2e 00 42 75 69 6c 64 69 6e 67 20 74	ent.required.modules..Building.t
12420	68 65 20 6b 65 72 6e 65 6c 20 77 69 6c 6c 20 74 61 6b 65 20 73 6f 6d 65 20 74 69 6d 65 20 64 65	he.kernel.will.take.some.time.de
12440	70 65 6e 64 69 6e 67 20 6f 6e 20 74 68 65 20 73 70 65 65 64 20 61 6e 64 20 71 75 61 6e 74 69 74	pending.on.the.speed.and.quantit
12460	79 20 6f 66 20 79 6f 75 72 20 43 50 55 2f 63 6f 72 65 73 20 61 6e 64 20 64 69 73 6b 20 73 70 65	y.of.your.CPU/cores.and.disk.spe
12480	65 64 2e 20 45 78 70 65 63 74 20 32 30 20 6d 69 6e 75 74 65 73 20 28 6f 72 20 65 76 65 6e 20 6c	ed..Expect.20.minutes.(or.even.l
124a0	6f 6e 67 65 72 29 20 6f 6e 20 6c 6f 77 65 72 20 65 6e 64 20 68 61 72 64 77 61 72 65 2e 00 42 75	onger).on.lower.end.hardware..Bu
124c0	69 6c 64 69 6e 67 20 75 73 69 6e 67 20 61 20 3a 72 65 66 3a 60 62 75 69 6c 64 5f 64 6f 63 6b 65	ilding.using.a.:ref:`build_docke
124e0	72 60 20 63 6f 6e 74 61 69 6e 65 72 2c 20 61 6c 74 68 6f 75 67 68 20 6e 6f 74 20 74 68 65 20 6f	r`.container,.although.not.the.o
12500	6e 6c 79 20 77 61 79 2c 20 69 73 20 74 68 65 20 65 61 73 69 65 73 74 20 77 61 79 20 61 73 20 61	nly.way,.is.the.easiest.way.as.a
12520	6c 6c 20 64 65 70 65 6e 64 65 6e 63 69 65 73 20 61 72 65 20 6d 61 6e 61 67 65 64 20 66 6f 72 20	ll.dependencies.are.managed.for.
12540	79 6f 75 2e 20 48 6f 77 65 76 65 72 2c 20 79 6f 75 20 63 61 6e 20 61 6c 73 6f 20 73 65 74 20 75	you..However,.you.can.also.set.u
12560	70 20 79 6f 75 72 20 6f 77 6e 20 62 75 69 6c 64 20 6d 61 63 68 69 6e 65 20 61 6e 64 20 72 75 6e	p.your.own.build.machine.and.run
12580	20 61 20 3a 72 65 66 3a 60 62 75 69 6c 64 5f 6e 61 74 69 76 65 60 2e 00 42 75 74 20 77 65 20 61	.a.:ref:`build_native`..But.we.a
125a0	72 65 20 68 65 72 65 20 74 6f 20 61 73 73 69 73 74 20 79 6f 75 20 61 6e 64 20 77 61 6e 74 20 74	re.here.to.assist.you.and.want.t
125c0	6f 20 67 75 69 64 65 20 79 6f 75 20 74 68 72 6f 75 67 68 20 68 6f 77 20 79 6f 75 20 63 61 6e 20	o.guide.you.through.how.you.can.
125e0	62 65 63 6f 6d 65 20 61 20 67 6f 6f 64 20 56 79 4f 53 20 63 6f 6e 74 72 69 62 75 74 6f 72 2e 20	become.a.good.VyOS.contributor..
12600	54 68 65 20 72 75 6c 65 73 20 77 65 20 68 61 76 65 20 61 72 65 20 6e 6f 74 20 74 68 65 72 65 20	The.rules.we.have.are.not.there.
12620	74 6f 20 70 75 6e 69 73 68 20 79 6f 75 20 2d 20 74 68 65 20 72 75 6c 65 73 20 61 72 65 20 69 6e	to.punish.you.-.the.rules.are.in
12640	20 70 6c 61 63 65 20 74 6f 20 68 65 6c 70 20 75 73 20 61 6c 6c 2e 20 57 68 61 74 20 64 6f 65 73	.place.to.help.us.all..What.does
12660	20 69 74 20 6d 65 61 6e 3f 20 42 79 20 68 61 76 69 6e 67 20 61 20 63 6f 6e 73 69 73 74 65 6e 74	.it.mean?.By.having.a.consistent
12680	20 63 6f 64 69 6e 67 20 73 74 79 6c 65 20 69 74 20 62 65 63 6f 6d 65 73 20 76 65 72 79 20 65 61	.coding.style.it.becomes.very.ea
126a0	73 79 20 66 6f 72 20 6e 65 77 20 63 6f 6e 74 72 69 62 75 74 6f 72 73 20 61 6e 64 20 61 6c 73 6f	sy.for.new.contributors.and.also
126c0	20 6c 6f 6e 67 74 69 6d 65 20 63 6f 6e 74 72 69 62 75 74 6f 72 73 20 74 6f 20 6e 61 76 69 67 61	.longtime.contributors.to.naviga
126e0	74 65 20 74 68 72 6f 75 67 68 20 74 68 65 20 73 6f 75 72 63 65 73 20 61 6e 64 20 61 6c 6c 20 74	te.through.the.sources.and.all.t
12700	68 65 20 69 6d 70 6c 69 65 64 20 6c 6f 67 69 63 20 6f 66 20 74 68 65 20 73 70 61 67 68 65 74 74	he.implied.logic.of.the.spaghett
12720	69 20 63 6f 64 65 2e 00 43 2b 2b 20 42 61 63 6b 65 6e 64 20 43 6f 64 65 00 43 61 70 69 74 61 6c	i.code..C++.Backend.Code.Capital
12740	69 7a 61 74 69 6f 6e 20 61 6e 64 20 70 75 6e 63 74 75 61 74 69 6f 6e 00 43 68 65 63 6b 20 6f 75	ization.and.punctuation.Check.ou
12760	74 20 74 68 65 20 72 65 71 75 69 72 65 64 20 6b 65 72 6e 65 6c 20 76 65 72 73 69 6f 6e 20 2d 20	t.the.required.kernel.version.-.
12780	73 65 65 20 60 60 76 79 6f 73 2d 62 75 69 6c 64 2f 64 61 74 61 2f 64 65 66 61 75 6c 74 73 2e 6a	see.``vyos-build/data/defaults.j
127a0	73 6f 6e 60 60 20 66 69 6c 65 20 28 65 78 61 6d 70 6c 65 20 75 73 65 73 20 6b 65 72 6e 65 6c 20	son``.file.(example.uses.kernel.
127c0	34 2e 31 39 2e 31 34 36 29 3a 00 43 6c 6f 6e 65 20 74 68 65 20 6b 65 72 6e 65 6c 20 73 6f 75 72	4.19.146):.Clone.the.kernel.sour
127e0	63 65 20 74 6f 20 60 76 79 6f 73 2d 62 75 69 6c 64 2f 70 61 63 6b 61 67 65 73 2f 6c 69 6e 75 78	ce.to.`vyos-build/packages/linux
12800	2d 6b 65 72 6e 65 6c 2f 60 3a 00 43 6c 6f 6e 65 3a 20 60 60 67 69 74 20 63 6c 6f 6e 65 20 68 74	-kernel/`:.Clone:.``git.clone.ht
12820	74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 3c 75 73 65 72 3e 2f 76 79 6f 73 2d 31 78 2e	tps://github.com/<user>/vyos-1x.
12840	67 69 74 60 60 00 43 6f 64 69 6e 67 20 47 75 69 64 65 6c 69 6e 65 73 00 43 6f 6d 6d 61 6e 64 20	git``.Coding.Guidelines.Command.
12860	64 65 66 69 6e 69 74 69 6f 6e 73 20 61 72 65 20 70 75 72 65 6c 79 20 64 65 63 6c 61 72 61 74 69	definitions.are.purely.declarati
12880	76 65 2c 20 61 6e 64 20 63 61 6e 6e 6f 74 20 63 6f 6e 74 61 69 6e 20 61 6e 79 20 6c 6f 67 69 63	ve,.and.cannot.contain.any.logic
128a0	2e 20 41 6c 6c 20 6c 6f 67 69 63 20 66 6f 72 20 67 65 6e 65 72 61 74 69 6e 67 20 63 6f 6e 66 69	..All.logic.for.generating.confi
128c0	67 20 66 69 6c 65 73 20 66 6f 72 20 74 61 72 67 65 74 20 61 70 70 6c 69 63 61 74 69 6f 6e 73 2c	g.files.for.target.applications,
128e0	20 72 65 73 74 61 72 74 69 6e 67 20 73 65 72 76 69 63 65 73 20 61 6e 64 20 73 6f 20 6f 6e 20 69	.restarting.services.and.so.on.i
12900	73 20 69 6d 70 6c 65 6d 65 6e 74 65 64 20 69 6e 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 73	s.implemented.in.configuration.s
12920	63 72 69 70 74 73 20 69 6e 73 74 65 61 64 2e 00 43 6f 6d 6d 69 74 20 74 68 65 20 63 68 61 6e 67	cripts.instead..Commit.the.chang
12940	65 73 20 62 79 20 63 61 6c 6c 69 6e 67 20 60 60 67 69 74 20 63 6f 6d 6d 69 74 60 60 2e 20 50 6c	es.by.calling.``git.commit``..Pl
12960	65 61 73 65 20 75 73 65 20 61 20 6d 65 61 6e 69 6e 67 66 75 6c 20 63 6f 6d 6d 69 74 20 68 65 61	ease.use.a.meaningful.commit.hea
12980	64 6c 69 6e 65 20 28 72 65 61 64 20 61 62 6f 76 65 29 20 61 6e 64 20 64 6f 6e 27 74 20 66 6f 72	dline.(read.above).and.don't.for
129a0	67 65 74 20 74 6f 20 72 65 66 65 72 65 6e 63 65 20 74 68 65 20 50 68 61 62 72 69 63 61 74 6f 72	get.to.reference.the.Phabricator
129c0	5f 20 49 44 2e 00 43 6f 6e 66 69 67 20 4c 6f 61 64 20 54 65 73 74 73 00 43 6f 6e 66 69 67 20 4d	_.ID..Config.Load.Tests.Config.M
129e0	69 67 72 61 74 69 6f 6e 20 53 63 72 69 70 74 73 00 43 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 45	igration.Scripts.Configuration.E
12a00	72 72 6f 72 20 6f 6e 20 53 79 73 74 65 6d 20 42 6f 6f 74 00 43 6f 6e 66 69 67 75 72 61 74 69 6f	rror.on.System.Boot.Configuratio
12a20	6e 20 53 63 72 69 70 74 20 53 74 72 75 63 74 75 72 65 20 61 6e 64 20 42 65 68 61 76 69 6f 75 72	n.Script.Structure.and.Behaviour
12a40	00 43 6f 6e 73 75 6c 74 20 74 68 65 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 5f 20 74 6f 20 65	.Consult.the.documentation_.to.e
12a60	6e 73 75 72 65 20 74 68 61 74 20 79 6f 75 20 68 61 76 65 20 63 6f 6e 66 69 67 75 72 65 64 20 79	nsure.that.you.have.configured.y
12a80	6f 75 72 20 73 79 73 74 65 6d 20 63 6f 72 72 65 63 74 6c 79 00 43 6f 6e 74 69 6e 75 6f 75 73 20	our.system.correctly.Continuous.
12aa0	49 6e 74 65 67 72 61 74 69 6f 6e 00 43 75 73 74 6f 6d 69 7a 65 00 44 48 43 50 20 63 6c 69 65 6e	Integration.Customize.DHCP.clien
12ac0	74 20 61 6e 64 20 44 48 43 50 76 36 20 70 72 65 66 69 78 20 64 65 6c 65 67 61 74 69 6f 6e 00 44	t.and.DHCPv6.prefix.delegation.D
12ae0	4d 56 50 4e 20 70 61 74 63 68 65 73 20 61 72 65 20 61 64 64 65 64 20 62 79 20 74 68 69 73 20 63	MVPN.patches.are.added.by.this.c
12b00	6f 6d 6d 69 74 3a 20 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 76 79 6f 73 2f 76	ommit:.https://github.com/vyos/v
12b20	79 6f 73 2d 73 74 72 6f 6e 67 73 77 61 6e 2f 63 6f 6d 6d 69 74 2f 31 63 66 31 32 62 30 66 32 66	yos-strongswan/commit/1cf12b0f2f
12b40	39 32 31 62 66 63 35 31 61 66 66 61 33 62 38 31 32 32 36 00 44 65 62 69 61 6e 20 41 50 54 20 69	921bfc51affa3b81226.Debian.APT.i
12b60	73 20 6e 6f 74 20 76 65 72 79 20 76 65 72 62 6f 73 65 20 77 68 65 6e 20 69 74 20 63 6f 6d 65 73	s.not.very.verbose.when.it.comes
12b80	20 74 6f 20 65 72 72 6f 72 73 2e 20 49 66 20 79 6f 75 72 20 49 53 4f 20 62 75 69 6c 64 20 62 72	.to.errors..If.your.ISO.build.br
12ba0	65 61 6b 73 20 66 6f 72 20 77 68 61 74 65 76 65 72 20 72 65 61 73 6f 6e 20 61 6e 64 20 79 6f 75	eaks.for.whatever.reason.and.you
12bc0	20 73 75 73 70 65 63 74 20 69 74 27 73 20 61 20 70 72 6f 62 6c 65 6d 20 77 69 74 68 20 41 50 54	.suspect.it's.a.problem.with.APT
12be0	20 64 65 70 65 6e 64 65 6e 63 69 65 73 20 6f 72 20 69 6e 73 74 61 6c 6c 61 74 69 6f 6e 20 79 6f	.dependencies.or.installation.yo
12c00	75 20 63 61 6e 20 61 64 64 20 74 68 69 73 20 73 6d 61 6c 6c 20 70 61 74 63 68 20 77 68 69 63 68	u.can.add.this.small.patch.which
12c20	20 69 6e 63 72 65 61 73 65 73 20 74 68 65 20 41 50 54 20 76 65 72 62 6f 73 69 74 79 20 64 75 72	.increases.the.APT.verbosity.dur
12c40	69 6e 67 20 49 53 4f 20 62 75 69 6c 64 2e 00 44 65 62 69 61 6e 20 42 6f 6f 6b 77 6f 72 6d 20 66	ing.ISO.build..Debian.Bookworm.f
12c60	6f 72 20 56 79 4f 53 20 31 2e 34 20 28 73 61 67 69 74 74 61 29 00 44 65 62 69 61 6e 20 42 6f 6f	or.VyOS.1.4.(sagitta).Debian.Boo
12c80	6b 77 6f 72 6d 20 66 6f 72 20 74 68 65 20 75 70 63 6f 6d 69 6e 67 20 56 79 4f 53 20 31 2e 35 2f	kworm.for.the.upcoming.VyOS.1.5/
12ca0	63 69 72 63 69 6e 75 73 2f 63 75 72 72 65 6e 74 20 28 73 75 62 6a 65 63 74 20 74 6f 20 63 68 61	circinus/current.(subject.to.cha
12cc0	6e 67 65 29 20 2d 20 61 6b 61 20 74 68 65 20 72 6f 6c 6c 69 6e 67 20 72 65 6c 65 61 73 65 00 44	nge).-.aka.the.rolling.release.D
12ce0	65 62 69 61 6e 20 42 75 6c 6c 73 65 79 65 20 66 6f 72 20 56 79 4f 53 20 31 2e 34 20 28 73 61 67	ebian.Bullseye.for.VyOS.1.4.(sag
12d00	69 74 74 61 29 00 44 65 62 69 61 6e 20 42 75 6c 6c 73 65 79 65 20 66 6f 72 20 56 79 4f 53 20 31	itta).Debian.Bullseye.for.VyOS.1
12d20	2e 34 20 28 73 61 67 69 74 74 61 2c 20 63 75 72 72 65 6e 74 29 20 2d 20 61 6b 61 20 74 68 65 20	.4.(sagitta,.current).-.aka.the.
12d40	72 6f 6c 6c 69 6e 67 20 72 65 6c 65 61 73 65 00 44 65 62 69 61 6e 20 42 75 73 74 65 72 20 66 6f	rolling.release.Debian.Buster.fo
12d60	72 20 56 79 4f 53 20 31 2e 33 20 28 65 71 75 75 6c 65 75 73 29 00 44 65 62 69 61 6e 20 4a 65 73	r.VyOS.1.3.(equuleus).Debian.Jes
12d80	73 69 65 20 66 6f 72 20 56 79 4f 53 20 31 2e 32 20 28 63 72 75 78 29 00 44 65 62 69 61 6e 20 64	sie.for.VyOS.1.2.(crux).Debian.d
12da0	6f 65 73 20 6b 65 65 70 20 74 68 65 69 72 20 70 61 63 6b 61 67 65 20 69 6e 20 67 69 74 2c 20 62	oes.keep.their.package.in.git,.b
12dc0	75 74 20 69 74 27 73 20 75 70 73 74 72 65 61 6d 20 74 61 72 62 61 6c 6c 20 69 6d 70 6f 72 74 65	ut.it's.upstream.tarball.importe
12de0	64 20 69 6e 74 6f 20 67 69 74 20 77 69 74 68 6f 75 74 20 69 74 73 20 6f 72 69 67 69 6e 61 6c 20	d.into.git.without.its.original.
12e00	63 6f 6d 6d 69 74 20 68 69 73 74 6f 72 79 2e 20 54 6f 20 62 65 20 61 62 6c 65 20 74 6f 20 6d 65	commit.history..To.be.able.to.me
12e20	72 67 65 20 6e 65 77 20 74 61 67 73 20 69 6e 2c 20 77 65 20 6b 65 65 70 20 61 20 66 6f 72 6b 20	rge.new.tags.in,.we.keep.a.fork.
12e40	6f 66 20 74 68 65 20 75 70 73 74 72 65 61 6d 20 72 65 70 6f 73 69 74 6f 72 79 20 77 69 74 68 20	of.the.upstream.repository.with.
12e60	70 61 63 6b 61 67 69 6e 67 20 66 69 6c 65 73 20 69 6d 70 6f 72 74 65 64 20 66 72 6f 6d 20 44 65	packaging.files.imported.from.De
12e80	62 69 61 6e 20 61 74 20 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 76 79 6f 73 2f	bian.at.https://github.com/vyos/
12ea0	6b 65 65 70 61 6c 69 76 65 64 2d 75 70 73 74 72 65 61 6d 00 44 65 62 75 67 67 69 6e 67 00 44 65	keepalived-upstream.Debugging.De
12ec0	62 75 67 67 69 6e 67 20 50 79 74 68 6f 6e 20 43 6f 64 65 20 77 69 74 68 20 50 44 42 00 44 65 73	bugging.Python.Code.with.PDB.Des
12ee0	63 72 69 70 74 69 6f 6e 00 44 65 74 65 72 6d 69 6e 69 6e 65 20 73 6f 75 72 63 65 20 70 61 63 6b	cription.Determinine.source.pack
12f00	61 67 65 00 44 65 76 65 6c 6f 70 6d 65 6e 74 00 44 6f 20 6e 6f 74 20 61 64 64 20 61 6e 67 6c 65	age.Development.Do.not.add.angle
12f20	20 62 72 61 63 6b 65 74 73 20 61 72 6f 75 6e 64 20 74 68 65 20 66 6f 72 6d 61 74 2c 20 74 68 65	.brackets.around.the.format,.the
12f40	79 20 77 69 6c 6c 20 62 65 20 69 6e 73 65 72 74 65 64 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79	y.will.be.inserted.automatically
12f60	00 44 6f 63 6b 65 72 00 44 6f 63 6b 65 72 68 75 62 00 44 6f 69 6e 67 20 73 6f 20 67 72 61 6e 74	.Docker.Dockerhub.Doing.so.grant
12f80	73 20 70 72 69 76 69 6c 65 67 65 73 20 65 71 75 69 76 61 6c 65 6e 74 20 74 6f 20 74 68 65 20 60	s.privileges.equivalent.to.the.`
12fa0	60 72 6f 6f 74 60 60 20 75 73 65 72 21 20 49 74 20 69 73 20 72 65 63 6f 6d 6d 65 6e 64 65 64 20	`root``.user!.It.is.recommended.
12fc0	74 6f 20 72 65 6d 6f 76 65 20 74 68 65 20 6e 6f 6e 2d 72 6f 6f 74 20 75 73 65 72 20 66 72 6f 6d	to.remove.the.non-root.user.from
12fe0	20 74 68 65 20 60 60 64 6f 63 6b 65 72 60 60 20 67 72 6f 75 70 20 61 66 74 65 72 20 62 75 69 6c	.the.``docker``.group.after.buil
13000	64 69 6e 67 20 74 68 65 20 56 79 4f 53 20 49 53 4f 2e 20 53 65 65 20 61 6c 73 6f 20 60 44 6f 63	ding.the.VyOS.ISO..See.also.`Doc
13020	6b 65 72 20 61 73 20 6e 6f 6e 2d 72 6f 6f 74 60 5f 2e 00 44 75 65 20 74 6f 20 69 73 73 75 65 73	ker.as.non-root`_..Due.to.issues
13040	20 69 6e 20 74 68 65 20 75 70 73 74 72 65 61 6d 20 76 65 72 73 69 6f 6e 20 74 68 61 74 20 73 6f	.in.the.upstream.version.that.so
13060	6d 65 74 69 6d 65 73 20 73 65 74 20 69 6e 74 65 72 66 61 63 65 73 20 64 6f 77 6e 2c 20 61 20 6d	metimes.set.interfaces.down,.a.m
13080	6f 64 69 66 69 65 64 20 76 65 72 73 69 6f 6e 20 69 73 20 75 73 65 64 2e 00 44 75 65 20 74 6f 20	odified.version.is.used..Due.to.
130a0	74 68 65 20 75 70 64 61 74 65 64 20 76 65 72 73 69 6f 6e 20 6f 66 20 44 6f 63 6b 65 72 2c 20 74	the.updated.version.of.Docker,.t
130c0	68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 65 78 61 6d 70 6c 65 73 20 6d 61 79 20 62 65 63 6f 6d 65	he.following.examples.may.become
130e0	20 69 6e 76 61 6c 69 64 2e 00 44 75 72 69 6e 67 20 74 68 65 20 6d 69 67 72 61 74 69 6f 6e 20 61	.invalid..During.the.migration.a
13100	6e 64 20 65 78 74 65 6e 73 69 76 65 20 72 65 77 72 69 74 65 20 6f 66 20 66 75 6e 63 74 69 6f 6e	nd.extensive.rewrite.of.function
13120	61 6c 69 74 79 20 66 72 6f 6d 20 50 65 72 6c 20 69 6e 74 6f 20 50 79 74 68 6f 6e 20 61 20 73 69	ality.from.Perl.into.Python.a.si
13140	67 6e 69 66 69 63 61 6e 74 20 69 6e 63 72 65 61 73 65 20 69 6e 20 74 68 65 20 6f 76 65 72 61 6c	gnificant.increase.in.the.overal
13160	6c 20 73 79 73 74 65 6d 20 62 6f 6f 74 74 69 6d 65 20 77 61 73 20 6e 6f 74 69 63 65 64 2e 20 54	l.system.boottime.was.noticed..T
13180	68 65 20 73 79 73 74 65 6d 20 62 6f 6f 74 20 74 69 6d 65 20 63 61 6e 20 62 65 20 61 6e 61 6c 79	he.system.boot.time.can.be.analy
131a0	73 65 64 20 61 6e 64 20 61 20 67 72 61 70 68 20 63 61 6e 20 62 65 20 67 65 6e 65 72 61 74 65 64	sed.and.a.graph.can.be.generated
131c0	20 69 6e 20 74 68 65 20 65 6e 64 20 77 68 69 63 68 20 73 68 6f 77 73 20 69 6e 20 64 65 74 61 69	.in.the.end.which.shows.in.detai
131e0	6c 20 77 68 6f 20 63 61 6c 6c 65 64 20 77 68 6f 6d 20 64 75 72 69 6e 67 20 74 68 65 20 73 79 73	l.who.called.whom.during.the.sys
13200	74 65 6d 20 73 74 61 72 74 75 70 20 70 68 61 73 65 2e 00 45 61 63 68 20 6d 6f 64 75 6c 65 20 69	tem.startup.phase..Each.module.i
13220	73 20 62 75 69 6c 64 20 6f 6e 20 64 65 6d 61 6e 64 20 69 66 20 61 20 6e 65 77 20 63 6f 6d 6d 69	s.build.on.demand.if.a.new.commi
13240	74 20 6f 6e 20 74 68 65 20 62 72 61 6e 63 68 20 69 6e 20 71 75 65 73 74 69 6f 6e 20 69 73 20 66	t.on.the.branch.in.question.is.f
13260	6f 75 6e 64 2e 20 41 66 74 65 72 20 61 20 73 75 63 63 65 73 73 66 75 6c 20 72 75 6e 20 74 68 65	ound..After.a.successful.run.the
13280	20 72 65 73 75 6c 74 69 6e 67 20 44 65 62 69 61 6e 20 50 61 63 6b 61 67 65 28 73 29 20 77 69 6c	.resulting.Debian.Package(s).wil
132a0	6c 20 62 65 20 64 65 70 6c 6f 79 65 64 20 74 6f 20 6f 75 72 20 44 65 62 69 61 6e 20 72 65 70 6f	l.be.deployed.to.our.Debian.repo
132c0	73 69 74 6f 72 79 20 77 68 69 63 68 20 69 73 20 75 73 65 64 20 64 75 72 69 6e 67 20 62 75 69 6c	sitory.which.is.used.during.buil
132e0	64 20 74 69 6d 65 2e 20 49 74 20 69 73 20 6c 6f 63 61 74 65 64 20 68 65 72 65 3a 20 68 74 74 70	d.time..It.is.located.here:.http
13300	3a 2f 2f 64 65 76 2e 70 61 63 6b 61 67 65 73 2e 76 79 6f 73 2e 6e 65 74 2f 72 65 70 6f 73 69 74	://dev.packages.vyos.net/reposit
13320	6f 72 69 65 73 2f 2e 00 45 61 63 68 20 6f 66 20 74 68 6f 73 65 20 6d 6f 64 75 6c 65 73 20 68 6f	ories/..Each.of.those.modules.ho
13340	6c 64 73 20 61 20 64 65 70 65 6e 64 65 6e 63 79 20 6f 6e 20 74 68 65 20 6b 65 72 6e 65 6c 20 76	lds.a.dependency.on.the.kernel.v
13360	65 72 73 69 6f 6e 20 61 6e 64 20 69 66 20 79 6f 75 20 61 72 65 20 6c 75 63 6b 79 20 65 6e 6f 75	ersion.and.if.you.are.lucky.enou
13380	67 68 20 74 6f 20 72 65 63 65 69 76 65 20 61 6e 20 49 53 4f 20 62 75 69 6c 64 20 65 72 72 6f 72	gh.to.receive.an.ISO.build.error
133a0	20 77 68 69 63 68 20 73 6f 75 6e 64 73 20 6c 69 6b 65 3a 00 45 6e 61 62 6c 65 64 2f 44 69 73 61	.which.sounds.like:.Enabled/Disa
133c0	62 6c 65 64 00 45 6e 73 75 72 65 20 74 68 65 20 70 72 6f 62 6c 65 6d 20 69 73 20 72 65 70 72 6f	bled.Ensure.the.problem.is.repro
133e0	64 75 63 69 62 6c 65 00 45 76 65 72 79 20 63 68 61 6e 67 65 20 73 65 74 20 6d 75 73 74 20 62 65	ducible.Every.change.set.must.be
13400	20 63 6f 6e 73 69 73 74 65 6e 74 20 28 73 65 6c 66 20 63 6f 6e 74 61 69 6e 69 6e 67 29 21 20 44	.consistent.(self.containing)!.D
13420	6f 20 6e 6f 74 20 66 69 78 20 6d 75 6c 74 69 70 6c 65 20 62 75 67 73 20 69 6e 20 61 20 73 69 6e	o.not.fix.multiple.bugs.in.a.sin
13440	67 6c 65 20 63 6f 6d 6d 69 74 2e 20 49 66 20 79 6f 75 20 61 6c 72 65 61 64 79 20 77 6f 72 6b 65	gle.commit..If.you.already.worke
13460	64 20 6f 6e 20 6d 75 6c 74 69 70 6c 65 20 66 69 78 65 73 20 69 6e 20 74 68 65 20 73 61 6d 65 20	d.on.multiple.fixes.in.the.same.
13480	66 69 6c 65 20 75 73 65 20 60 67 69 74 20 61 64 64 20 2d 2d 70 61 74 63 68 60 20 74 6f 20 6f 6e	file.use.`git.add.--patch`.to.on
134a0	6c 79 20 61 64 64 20 74 68 65 20 70 61 72 74 73 20 72 65 6c 61 74 65 64 20 74 6f 20 74 68 65 20	ly.add.the.parts.related.to.the.
134c0	6f 6e 65 20 69 73 73 75 65 20 69 6e 74 6f 20 79 6f 75 72 20 75 70 63 6f 6d 69 6e 67 20 63 6f 6d	one.issue.into.your.upcoming.com
134e0	6d 69 74 2e 00 45 78 61 6d 70 6c 65 3a 00 45 78 61 6d 70 6c 65 73 3a 00 45 78 63 65 70 74 69 6f	mit..Example:.Examples:.Exceptio
13500	6e 73 2c 20 69 6e 63 6c 75 64 69 6e 67 20 60 60 56 79 4f 53 45 72 72 6f 72 60 60 20 28 77 68 69	ns,.including.``VyOSError``.(whi
13520	63 68 20 69 73 20 72 61 69 73 65 64 20 62 79 20 60 60 76 79 6f 73 2e 63 6f 6e 66 69 67 2e 43 6f	ch.is.raised.by.``vyos.config.Co
13540	6e 66 69 67 60 60 20 6f 6e 20 69 6d 70 72 6f 70 65 72 20 63 6f 6e 66 69 67 20 6f 70 65 72 61 74	nfig``.on.improper.config.operat
13560	69 6f 6e 73 2c 20 73 75 63 68 20 61 73 20 74 72 79 69 6e 67 20 74 6f 20 75 73 65 20 60 60 6c 69	ions,.such.as.trying.to.use.``li
13580	73 74 5f 6e 6f 64 65 73 28 29 60 60 20 6f 6e 20 61 20 6e 6f 6e 2d 74 61 67 20 6e 6f 64 65 29 20	st_nodes()``.on.a.non-tag.node).
135a0	73 68 6f 75 6c 64 20 6e 6f 74 20 62 65 20 73 69 6c 65 6e 63 65 64 20 6f 72 20 63 61 75 67 68 74	should.not.be.silenced.or.caught
135c0	20 61 6e 64 20 72 65 2d 72 61 69 73 65 64 20 61 73 20 63 6f 6e 66 69 67 20 65 72 72 6f 72 2e 20	.and.re-raised.as.config.error..
135e0	53 75 72 65 20 74 68 69 73 20 77 69 6c 6c 20 6e 6f 74 20 6c 6f 6f 6b 20 70 72 65 74 74 79 20 6f	Sure.this.will.not.look.pretty.o
13600	6e 20 75 73 65 72 27 73 20 73 63 72 65 65 6e 2c 20 62 75 74 20 69 74 20 77 69 6c 6c 20 6d 61 6b	n.user's.screen,.but.it.will.mak
13620	65 20 77 61 79 20 62 65 74 74 65 72 20 62 75 67 20 72 65 70 6f 72 74 73 2c 20 61 6e 64 20 68 65	e.way.better.bug.reports,.and.he
13640	6c 70 20 75 73 65 72 73 20 28 61 6e 64 20 6d 6f 73 74 20 56 79 4f 53 20 75 73 65 72 73 20 61 72	lp.users.(and.most.VyOS.users.ar
13660	65 20 49 54 20 70 72 6f 66 65 73 73 69 6f 6e 61 6c 73 29 20 64 6f 20 74 68 65 69 72 20 6f 77 6e	e.IT.professionals).do.their.own
13680	20 64 65 62 75 67 67 69 6e 67 20 61 73 20 77 65 6c 6c 2e 00 45 78 70 6f 72 74 20 6c 61 73 74 20	.debugging.as.well..Export.last.
136a0	63 6f 6d 6d 69 74 20 74 6f 20 70 61 74 63 68 20 66 69 6c 65 3a 20 60 60 67 69 74 20 66 6f 72 6d	commit.to.patch.file:.``git.form
136c0	61 74 2d 70 61 74 63 68 60 60 20 6f 72 20 65 78 70 6f 72 74 20 74 68 65 20 6c 61 73 74 20 74 77	at-patch``.or.export.the.last.tw
136e0	6f 20 63 6f 6d 6d 69 74 73 20 69 6e 74 6f 20 69 74 73 20 61 70 70 72 6f 70 72 69 61 74 65 20 70	o.commits.into.its.appropriate.p
13700	61 74 63 68 20 66 69 6c 65 73 3a 20 60 60 67 69 74 20 66 6f 72 6d 61 74 2d 70 61 74 63 68 20 2d	atch.files:.``git.format-patch.-
13720	32 60 60 00 45 78 74 65 72 6e 61 6c 20 61 72 69 74 68 6d 65 74 69 63 20 76 61 6c 69 64 61 74 6f	2``.External.arithmetic.validato
13740	72 20 6d 61 79 20 62 65 20 61 64 64 65 64 20 69 66 20 74 68 65 72 65 27 73 20 64 65 6d 61 6e 64	r.may.be.added.if.there's.demand
13760	2c 20 63 6f 6d 70 6c 65 78 20 76 61 6c 69 64 61 74 69 6f 6e 20 69 73 20 62 65 74 74 65 72 20 6c	,.complex.validation.is.better.l
13780	65 66 74 20 74 6f 20 63 6f 6d 6d 69 74 2d 74 69 6d 65 20 73 63 72 69 70 74 73 00 46 52 52 00 46	eft.to.commit-time.scripts.FRR.F
137a0	65 61 74 75 72 65 20 52 65 71 75 65 73 74 00 46 65 61 74 75 72 65 20 52 65 71 75 65 73 74 73 00	eature.Request.Feature.Requests.
137c0	46 65 61 74 75 72 65 20 72 65 71 75 65 73 74 73 20 74 68 61 74 20 64 6f 20 6e 6f 74 20 69 6e 63	Feature.requests.that.do.not.inc
137e0	6c 75 64 65 20 72 65 71 75 69 72 65 64 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 61 6e 64 20 6e 65	lude.required.information.and.ne
13800	65 64 20 63 6c 61 72 69 66 69 63 61 74 69 6f 6e 2e 00 46 69 72 6d 77 61 72 65 00 46 69 72 73 74	ed.clarification..Firmware.First
13820	2c 20 63 6c 6f 6e 65 20 74 68 65 20 73 6f 75 72 63 65 20 63 6f 64 65 20 61 6e 64 20 63 68 65 63	,.clone.the.source.code.and.chec
13840	6b 20 6f 75 74 20 74 68 65 20 61 70 70 72 6f 70 72 69 61 74 65 20 76 65 72 73 69 6f 6e 20 62 79	k.out.the.appropriate.version.by
13860	20 72 75 6e 6e 69 6e 67 3a 00 46 6f 6c 6c 6f 77 20 74 68 65 20 61 62 6f 76 65 20 73 74 65 70 73	.running:.Follow.the.above.steps
13880	20 6f 6e 20 68 6f 77 20 74 6f 20 22 46 6f 72 6b 20 72 65 70 6f 73 69 74 6f 72 79 20 74 6f 20 73	.on.how.to."Fork.repository.to.s
138a0	75 62 6d 69 74 20 61 20 50 61 74 63 68 22 2e 20 49 6e 73 74 65 61 64 20 6f 66 20 75 70 6c 6f 61	ubmit.a.Patch"..Instead.of.uploa
138c0	64 69 6e 67 20 22 70 75 73 68 69 6e 67 22 20 79 6f 75 72 20 63 68 61 6e 67 65 73 20 74 6f 20 47	ding."pushing".your.changes.to.G
138e0	69 74 48 75 62 20 79 6f 75 20 63 61 6e 20 65 78 70 6f 72 74 20 74 68 65 20 70 61 74 63 68 65 73	itHub.you.can.export.the.patches
13900	2f 20 63 6f 6d 6d 69 74 73 20 61 6e 64 20 73 65 6e 64 20 69 74 20 74 6f 20 6d 61 69 6e 74 61 69	/.commits.and.send.it.to.maintai
13920	6e 65 72 73 40 76 79 6f 73 2e 6e 65 74 20 6f 72 20 61 74 74 61 63 68 20 69 74 20 64 69 72 65 63	ners@vyos.net.or.attach.it.direc
13940	74 6c 79 20 74 6f 20 74 68 65 20 62 75 67 20 28 70 72 65 66 65 72 72 65 64 20 6f 76 65 72 20 65	tly.to.the.bug.(preferred.over.e
13960	6d 61 69 6c 29 00 46 6f 6c 6c 6f 77 65 64 20 62 79 20 61 20 6d 65 73 73 61 67 65 20 77 68 69 63	mail).Followed.by.a.message.whic
13980	68 20 64 65 73 63 72 69 62 65 73 20 61 6c 6c 20 74 68 65 20 64 65 74 61 69 6c 73 20 6c 69 6b 65	h.describes.all.the.details.like
139a0	3a 00 46 6f 72 20 65 61 63 68 20 66 65 61 74 75 72 65 2c 20 61 20 66 69 6c 65 20 63 61 6c 6c 65	:.For.each.feature,.a.file.calle
139c0	64 20 60 60 76 79 6f 73 2e 66 65 61 74 75 72 65 2e 64 65 62 75 67 60 60 20 63 61 6e 20 62 65 20	d.``vyos.feature.debug``.can.be.
139e0	63 72 65 61 74 65 64 20 74 6f 20 74 6f 67 67 6c 65 20 74 68 65 20 66 65 61 74 75 72 65 20 6f 6e	created.to.toggle.the.feature.on
13a00	2e 20 49 66 20 61 20 70 61 72 61 6d 65 74 65 72 20 69 73 20 72 65 71 75 69 72 65 64 20 69 74 20	..If.a.parameter.is.required.it.
13a20	63 61 6e 20 62 65 20 70 6c 61 63 65 64 20 69 6e 73 69 64 65 20 74 68 65 20 66 69 6c 65 20 61 73	can.be.placed.inside.the.file.as
13a40	20 69 74 73 20 66 69 72 73 74 20 6c 69 6e 65 2e 00 46 6f 72 20 65 61 73 79 20 6f 72 69 65 6e 74	.its.first.line..For.easy.orient
13a60	61 74 69 6f 6e 20 77 65 20 73 75 67 67 65 73 74 20 79 6f 75 20 74 61 6b 65 20 61 20 6c 6f 6f 6b	ation.we.suggest.you.take.a.look
13a80	20 6f 6e 20 74 68 65 20 60 60 6e 74 70 2e 70 79 60 60 20 6f 72 20 60 60 69 6e 74 65 72 66 61 63	.on.the.``ntp.py``.or.``interfac
13aa0	65 73 2d 62 6f 6e 64 69 6e 67 2e 70 79 60 60 20 28 66 6f 72 20 74 61 67 20 6e 6f 64 65 73 29 20	es-bonding.py``.(for.tag.nodes).
13ac0	69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 2e 20 42 6f 74 68 20 66 69 6c 65 73 20 63 61 6e 20 62	implementation..Both.files.can.b
13ae0	65 20 66 6f 75 6e 64 20 69 6e 20 74 68 65 20 76 79 6f 73 2d 31 78 5f 20 72 65 70 6f 73 69 74 6f	e.found.in.the.vyos-1x_.reposito
13b00	72 79 2e 00 46 6f 72 20 65 78 61 6d 70 6c 65 20 72 75 6e 6e 69 6e 67 2c 20 60 60 65 78 70 6f 72	ry..For.example.running,.``expor
13b20	74 20 56 59 4f 53 5f 49 46 43 4f 4e 46 49 47 5f 44 45 42 55 47 3d 22 22 60 60 20 6f 6e 20 79 6f	t.VYOS_IFCONFIG_DEBUG=""``.on.yo
13b40	75 72 20 76 62 61 73 68 2c 20 77 69 6c 6c 20 68 61 76 65 20 74 68 65 20 73 61 6d 65 20 65 66 66	ur.vbash,.will.have.the.same.eff
13b60	65 63 74 20 61 73 20 60 60 74 6f 75 63 68 20 2f 74 6d 70 2f 76 79 6f 73 2e 69 66 63 6f 6e 66 69	ect.as.``touch./tmp/vyos.ifconfi
13b80	67 2e 64 65 62 75 67 60 60 2e 00 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 60 60 2f 74 6d 70 2f 76	g.debug``..For.example,.``/tmp/v
13ba0	79 6f 73 2e 69 66 63 6f 6e 66 69 67 2e 64 65 62 75 67 60 60 20 63 61 6e 20 62 65 20 63 72 65 61	yos.ifconfig.debug``.can.be.crea
13bc0	74 65 64 20 74 6f 20 65 6e 61 62 6c 65 20 69 6e 74 65 72 66 61 63 65 20 64 65 62 75 67 67 69 6e	ted.to.enable.interface.debuggin
13be0	67 2e 00 46 6f 72 20 74 68 65 20 70 61 63 6b 61 67 65 73 20 72 65 71 75 69 72 65 64 2c 20 79 6f	g..For.the.packages.required,.yo
13c00	75 20 63 61 6e 20 72 65 66 65 72 20 74 6f 20 74 68 65 20 60 60 64 6f 63 6b 65 72 2f 44 6f 63 6b	u.can.refer.to.the.``docker/Dock
13c20	65 72 66 69 6c 65 60 60 20 66 69 6c 65 20 69 6e 20 74 68 65 20 72 65 70 6f 73 69 74 6f 72 79 5f	erfile``.file.in.the.repository_
13c40	2e 20 54 68 65 20 60 60 2e 2f 62 75 69 6c 64 2d 76 79 6f 73 2d 69 6d 61 67 65 60 60 20 73 63 72	..The.``./build-vyos-image``.scr
13c60	69 70 74 20 77 69 6c 6c 20 61 6c 73 6f 20 77 61 72 6e 20 79 6f 75 20 69 66 20 61 6e 79 20 64 65	ipt.will.also.warn.you.if.any.de
13c80	70 65 6e 64 65 6e 63 69 65 73 20 61 72 65 20 6d 69 73 73 69 6e 67 2e 00 46 6f 72 6b 20 52 65 70	pendencies.are.missing..Fork.Rep
13ca0	6f 73 69 74 6f 72 79 20 61 6e 64 20 73 75 62 6d 69 74 20 50 61 74 63 68 00 46 6f 72 6b 3a 20 60	ository.and.submit.Patch.Fork:.`
13cc0	60 67 69 74 20 72 65 6d 6f 74 65 20 61 64 64 20 6d 79 66 6f 72 6b 20 68 74 74 70 73 3a 2f 2f 67	`git.remote.add.myfork.https://g
13ce0	69 74 68 75 62 2e 63 6f 6d 2f 3c 75 73 65 72 3e 2f 76 79 6f 73 2d 31 78 2e 67 69 74 60 60 00 46	ithub.com/<user>/vyos-1x.git``.F
13d00	6f 72 6b 69 6e 67 20 74 68 65 20 72 65 70 6f 73 69 74 6f 72 79 20 61 6e 64 20 73 75 62 6d 69 74	orking.the.repository.and.submit
13d20	74 69 6e 67 20 61 20 47 69 74 48 75 62 20 70 75 6c 6c 2d 72 65 71 75 65 73 74 20 69 73 20 74 68	ting.a.GitHub.pull-request.is.th
13d40	65 20 70 72 65 66 65 72 72 65 64 20 77 61 79 20 6f 66 20 73 75 62 6d 69 74 74 69 6e 67 20 79 6f	e.preferred.way.of.submitting.yo
13d60	75 72 20 63 68 61 6e 67 65 73 20 74 6f 20 56 79 4f 53 2e 20 59 6f 75 20 63 61 6e 20 66 6f 72 6b	ur.changes.to.VyOS..You.can.fork
13d80	20 61 6e 79 20 56 79 4f 53 20 72 65 70 6f 73 69 74 6f 72 79 20 74 6f 20 79 6f 75 72 20 76 65 72	.any.VyOS.repository.to.your.ver
13da0	79 20 6f 77 6e 20 47 69 74 48 75 62 20 61 63 63 6f 75 6e 74 20 62 79 20 6a 75 73 74 20 61 70 70	y.own.GitHub.account.by.just.app
13dc0	65 6e 64 69 6e 67 20 60 60 2f 66 6f 72 6b 60 60 20 74 6f 20 61 6e 79 20 72 65 70 6f 73 69 74 6f	ending.``/fork``.to.any.reposito
13de0	72 79 27 73 20 55 52 4c 20 6f 6e 20 47 69 74 48 75 62 2e 20 54 6f 20 65 2e 67 2e 20 66 6f 72 6b	ry's.URL.on.GitHub..To.e.g..fork
13e00	20 74 68 65 20 60 60 76 79 6f 73 2d 31 78 60 60 20 72 65 70 6f 73 69 74 6f 72 79 2c 20 6f 70 65	.the.``vyos-1x``.repository,.ope
13e20	6e 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 55 52 4c 20 69 6e 20 79 6f 75 72 20 66 61 76 6f	n.the.following.URL.in.your.favo
13e40	75 72 69 74 65 20 62 72 6f 77 73 65 72 3a 20 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f	urite.browser:.https://github.co
13e60	6d 2f 76 79 6f 73 2f 76 79 6f 73 2d 31 78 2f 66 6f 72 6b 00 46 6f 72 6d 61 74 74 69 6e 67 00 47	m/vyos/vyos-1x/fork.Formatting.G
13e80	4e 55 20 50 72 65 70 72 6f 63 65 73 73 6f 72 00 47 65 74 20 63 6f 6d 6d 75 6e 69 74 79 20 73 75	NU.Preprocessor.Get.community.su
13ea0	70 70 6f 72 74 20 76 69 61 20 53 6c 61 63 6b 5f 20 6f 72 20 6f 75 72 20 46 6f 72 75 6d 5f 00 47	pport.via.Slack_.or.our.Forum_.G
13ec0	6f 6f 64 20 6c 75 63 6b 21 00 47 6f 6f 64 3a 20 22 44 69 73 61 62 6c 65 20 49 50 76 36 20 66 6f	ood.luck!.Good:."Disable.IPv6.fo
13ee0	72 77 61 72 64 69 6e 67 22 00 47 6f 6f 64 3a 20 22 46 72 6f 62 6e 69 63 61 74 69 6f 6e 20 61 6c	rwarding".Good:."Frobnication.al
13f00	67 6f 72 69 74 68 6d 22 00 47 6f 6f 64 3a 20 22 54 43 50 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 74	gorithm".Good:."TCP.connection.t
13f20	69 6d 65 6f 75 74 22 00 47 6f 6f 64 3a 20 50 50 50 6f 45 2c 20 49 50 73 65 63 00 47 6f 6f 64 3a	imeout".Good:.PPPoE,.IPsec.Good:
13f40	20 52 41 44 49 55 53 20 28 61 73 20 69 6e 20 72 65 6d 6f 74 65 20 61 75 74 68 65 6e 74 69 63 61	.RADIUS.(as.in.remote.authentica
13f60	74 69 6f 6e 20 66 6f 72 20 64 69 61 6c 2d 69 6e 20 75 73 65 72 20 73 65 72 76 69 63 65 73 29 00	tion.for.dial-in.user.services).
13f80	47 75 69 64 65 6c 69 6e 65 73 00 48 65 6c 70 20 53 74 72 69 6e 67 00 48 65 6c 70 20 66 75 74 75	Guidelines.Help.String.Help.futu
13fa0	72 65 20 6d 61 69 6e 74 61 69 6e 65 72 73 20 6f 66 20 56 79 4f 53 20 28 69 74 20 63 6f 75 6c 64	re.maintainers.of.VyOS.(it.could
13fc0	20 62 65 20 79 6f 75 21 29 20 74 6f 20 66 69 6e 64 20 6f 75 74 20 77 68 79 20 63 65 72 74 61 69	.be.you!).to.find.out.why.certai
13fe0	6e 20 74 68 69 6e 67 73 20 68 61 76 65 20 62 65 65 6e 20 63 68 61 6e 67 65 64 20 69 6e 20 74 68	n.things.have.been.changed.in.th
14000	65 20 63 6f 64 65 62 61 73 65 20 6f 72 20 77 68 79 20 63 65 72 74 61 69 6e 20 66 65 61 74 75 72	e.codebase.or.why.certain.featur
14020	65 73 20 68 61 76 65 20 62 65 65 6e 20 61 64 64 65 64 00 48 6f 72 72 69 62 6c 65 3a 20 22 54 63	es.have.been.added.Horrible:."Tc
14040	70 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 74 69 6d 65 6f 75 74 22 00 48 6f 72 72 69 62 6c 65 3a 20	p.connection.timeout".Horrible:.
14060	22 66 72 6f 62 6e 69 63 61 74 69 6f 6e 20 61 6c 67 6f 72 69 74 68 6d 2e 22 00 48 6f 77 20 63 61	"frobnication.algorithm.".How.ca
14080	6e 20 77 65 20 72 65 70 72 6f 64 75 63 65 20 74 68 69 73 20 42 75 67 3f 00 48 6f 77 20 79 6f 75	n.we.reproduce.this.Bug?.How.you
140a0	27 64 20 63 6f 6e 66 69 67 75 72 65 20 69 74 20 62 79 20 68 61 6e 64 20 74 68 65 72 65 3f 00 49	'd.configure.it.by.hand.there?.I
140c0	20 68 61 76 65 20 66 6f 75 6e 64 20 61 20 62 75 67 2c 20 77 68 61 74 20 73 68 6f 75 6c 64 20 49	.have.found.a.bug,.what.should.I
140e0	20 64 6f 3f 00 49 50 20 61 6e 64 20 49 50 76 36 20 6f 70 74 69 6f 6e 73 00 49 53 4f 20 42 75 69	.do?.IP.and.IPv6.options.ISO.Bui
14100	6c 64 20 49 73 73 75 65 73 00 49 53 4f 20 69 6d 61 67 65 20 62 75 69 6c 64 00 49 66 20 61 20 76	ld.Issues.ISO.image.build.If.a.v
14120	65 72 62 20 69 73 20 65 73 73 65 6e 74 69 61 6c 2c 20 6b 65 65 70 20 69 74 2e 20 46 6f 72 20 65	erb.is.essential,.keep.it..For.e
14140	78 61 6d 70 6c 65 2c 20 69 6e 20 74 68 65 20 68 65 6c 70 20 74 65 78 74 20 6f 66 20 60 60 73 65	xample,.in.the.help.text.of.``se
14160	74 20 73 79 73 74 65 6d 20 69 70 76 36 20 64 69 73 61 62 6c 65 2d 66 6f 72 77 61 72 64 69 6e 67	t.system.ipv6.disable-forwarding
14180	60 60 2c 20 22 44 69 73 61 62 6c 65 20 49 50 76 36 20 66 6f 72 77 61 72 64 69 6e 67 20 6f 6e 20	``,."Disable.IPv6.forwarding.on.
141a0	61 6c 6c 20 69 6e 74 65 72 66 61 63 65 73 22 20 69 73 20 61 20 70 65 72 66 65 63 74 6c 79 20 6a	all.interfaces".is.a.perfectly.j
141c0	75 73 74 69 66 69 65 64 20 77 6f 72 64 69 6e 67 2e 00 49 66 20 61 70 70 6c 69 63 61 62 6c 65 20	ustified.wording..If.applicable.
141e0	61 20 72 65 66 65 72 65 6e 63 65 20 74 6f 20 61 20 70 72 65 76 69 6f 75 73 20 63 6f 6d 6d 69 74	a.reference.to.a.previous.commit
14200	20 73 68 6f 75 6c 64 20 62 65 20 6d 61 64 65 20 6c 69 6e 6b 69 6e 67 20 74 68 6f 73 65 20 63 6f	.should.be.made.linking.those.co
14220	6d 6d 69 74 73 20 6e 69 63 65 6c 79 20 77 68 65 6e 20 62 72 6f 77 73 69 6e 67 20 74 68 65 20 68	mmits.nicely.when.browsing.the.h
14240	69 73 74 6f 72 79 3a 20 60 60 41 66 74 65 72 20 63 6f 6d 6d 69 74 20 61 62 63 64 31 32 65 66 20	istory:.``After.commit.abcd12ef.
14260	28 22 73 6e 6d 70 3a 20 74 68 69 73 20 69 73 20 61 20 68 65 61 64 6c 69 6e 65 22 29 20 61 20 50	("snmp:.this.is.a.headline").a.P
14280	79 74 68 6f 6e 20 69 6d 70 6f 72 74 20 73 74 61 74 65 6d 65 6e 74 20 69 73 20 6d 69 73 73 69 6e	ython.import.statement.is.missin
142a0	67 2c 20 74 68 72 6f 77 69 6e 67 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 65 78 63 65 70 74	g,.throwing.the.following.except
142c0	69 6f 6e 3a 20 41 42 43 44 45 46 60 60 00 49 66 20 69 74 27 73 20 61 20 72 65 67 72 65 73 73 69	ion:.ABCDEF``.If.it's.a.regressi
142e0	6f 6e 2c 20 74 65 6c 6c 20 75 73 20 61 20 56 79 4f 53 20 76 65 72 73 69 6f 6e 20 77 68 65 72 65	on,.tell.us.a.VyOS.version.where
14300	20 74 68 65 20 66 65 61 74 75 72 65 20 73 74 69 6c 6c 20 77 6f 72 6b 65 64 20 63 6f 72 72 65 63	.the.feature.still.worked.correc
14320	74 6c 79 2e 20 49 74 27 73 20 70 65 72 66 65 63 74 20 69 66 20 79 6f 75 20 63 61 6e 20 74 65 6c	tly..It's.perfect.if.you.can.tel
14340	6c 20 65 78 61 63 74 6c 79 20 77 68 69 63 68 20 76 65 72 73 69 6f 6e 20 62 72 6f 6b 65 20 69 74	l.exactly.which.version.broke.it
14360	2c 20 62 75 74 20 77 65 20 75 6e 64 65 72 73 74 61 6e 64 20 74 68 61 74 20 69 74 27 73 20 6e 6f	,.but.we.understand.that.it's.no
14380	74 20 61 6c 77 61 79 73 20 65 61 73 79 20 6f 72 20 66 65 61 73 69 62 6c 65 20 e2 80 94 20 61 6e	t.always.easy.or.feasible.....an
143a0	79 20 77 6f 72 6b 69 6e 67 20 76 65 72 73 69 6f 6e 20 69 73 20 61 63 63 65 70 74 61 62 6c 65 2e	y.working.version.is.acceptable.
143c0	00 49 66 20 74 68 65 72 65 20 69 73 20 6e 6f 20 50 68 61 62 72 69 63 61 74 6f 72 5f 20 72 65 66	.If.there.is.no.Phabricator_.ref
143e0	65 72 65 6e 63 65 20 69 6e 20 74 68 65 20 63 6f 6d 6d 69 74 73 20 6f 66 20 79 6f 75 72 20 70 75	erence.in.the.commits.of.your.pu
14400	6c 6c 20 72 65 71 75 65 73 74 2c 20 77 65 20 68 61 76 65 20 74 6f 20 61 73 6b 20 79 6f 75 20 74	ll.request,.we.have.to.ask.you.t
14420	6f 20 61 6d 65 6e 64 20 74 68 65 20 63 6f 6d 6d 69 74 20 6d 65 73 73 61 67 65 2e 20 4f 74 68 65	o.amend.the.commit.message..Othe
14440	72 77 69 73 65 20 77 65 20 77 69 6c 6c 20 68 61 76 65 20 74 6f 20 72 65 6a 65 63 74 20 69 74 2e	rwise.we.will.have.to.reject.it.
14460	00 49 66 20 74 68 65 72 65 20 69 73 20 6e 6f 20 72 65 73 70 6f 6e 73 65 20 61 66 74 65 72 20 66	.If.there.is.no.response.after.f
14480	75 72 74 68 65 72 20 74 77 6f 20 77 65 65 6b 73 2c 20 74 68 65 20 74 61 73 6b 20 77 69 6c 6c 20	urther.two.weeks,.the.task.will.
144a0	62 65 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 63 6c 6f 73 65 64 2e 00 49 66 20 74 68 65 72	be.automatically.closed..If.ther
144c0	65 20 69 73 20 6e 6f 20 72 65 73 70 6f 6e 73 65 20 66 72 6f 6d 20 74 68 65 20 72 65 70 6f 72 74	e.is.no.response.from.the.report
144e0	65 72 20 77 69 74 68 69 6e 20 74 77 6f 20 77 65 65 6b 73 2c 20 74 68 65 20 74 61 73 6b 20 62 6f	er.within.two.weeks,.the.task.bo
14500	74 20 77 69 6c 6c 20 61 64 64 20 61 20 63 6f 6d 6d 65 6e 74 20 28 22 41 6e 79 20 6e 65 77 73 3f	t.will.add.a.comment.("Any.news?
14520	22 29 20 74 6f 20 72 65 6d 69 6e 64 20 74 68 65 20 72 65 70 6f 72 74 65 72 20 74 6f 20 72 65 70	").to.remind.the.reporter.to.rep
14540	6c 79 2e 00 49 66 20 79 6f 75 20 61 72 65 20 62 72 61 76 65 20 65 6e 6f 75 67 68 20 74 6f 20 62	ly..If.you.are.brave.enough.to.b
14560	75 69 6c 64 20 79 6f 75 72 73 65 6c 66 20 61 6e 20 49 53 4f 20 69 6d 61 67 65 20 63 6f 6e 74 61	uild.yourself.an.ISO.image.conta
14580	69 6e 69 6e 67 20 61 6e 79 20 6d 6f 64 69 66 69 65 64 20 70 61 63 6b 61 67 65 20 66 72 6f 6d 20	ining.any.modified.package.from.
145a0	6f 75 72 20 47 69 74 48 75 62 20 6f 72 67 61 6e 69 73 61 74 69 6f 6e 20 2d 20 74 68 69 73 20 69	our.GitHub.organisation.-.this.i
145c0	73 20 74 68 65 20 70 6c 61 63 65 20 74 6f 20 62 65 2e 00 49 66 20 79 6f 75 20 61 72 65 6e 27 74	s.the.place.to.be..If.you.aren't
145e0	20 63 65 72 74 61 69 6e 20 77 68 61 74 20 74 68 65 20 63 6f 72 72 65 63 74 20 62 65 68 61 76 69	.certain.what.the.correct.behavi
14600	6f 72 20 69 73 20 61 6e 64 20 69 66 20 77 68 61 74 20 79 6f 75 20 73 65 65 20 69 73 20 72 65 61	or.is.and.if.what.you.see.is.rea
14620	6c 6c 79 20 61 20 62 75 67 2c 20 6f 72 20 69 66 20 79 6f 75 20 64 6f 6e 27 74 20 68 61 76 65 20	lly.a.bug,.or.if.you.don't.have.
14640	61 20 72 65 70 72 6f 64 75 63 69 6e 67 20 70 72 6f 63 65 64 75 72 65 20 74 68 61 74 20 72 65 6c	a.reproducing.procedure.that.rel
14660	69 61 62 6c 79 20 74 72 69 67 67 65 72 73 20 69 74 2c 20 70 6c 65 61 73 65 20 63 72 65 61 74 65	iably.triggers.it,.please.create
14680	20 61 20 70 6f 73 74 20 6f 6e 20 74 68 65 20 66 6f 72 75 6d 20 6f 72 20 61 73 6b 20 69 6e 20 74	.a.post.on.the.forum.or.ask.in.t
146a0	68 65 20 63 68 61 74 20 66 69 72 73 74 20 e2 80 94 20 6f 72 2c 20 69 66 20 79 6f 75 20 68 61 76	he.chat.first.....or,.if.you.hav
146c0	65 20 61 20 73 75 62 73 63 72 69 70 74 69 6f 6e 2c 20 63 72 65 61 74 65 20 61 20 73 75 70 70 6f	e.a.subscription,.create.a.suppo
146e0	72 74 20 74 69 63 6b 65 74 2e 20 4f 75 72 20 74 65 61 6d 20 61 6e 64 20 63 6f 6d 6d 75 6e 69 74	rt.ticket..Our.team.and.communit
14700	79 20 6d 65 6d 62 65 72 73 20 63 61 6e 20 68 65 6c 70 20 79 6f 75 20 69 64 65 6e 74 69 66 79 20	y.members.can.help.you.identify.
14720	74 68 65 20 62 75 67 20 61 6e 64 20 77 6f 72 6b 20 61 72 6f 75 6e 64 20 69 74 2c 20 74 68 65 6e	the.bug.and.work.around.it,.then
14740	20 63 72 65 61 74 65 20 61 6e 20 61 63 74 69 6f 6e 61 62 6c 65 20 61 6e 64 20 74 65 73 74 61 62	.create.an.actionable.and.testab
14760	6c 65 20 62 75 67 20 72 65 70 6f 72 74 2e 00 49 66 20 79 6f 75 20 75 70 67 72 61 64 65 20 79 6f	le.bug.report..If.you.upgrade.yo
14780	75 72 20 6b 65 72 6e 65 6c 20 6f 72 20 69 6e 63 6c 75 64 65 20 6e 65 77 20 64 72 69 76 65 72 73	ur.kernel.or.include.new.drivers
147a0	20 79 6f 75 20 6d 61 79 20 6e 65 65 64 20 6e 65 77 20 66 69 72 6d 77 61 72 65 2e 20 42 75 69 6c	.you.may.need.new.firmware..Buil
147c0	64 20 61 20 6e 65 77 20 60 60 76 79 6f 73 2d 6c 69 6e 75 78 2d 66 69 72 6d 77 61 72 65 60 60 20	d.a.new.``vyos-linux-firmware``.
147e0	70 61 63 6b 61 67 65 20 77 69 74 68 20 74 68 65 20 69 6e 63 6c 75 64 65 64 20 68 65 6c 70 65 72	package.with.the.included.helper
14800	20 73 63 72 69 70 74 73 2e 00 49 6e 20 61 20 62 69 67 20 73 79 73 74 65 6d 2c 20 73 75 63 68 20	.scripts..In.a.big.system,.such.
14820	61 73 20 56 79 4f 53 2c 20 74 68 61 74 20 69 73 20 63 6f 6d 70 72 69 73 65 64 20 6f 66 20 6d 75	as.VyOS,.that.is.comprised.of.mu
14840	6c 74 69 70 6c 65 20 63 6f 6d 70 6f 6e 65 6e 74 73 2c 20 69 74 27 73 20 69 6d 70 6f 73 73 69 62	ltiple.components,.it's.impossib
14860	6c 65 20 74 6f 20 6b 65 65 70 20 74 72 61 63 6b 20 6f 66 20 61 6c 6c 20 74 68 65 20 63 68 61 6e	le.to.keep.track.of.all.the.chan
14880	67 65 73 20 61 6e 64 20 62 75 67 73 2f 66 65 61 74 75 72 65 20 72 65 71 75 65 73 74 73 20 69 6e	ges.and.bugs/feature.requests.in
148a0	20 6f 6e 65 27 73 20 68 65 61 64 2e 20 57 65 20 75 73 65 20 61 20 62 75 67 74 72 61 63 6b 65 72	.one's.head..We.use.a.bugtracker
148c0	20 6b 6e 6f 77 6e 20 61 73 20 50 68 61 62 72 69 63 61 74 6f 72 5f 20 66 6f 72 20 69 74 20 28 22	.known.as.Phabricator_.for.it.("
148e0	69 73 73 75 65 20 74 72 61 63 6b 65 72 22 20 77 6f 75 6c 64 20 62 65 20 61 20 62 65 74 74 65 72	issue.tracker".would.be.a.better
14900	20 74 65 72 6d 2c 20 62 75 74 20 74 68 69 73 20 6f 6e 65 20 73 74 75 63 6b 29 2e 00 49 6e 20 61	.term,.but.this.one.stuck)..In.a
14920	64 64 69 74 69 6f 6e 20 74 68 69 73 20 61 6c 73 6f 20 68 65 6c 70 73 20 77 68 65 6e 20 62 72 6f	ddition.this.also.helps.when.bro
14940	77 73 69 6e 67 20 74 68 65 20 47 69 74 48 75 62 20 63 6f 64 65 62 61 73 65 20 6f 6e 20 61 20 6d	wsing.the.GitHub.codebase.on.a.m
14960	6f 62 69 6c 65 20 64 65 76 69 63 65 20 69 66 20 79 6f 75 20 68 61 70 70 65 6e 20 74 6f 20 62 65	obile.device.if.you.happen.to.be
14980	20 61 20 63 72 61 7a 79 20 73 63 69 65 6e 74 69 73 74 2e 00 49 6e 20 6f 72 64 65 72 20 74 6f 20	.a.crazy.scientist..In.order.to.
149a0	6f 70 65 6e 20 75 70 20 61 20 62 75 67 2d 72 65 70 6f 72 74 2f 66 65 61 74 75 72 65 20 72 65 71	open.up.a.bug-report/feature.req
149c0	75 65 73 74 20 79 6f 75 20 6e 65 65 64 20 74 6f 20 63 72 65 61 74 65 20 79 6f 75 72 73 65 6c 66	uest.you.need.to.create.yourself
149e0	20 61 6e 20 61 63 63 6f 75 6e 74 20 6f 6e 20 56 79 4f 53 20 50 68 61 62 72 69 63 61 74 6f 72 5f	.an.account.on.VyOS.Phabricator_
14a00	2e 20 4f 6e 20 74 68 65 20 6c 65 66 74 20 73 69 64 65 20 6f 66 20 74 68 65 20 73 70 65 63 69 66	..On.the.left.side.of.the.specif
14a20	69 63 20 70 72 6f 6a 65 63 74 20 28 56 79 4f 53 20 31 2e 32 20 6f 72 20 56 79 4f 53 20 31 2e 33	ic.project.(VyOS.1.2.or.VyOS.1.3
14a40	29 20 79 6f 75 20 77 69 6c 6c 20 66 69 6e 64 20 71 75 69 63 6b 2d 6c 69 6e 6b 73 20 66 6f 72 20	).you.will.find.quick-links.for.
14a60	6f 70 65 6e 69 6e 67 20 61 20 62 75 67 2d 72 65 70 6f 72 74 2f 66 65 61 74 75 72 65 20 72 65 71	opening.a.bug-report/feature.req
14a80	75 65 73 74 2e 00 49 6e 20 6f 72 64 65 72 20 74 6f 20 72 65 63 6f 72 64 20 79 6f 75 20 61 73 20	uest..In.order.to.record.you.as.
14aa0	74 68 65 20 61 75 74 68 6f 72 20 6f 66 20 74 68 65 20 66 69 78 20 70 6c 65 61 73 65 20 69 64 65	the.author.of.the.fix.please.ide
14ac0	6e 74 69 66 79 20 79 6f 75 72 73 65 6c 66 20 74 6f 20 47 69 74 20 62 79 20 73 65 74 74 69 6e 67	ntify.yourself.to.Git.by.setting
14ae0	20 75 70 20 79 6f 75 72 20 6e 61 6d 65 20 61 6e 64 20 65 6d 61 69 6c 2e 20 54 68 69 73 20 63 61	.up.your.name.and.email..This.ca
14b00	6e 20 62 65 20 64 6f 6e 65 20 6c 6f 63 61 6c 20 66 6f 72 20 74 68 69 73 20 6f 6e 65 20 61 6e 64	n.be.done.local.for.this.one.and
14b20	20 6f 6e 6c 79 20 72 65 70 6f 73 69 74 6f 72 79 20 60 60 67 69 74 20 63 6f 6e 66 69 67 60 60 20	.only.repository.``git.config``.
14b40	6f 72 20 67 6c 6f 62 61 6c 6c 79 20 75 73 69 6e 67 20 60 60 67 69 74 20 63 6f 6e 66 69 67 20 2d	or.globally.using.``git.config.-
14b60	2d 67 6c 6f 62 61 6c 60 60 2e 00 49 6e 20 6f 72 64 65 72 20 74 6f 20 72 65 74 72 69 65 76 65 20	-global``..In.order.to.retrieve.
14b80	74 68 65 20 64 65 62 75 67 20 6f 75 74 70 75 74 20 6f 6e 20 74 68 65 20 63 6f 6d 6d 61 6e 64 2d	the.debug.output.on.the.command-
14ba0	6c 69 6e 65 20 79 6f 75 20 6e 65 65 64 20 74 6f 20 64 69 73 61 62 6c 65 20 60 60 76 79 6f 73 2d	line.you.need.to.disable.``vyos-
14bc0	63 6f 6e 66 69 67 64 60 60 20 69 6e 20 61 64 64 69 74 69 6f 6e 2e 20 54 68 69 73 20 63 61 6e 20	configd``.in.addition..This.can.
14be0	62 65 20 72 75 6e 20 65 69 74 68 65 72 20 6f 6e 65 2d 74 69 6d 65 20 62 79 20 63 61 6c 6c 69 6e	be.run.either.one-time.by.callin
14c00	67 20 60 60 73 75 64 6f 20 73 79 73 74 65 6d 63 74 6c 20 73 74 6f 70 20 76 79 6f 73 2d 63 6f 6e	g.``sudo.systemctl.stop.vyos-con
14c20	66 69 67 64 60 60 20 6f 72 20 6d 61 6b 65 20 74 68 69 73 20 72 65 62 6f 6f 74 2d 73 61 66 65 20	figd``.or.make.this.reboot-safe.
14c40	62 79 20 63 61 6c 6c 69 6e 67 20 60 60 73 75 64 6f 20 73 79 73 74 65 6d 63 74 6c 20 64 69 73 61	by.calling.``sudo.systemctl.disa
14c60	62 6c 65 20 76 79 6f 73 2d 63 6f 6e 66 69 67 64 60 60 2e 00 49 6e 20 73 6f 6d 65 20 63 6f 6e 74	ble.vyos-configd``..In.some.cont
14c80	65 78 74 73 2c 20 74 68 65 20 66 69 72 73 74 20 6c 69 6e 65 20 69 73 20 74 72 65 61 74 65 64 20	exts,.the.first.line.is.treated.
14ca0	61 73 20 74 68 65 20 73 75 62 6a 65 63 74 20 6f 66 20 61 6e 20 65 6d 61 69 6c 20 61 6e 64 20 74	as.the.subject.of.an.email.and.t
14cc0	68 65 20 72 65 73 74 20 6f 66 20 74 68 65 20 74 65 78 74 20 61 73 20 74 68 65 20 62 6f 64 79 2e	he.rest.of.the.text.as.the.body.
14ce0	20 54 68 65 20 62 6c 61 6e 6b 20 6c 69 6e 65 20 73 65 70 61 72 61 74 69 6e 67 20 74 68 65 20 73	.The.blank.line.separating.the.s
14d00	75 6d 6d 61 72 79 20 66 72 6f 6d 20 74 68 65 20 62 6f 64 79 20 69 73 20 63 72 69 74 69 63 61 6c	ummary.from.the.body.is.critical
14d20	20 28 75 6e 6c 65 73 73 20 79 6f 75 20 6f 6d 69 74 20 74 68 65 20 62 6f 64 79 20 65 6e 74 69 72	.(unless.you.omit.the.body.entir
14d40	65 6c 79 29 3b 20 74 6f 6f 6c 73 20 6c 69 6b 65 20 72 65 62 61 73 65 20 63 61 6e 20 67 65 74 20	ely);.tools.like.rebase.can.get.
14d60	63 6f 6e 66 75 73 65 64 20 69 66 20 79 6f 75 20 72 75 6e 20 74 68 65 20 74 77 6f 20 74 6f 67 65	confused.if.you.run.the.two.toge
14d80	74 68 65 72 2e 00 49 6e 20 74 68 65 20 65 6e 64 20 79 6f 75 20 77 69 6c 6c 20 62 65 20 70 72 65	ther..In.the.end.you.will.be.pre
14da0	73 65 6e 74 65 64 20 77 69 74 68 20 74 68 65 20 6b 65 72 6e 65 6c 20 62 69 6e 61 72 79 20 70 61	sented.with.the.kernel.binary.pa
14dc0	63 6b 61 67 65 73 20 77 68 69 63 68 20 79 6f 75 20 63 61 6e 20 74 68 65 6e 20 75 73 65 20 69 6e	ckages.which.you.can.then.use.in
14de0	20 79 6f 75 72 20 63 75 73 74 6f 6d 20 49 53 4f 20 62 75 69 6c 64 20 70 72 6f 63 65 73 73 2c 20	.your.custom.ISO.build.process,.
14e00	62 79 20 70 6c 61 63 69 6e 67 20 61 6c 6c 20 74 68 65 20 60 2a 2e 64 65 62 60 20 66 69 6c 65 73	by.placing.all.the.`*.deb`.files
14e20	20 69 6e 20 74 68 65 20 76 79 6f 73 2d 62 75 69 6c 64 2f 70 61 63 6b 61 67 65 73 20 66 6f 6c 64	.in.the.vyos-build/packages.fold
14e40	65 72 20 77 68 65 72 65 20 74 68 65 79 20 77 69 6c 6c 20 62 65 20 75 73 65 64 20 61 75 74 6f 6d	er.where.they.will.be.used.autom
14e60	61 74 69 63 61 6c 6c 79 20 77 68 65 6e 20 62 75 69 6c 64 69 6e 67 20 56 79 4f 53 20 61 73 20 64	atically.when.building.VyOS.as.d
14e80	6f 63 75 6d 65 6e 74 65 64 20 61 62 6f 76 65 2e 00 49 6e 20 74 68 65 20 66 75 74 75 72 65 2c 20	ocumented.above..In.the.future,.
14ea0	77 65 20 6d 61 79 20 73 77 69 74 63 68 20 74 6f 20 75 73 69 6e 67 20 73 79 73 74 65 6d 64 20 69	we.may.switch.to.using.systemd.i
14ec0	6e 66 72 61 73 74 72 75 63 74 75 72 65 20 69 6e 73 74 65 61 64 2e 20 42 75 69 6c 64 69 6e 67 20	nfrastructure.instead..Building.
14ee0	69 74 20 64 6f 65 73 6e 27 74 20 72 65 71 75 69 72 65 20 61 20 73 70 65 63 69 61 6c 20 70 72 6f	it.doesn't.require.a.special.pro
14f00	63 65 64 75 72 65 2e 00 49 6e 63 6c 75 64 65 20 6f 75 74 70 75 74 00 49 6e 73 65 72 74 20 74 68	cedure..Include.output.Insert.th
14f20	65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 61 74 65 6d 65 6e 74 20 72 69 67 68 74 20 62 65 66 6f	e.following.statement.right.befo
14f40	72 65 20 74 68 65 20 73 65 63 74 69 6f 6e 20 77 68 65 72 65 20 79 6f 75 20 77 61 6e 74 20 74 6f	re.the.section.where.you.want.to
14f60	20 69 6e 76 65 73 74 69 67 61 74 65 20 61 20 70 72 6f 62 6c 65 6d 20 28 65 2e 67 2e 20 61 20 73	.investigate.a.problem.(e.g..a.s
14f80	74 61 74 65 6d 65 6e 74 20 79 6f 75 20 73 65 65 20 69 6e 20 61 20 62 61 63 6b 74 72 61 63 65 29	tatement.you.see.in.a.backtrace)
14fa0	3a 20 60 60 69 6d 70 6f 72 74 20 70 64 62 3b 20 70 64 62 2e 73 65 74 5f 74 72 61 63 65 28 29 60	:.``import.pdb;.pdb.set_trace()`
14fc0	60 20 4f 70 74 69 6f 6e 61 6c 6c 79 20 79 6f 75 20 63 61 6e 20 73 75 72 72 6f 75 6e 64 65 64 20	`.Optionally.you.can.surrounded.
14fe0	74 68 69 73 20 73 74 61 74 65 6d 65 6e 74 20 62 79 20 61 6e 20 60 60 69 66 60 60 20 77 68 69 63	this.statement.by.an.``if``.whic
15000	68 20 6f 6e 6c 79 20 74 72 69 67 67 65 72 73 20 75 6e 64 65 72 20 74 68 65 20 63 6f 6e 64 69 74	h.only.triggers.under.the.condit
15020	69 6f 6e 20 79 6f 75 20 61 72 65 20 69 6e 74 65 72 65 73 74 65 64 20 69 6e 2e 00 49 6e 73 74 61	ion.you.are.interested.in..Insta
15040	6c 6c 00 49 6e 73 74 61 6c 6c 20 68 74 74 70 73 3a 2f 2f 70 79 70 69 2e 6f 72 67 2f 70 72 6f 6a	ll.Install.https://pypi.org/proj
15060	65 63 74 2f 73 74 64 65 62 2f 00 49 6e 73 74 61 6c 6c 69 6e 67 20 44 6f 63 6b 65 72 5f 20 61 6e	ect/stdeb/.Installing.Docker_.an
15080	64 20 70 72 65 72 65 71 75 69 73 69 74 65 73 3a 00 49 6e 73 74 65 61 64 20 6f 66 20 73 75 70 70	d.prerequisites:.Instead.of.supp
150a0	6c 79 69 6e 67 20 61 6c 6c 20 74 68 6f 73 65 20 58 4d 4c 20 6e 6f 64 65 73 20 6d 75 6c 74 69 70	lying.all.those.XML.nodes.multip
150c0	6c 65 20 74 69 6d 65 73 20 74 68 65 72 65 20 61 72 65 20 6e 6f 77 20 69 6e 63 6c 75 64 65 20 66	le.times.there.are.now.include.f
150e0	69 6c 65 73 20 77 69 74 68 20 70 72 65 64 65 66 69 6e 65 64 20 66 65 61 74 75 72 65 73 2e 20 42	iles.with.predefined.features..B
15100	72 69 65 66 20 6f 76 65 72 76 69 65 77 3a 00 49 6e 74 65 6c 20 4e 49 43 00 49 6e 74 65 6c 20 4e	rief.overview:.Intel.NIC.Intel.N
15120	49 43 20 64 72 69 76 65 72 73 00 49 6e 74 65 6c 20 51 41 54 00 49 6e 74 65 72 20 51 41 54 00 49	IC.drivers.Intel.QAT.Inter.QAT.I
15140	6e 74 65 72 66 61 63 65 20 62 61 73 65 64 20 74 65 73 74 73 00 49 73 20 74 68 65 20 66 65 61 74	nterface.based.tests.Is.the.feat
15160	75 72 65 20 73 75 70 70 6f 72 74 65 64 20 62 79 20 74 68 65 20 75 6e 64 65 72 6c 79 69 6e 67 20	ure.supported.by.the.underlying.
15180	63 6f 6d 70 6f 6e 65 6e 74 20 28 46 72 65 65 52 61 6e 67 65 52 6f 75 74 69 6e 67 2c 20 6e 66 74	component.(FreeRangeRouting,.nft
151a0	61 62 6c 65 73 2c 20 4b 65 61 2e 2e 2e 29 20 61 6c 72 65 61 64 79 3f 00 49 73 73 75 65 73 20 6f	ables,.Kea...).already?.Issues.o
151c0	72 20 62 75 67 73 20 61 72 65 20 66 6f 75 6e 64 20 69 6e 20 61 6e 79 20 73 6f 66 74 77 61 72 65	r.bugs.are.found.in.any.software
151e0	20 70 72 6f 6a 65 63 74 2e 20 56 79 4f 53 20 69 73 20 6e 6f 74 20 61 6e 20 65 78 63 65 70 74 69	.project..VyOS.is.not.an.excepti
15200	6f 6e 2e 00 49 73 73 75 65 73 2f 46 65 61 74 75 72 65 20 72 65 71 75 65 73 74 73 00 49 74 20 69	on..Issues/Feature.requests.It.i
15220	73 20 61 6c 73 6f 20 70 6f 73 73 69 62 6c 65 20 74 6f 20 73 65 74 20 75 70 20 74 68 65 20 64 65	s.also.possible.to.set.up.the.de
15240	62 75 67 67 69 6e 67 20 75 73 69 6e 67 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 76 61 72 69 61 62	bugging.using.environment.variab
15260	6c 65 73 2e 20 49 6e 20 74 68 61 74 20 63 61 73 65 2c 20 74 68 65 20 6e 61 6d 65 20 77 69 6c 6c	les..In.that.case,.the.name.will
15280	20 62 65 20 28 69 6e 20 75 70 70 65 72 63 61 73 65 29 20 56 59 4f 53 5f 46 45 41 54 55 52 45 5f	.be.(in.uppercase).VYOS_FEATURE_
152a0	44 45 42 55 47 2e 00 49 74 27 73 20 61 6e 20 41 64 61 20 70 72 6f 67 72 61 6d 20 61 6e 64 20 72	DEBUG..It's.an.Ada.program.and.r
152c0	65 71 75 69 72 65 73 20 47 4e 41 54 20 61 6e 64 20 67 70 72 62 75 69 6c 64 20 66 6f 72 20 62 75	equires.GNAT.and.gprbuild.for.bu
152e0	69 6c 64 69 6e 67 2c 20 64 65 70 65 6e 64 65 6e 63 69 65 73 20 61 72 65 20 70 72 6f 70 65 72 6c	ilding,.dependencies.are.properl
15300	79 20 73 70 65 63 69 66 69 65 64 20 73 6f 20 6a 75 73 74 20 66 6f 6c 6c 6f 77 20 64 65 62 75 69	y.specified.so.just.follow.debui
15320	6c 64 27 73 20 73 75 67 67 65 73 74 69 6f 6e 73 2e 00 49 74 27 73 20 66 69 6e 65 20 69 66 20 79	ld's.suggestions..It's.fine.if.y
15340	6f 75 20 63 61 6e 6e 6f 74 20 70 72 6f 76 69 64 65 20 73 6f 6d 65 20 6f 66 20 74 68 61 74 20 69	ou.cannot.provide.some.of.that.i
15360	6e 66 6f 72 6d 61 74 69 6f 6e 2c 20 62 75 74 20 69 66 20 79 6f 75 20 63 61 6e 2c 20 69 74 20 6d	nformation,.but.if.you.can,.it.m
15380	61 6b 65 73 20 74 68 65 20 77 6f 72 6b 20 6f 66 20 64 65 76 65 6c 6f 70 65 72 73 20 63 6f 6e 73	akes.the.work.of.developers.cons
153a0	69 64 65 72 61 62 6c 79 20 73 69 6d 70 6c 65 72 2c 20 73 6f 20 74 72 79 20 74 6f 20 64 6f 20 74	iderably.simpler,.so.try.to.do.t
153c0	68 65 20 72 65 73 65 61 72 63 68 20 74 6f 20 61 6e 73 77 65 72 20 74 68 6f 73 65 20 71 75 65 73	he.research.to.answer.those.ques
153e0	74 69 6f 6e 73 2e 00 4a 65 6e 6b 69 6e 73 20 43 49 00 4a 75 73 74 20 69 6e 73 74 61 6c 6c 20 75	tions..Jenkins.CI.Just.install.u
15400	73 69 6e 67 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 63 6f 6d 6d 61 6e 64 73 3a 00 4b 65 65	sing.the.following.commands:.Kee
15420	70 20 74 72 61 63 6b 20 6f 66 20 74 68 65 20 70 72 6f 67 72 65 73 73 20 28 77 68 61 74 20 77 65	p.track.of.the.progress.(what.we
15440	27 76 65 20 61 6c 72 65 61 64 79 20 64 6f 6e 65 20 69 6e 20 74 68 69 73 20 62 72 61 6e 63 68 20	've.already.done.in.this.branch.
15460	61 6e 64 20 77 68 61 74 20 77 65 20 73 74 69 6c 6c 20 6e 65 65 64 20 74 6f 20 64 6f 29 2e 00 4b	and.what.we.still.need.to.do)..K
15480	65 65 70 61 6c 69 76 65 64 20 6e 6f 72 6d 61 6c 6c 79 20 69 73 6e 27 74 20 75 70 64 61 74 65 64	eepalived.normally.isn't.updated
154a0	20 74 6f 20 6e 65 77 65 72 20 66 65 61 74 75 72 65 20 72 65 6c 65 61 73 65 73 20 62 65 74 77 65	.to.newer.feature.releases.betwe
154c0	65 6e 20 44 65 62 69 61 6e 20 76 65 72 73 69 6f 6e 73 2c 20 73 6f 20 77 65 20 61 72 65 20 62 75	en.Debian.versions,.so.we.are.bu
154e0	69 6c 64 69 6e 67 20 69 74 20 66 72 6f 6d 20 73 6f 75 72 63 65 2e 00 4b 65 72 6e 65 6c 00 4c 61	ilding.it.from.source..Kernel.La
15500	75 6e 63 68 20 44 6f 63 6b 65 72 20 63 6f 6e 74 61 69 6e 65 72 20 61 6e 64 20 62 75 69 6c 64 20	unch.Docker.container.and.build.
15520	70 61 63 6b 61 67 65 00 4c 65 61 66 20 6e 6f 64 65 73 20 28 6e 6f 64 65 73 20 77 69 74 68 20 76	package.Leaf.nodes.(nodes.with.v
15540	61 6c 75 65 73 29 20 75 73 65 20 3c 6c 65 61 66 4e 6f 64 65 3e 20 74 61 67 20 69 6e 73 74 65 61	alues).use.<leafNode>.tag.instea
15560	64 00 4c 65 74 20 75 73 20 61 73 73 75 6d 65 20 79 6f 75 20 77 61 6e 74 20 74 6f 20 64 65 62 75	d.Let.us.assume.you.want.to.debu
15580	67 20 61 20 50 79 74 68 6f 6e 20 73 63 72 69 70 74 20 74 68 61 74 20 69 73 20 63 61 6c 6c 65 64	g.a.Python.script.that.is.called
155a0	20 62 79 20 61 6e 20 6f 70 2d 6d 6f 64 65 20 63 6f 6d 6d 61 6e 64 2e 20 41 66 74 65 72 20 79 6f	.by.an.op-mode.command..After.yo
155c0	75 20 66 6f 75 6e 64 20 74 68 65 20 73 63 72 69 70 74 20 62 79 20 6c 6f 6f 6b 69 6e 67 20 75 70	u.found.the.script.by.looking.up
155e0	20 74 68 65 20 6f 70 2d 6d 6f 64 65 2d 64 65 66 69 74 69 6f 6e 73 20 79 6f 75 20 63 61 6e 20 65	.the.op-mode-defitions.you.can.e
15600	64 69 74 20 74 68 65 20 73 63 72 69 70 74 20 69 6e 20 74 68 65 20 6c 69 76 65 20 73 79 73 74 65	dit.the.script.in.the.live.syste
15620	6d 20 75 73 69 6e 67 20 65 2e 67 2e 20 76 69 3a 20 60 60 76 69 20 2f 75 73 72 2f 6c 69 62 65 78	m.using.e.g..vi:.``vi./usr/libex
15640	65 63 2f 76 79 6f 73 2f 6f 70 5f 6d 6f 64 65 2f 73 68 6f 77 5f 78 79 7a 2e 70 79 60 60 00 4c 65	ec/vyos/op_mode/show_xyz.py``.Le
15660	74 27 73 20 66 61 63 65 20 69 74 3a 20 56 79 4f 53 20 69 73 20 66 75 6c 6c 20 6f 66 20 73 70 61	t's.face.it:.VyOS.is.full.of.spa
15680	67 68 65 74 74 69 20 63 6f 64 65 20 77 68 65 72 65 20 6c 6f 67 69 63 20 66 6f 72 20 72 65 61 64	ghetti.code.where.logic.for.read
156a0	69 6e 67 20 74 68 65 20 56 79 4f 53 20 63 6f 6e 66 69 67 2c 20 67 65 6e 65 72 61 74 69 6e 67 20	ing.the.VyOS.config,.generating.
156c0	64 61 65 6d 6f 6e 20 63 6f 6e 66 69 67 73 2c 20 61 6e 64 20 72 65 73 74 61 72 74 69 6e 67 20 70	daemon.configs,.and.restarting.p
156e0	72 6f 63 65 73 73 65 73 20 69 73 20 61 6c 6c 20 6d 69 78 65 64 20 75 70 2e 00 4c 69 6b 65 20 61	rocesses.is.all.mixed.up..Like.a
15700	6e 79 20 6f 74 68 65 72 20 70 72 6f 6a 65 63 74 20 77 65 20 68 61 76 65 20 73 6f 6d 65 20 73 6d	ny.other.project.we.have.some.sm
15720	61 6c 6c 20 67 75 69 64 65 6c 69 6e 65 73 20 61 62 6f 75 74 20 6f 75 72 20 73 6f 75 72 63 65 20	all.guidelines.about.our.source.
15740	63 6f 64 65 2c 20 74 6f 6f 2e 20 54 68 65 20 72 75 6c 65 73 20 77 65 20 68 61 76 65 20 61 72 65	code,.too..The.rules.we.have.are
15760	20 6e 6f 74 20 74 68 65 72 65 20 74 6f 20 70 75 6e 69 73 68 20 79 6f 75 20 2d 20 74 68 65 20 72	.not.there.to.punish.you.-.the.r
15780	75 6c 65 73 20 61 72 65 20 69 6e 20 70 6c 61 63 65 20 74 6f 20 68 65 6c 70 20 75 73 20 61 6c 6c	ules.are.in.place.to.help.us.all
157a0	2e 20 42 79 20 68 61 76 69 6e 67 20 61 20 63 6f 6e 73 69 73 74 65 6e 74 20 63 6f 64 69 6e 67 20	..By.having.a.consistent.coding.
157c0	73 74 79 6c 65 20 69 74 20 62 65 63 6f 6d 65 73 20 76 65 72 79 20 65 61 73 79 20 66 6f 72 20 6e	style.it.becomes.very.easy.for.n
157e0	65 77 20 61 6e 64 20 61 6c 73 6f 20 6c 6f 6e 67 74 69 6d 65 20 63 6f 6e 74 72 69 62 75 74 6f 72	ew.and.also.longtime.contributor
15800	73 20 74 6f 20 6e 61 76 69 67 61 74 65 20 74 68 72 6f 75 67 68 20 74 68 65 20 73 6f 75 72 63 65	s.to.navigate.through.the.source
15820	73 20 61 6e 64 20 61 6c 6c 20 74 68 65 20 69 6d 70 6c 69 65 64 20 6c 6f 67 69 63 20 6f 66 20 61	s.and.all.the.implied.logic.of.a
15840	6e 79 20 6f 6e 65 20 73 6f 75 72 63 65 20 66 69 6c 65 2e 2e 00 4c 69 6d 69 74 73 3a 00 4c 69 6e	ny.one.source.file...Limits:.Lin
15860	75 78 20 4b 65 72 6e 65 6c 00 4c 69 76 65 20 53 79 73 74 65 6d 00 4d 54 55 20 73 69 7a 65 00 4d	ux.Kernel.Live.System.MTU.size.M
15880	61 6b 65 20 79 6f 75 72 20 63 68 61 6e 67 65 73 20 61 6e 64 20 73 61 76 65 20 74 68 65 6d 2e 20	ake.your.changes.and.save.them..
158a0	44 6f 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 66 6f 72 20 61 6c 6c 20 63 68 61 6e 67 65 73	Do.the.following.for.all.changes
158c0	20 66 69 6c 65 73 20 74 6f 20 72 65 63 6f 72 64 20 74 68 65 6d 20 69 6e 20 79 6f 75 72 20 63 72	.files.to.record.them.in.your.cr
158e0	65 61 74 65 64 20 47 69 74 20 63 6f 6d 6d 69 74 3a 00 4d 61 6e 75 61 6c 20 53 6d 6f 6b 65 74 65	eated.Git.commit:.Manual.Smokete
15900	73 74 20 52 75 6e 00 4d 61 6e 75 61 6c 20 63 6f 6e 66 69 67 20 6c 6f 61 64 20 74 65 73 74 00 4d	st.Run.Manual.config.load.test.M
15920	61 6e 79 20 62 61 73 65 20 73 79 73 74 65 6d 20 70 61 63 6b 61 67 65 73 20 61 72 65 20 70 75 6c	any.base.system.packages.are.pul
15940	6c 65 64 20 73 74 72 61 69 67 68 74 20 66 72 6f 6d 20 44 65 62 69 61 6e 27 73 20 6d 61 69 6e 20	led.straight.from.Debian's.main.
15960	61 6e 64 20 63 6f 6e 74 72 69 62 20 72 65 70 6f 73 69 74 6f 72 69 65 73 2c 20 62 75 74 20 74 68	and.contrib.repositories,.but.th
15980	65 72 65 20 61 72 65 20 65 78 63 65 70 74 69 6f 6e 73 2e 00 4d 65 6c 6c 61 6e 6f 78 20 4f 46 45	ere.are.exceptions..Mellanox.OFE
159a0	44 00 4d 69 67 72 61 74 69 6e 67 20 6f 6c 64 20 43 4c 49 00 4d 6f 76 65 20 64 65 66 61 75 6c 74	D.Migrating.old.CLI.Move.default
159c0	20 76 61 6c 75 65 73 20 74 6f 20 73 63 72 69 70 74 73 00 4e 61 74 69 76 65 20 42 75 69 6c 64 00	.values.to.scripts.Native.Build.
159e0	4e 65 77 20 73 79 6e 74 61 78 00 4e 6f 20 63 6f 64 65 20 69 6e 63 6f 6d 70 61 74 69 62 6c 65 20	New.syntax.No.code.incompatible.
15a00	77 69 74 68 20 50 79 74 68 6f 6e 33 00 4e 6f 20 6e 65 77 20 66 65 61 74 75 72 65 73 20 69 6e 20	with.Python3.No.new.features.in.
15a20	50 65 72 6c 00 4e 6f 20 6f 6c 64 20 73 74 79 6c 65 20 63 6f 6d 6d 61 6e 64 20 64 65 66 69 6e 69	Perl.No.old.style.command.defini
15a40	74 69 6f 6e 73 00 4e 6f 20 73 70 65 63 69 61 6c 20 62 75 69 6c 64 20 70 72 6f 63 65 64 75 72 65	tions.No.special.build.procedure
15a60	20 69 73 20 72 65 71 75 69 72 65 64 2e 00 4e 6f 6e 65 00 4e 6f 74 65 73 00 4e 6f 77 20 61 20 66	.is.required..None.Notes.Now.a.f
15a80	72 65 73 68 20 62 75 69 6c 64 20 6f 66 20 74 68 65 20 56 79 4f 53 20 49 53 4f 20 63 61 6e 20 62	resh.build.of.the.VyOS.ISO.can.b
15aa0	65 67 69 6e 2e 20 43 68 61 6e 67 65 20 64 69 72 65 63 74 6f 72 79 20 74 6f 20 74 68 65 20 60 60	egin..Change.directory.to.the.``
15ac0	76 79 6f 73 2d 62 75 69 6c 64 60 60 20 64 69 72 65 63 74 6f 72 79 20 61 6e 64 20 72 75 6e 3a 00	vyos-build``.directory.and.run:.
15ae0	4e 6f 77 20 61 73 20 79 6f 75 20 61 72 65 20 61 77 61 72 65 20 6f 66 20 74 68 65 20 70 72 65 72	Now.as.you.are.aware.of.the.prer
15b00	65 71 75 69 73 69 74 65 73 20 77 65 20 63 61 6e 20 63 6f 6e 74 69 6e 75 65 20 61 6e 64 20 62 75	equisites.we.can.continue.and.bu
15b20	69 6c 64 20 6f 75 72 20 6f 77 6e 20 49 53 4f 20 66 72 6f 6d 20 73 6f 75 72 63 65 2e 20 46 6f 72	ild.our.own.ISO.from.source..For
15b40	20 74 68 69 73 20 77 65 20 68 61 76 65 20 74 6f 20 66 65 74 63 68 20 74 68 65 20 6c 61 74 65 73	.this.we.have.to.fetch.the.lates
15b60	74 20 73 6f 75 72 63 65 20 63 6f 64 65 20 66 72 6f 6d 20 47 69 74 48 75 62 2e 20 50 6c 65 61 73	t.source.code.from.GitHub..Pleas
15b80	65 20 6e 6f 74 65 20 61 73 20 74 68 69 73 20 77 69 6c 6c 20 64 69 66 66 65 72 20 66 6f 72 20 62	e.note.as.this.will.differ.for.b
15ba0	6f 74 68 20 60 63 75 72 72 65 6e 74 60 20 61 6e 64 20 60 63 72 75 78 60 2e 00 4e 6f 77 20 69 74	oth.`current`.and.`crux`..Now.it
15bc0	27 73 20 74 69 6d 65 20 74 6f 20 66 69 78 20 74 68 65 20 70 61 63 6b 61 67 65 20 6d 69 72 72 6f	's.time.to.fix.the.package.mirro
15be0	72 20 61 6e 64 20 72 65 72 75 6e 20 74 68 65 20 6c 61 73 74 20 73 74 65 70 20 75 6e 74 69 6c 20	r.and.rerun.the.last.step.until.
15c00	74 68 65 20 70 61 63 6b 61 67 65 20 69 6e 73 74 61 6c 6c 61 74 69 6f 6e 20 73 75 63 63 65 65 64	the.package.installation.succeed
15c20	73 20 61 67 61 69 6e 21 00 4e 6f 77 20 77 65 20 63 61 6e 20 75 73 65 20 74 68 65 20 68 65 6c 70	s.again!.Now.we.can.use.the.help
15c40	65 72 20 73 63 72 69 70 74 20 60 60 62 75 69 6c 64 2d 6b 65 72 6e 65 6c 2e 73 68 60 60 20 77 68	er.script.``build-kernel.sh``.wh
15c60	69 63 68 20 64 6f 65 73 20 61 6c 6c 20 74 68 65 20 6e 65 63 65 73 73 61 72 79 20 76 6f 6f 64 6f	ich.does.all.the.necessary.voodo
15c80	6f 20 62 79 20 61 70 70 6c 79 69 6e 67 20 72 65 71 75 69 72 65 64 20 70 61 74 63 68 65 73 20 66	o.by.applying.required.patches.f
15ca0	72 6f 6d 20 74 68 65 20 60 76 79 6f 73 2d 62 75 69 6c 64 2f 70 61 63 6b 61 67 65 73 2f 6c 69 6e	rom.the.`vyos-build/packages/lin
15cc0	75 78 2d 6b 65 72 6e 65 6c 2f 70 61 74 63 68 65 73 60 20 66 6f 6c 64 65 72 2c 20 63 6f 70 79 69	ux-kernel/patches`.folder,.copyi
15ce0	6e 67 20 6f 75 72 20 6b 65 72 6e 65 6c 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 60 60 78 38	ng.our.kernel.configuration.``x8
15d00	36 5f 36 34 5f 76 79 6f 73 5f 64 65 66 63 6f 6e 66 69 67 60 60 20 74 6f 20 74 68 65 20 72 69 67	6_64_vyos_defconfig``.to.the.rig
15d20	68 74 20 6c 6f 63 61 74 69 6f 6e 2c 20 61 6e 64 20 66 69 6e 61 6c 6c 79 20 62 75 69 6c 64 69 6e	ht.location,.and.finally.buildin
15d40	67 20 74 68 65 20 44 65 62 69 61 6e 20 70 61 63 6b 61 67 65 73 2e 00 4e 6f 77 20 79 6f 75 20 61	g.the.Debian.packages..Now.you.a
15d60	72 65 20 70 72 65 70 61 72 65 64 20 77 69 74 68 20 74 77 6f 20 6e 65 77 20 61 6c 69 61 73 65 73	re.prepared.with.two.new.aliases
15d80	20 60 60 76 79 62 6c 64 60 60 20 61 6e 64 20 60 60 76 79 62 6c 64 5f 63 72 75 78 60 60 20 74 6f	.``vybld``.and.``vybld_crux``.to
15da0	20 73 70 61 77 6e 20 79 6f 75 72 20 64 65 76 65 6c 6f 70 6d 65 6e 74 20 63 6f 6e 74 61 69 6e 65	.spawn.your.development.containe
15dc0	72 73 20 69 6e 20 79 6f 75 72 20 63 75 72 72 65 6e 74 20 77 6f 72 6b 69 6e 67 20 64 69 72 65 63	rs.in.your.current.working.direc
15de0	74 6f 72 79 2e 00 4f 6c 64 20 63 6f 6e 63 65 70 74 2f 73 79 6e 74 61 78 00 4f 6e 20 74 68 65 20	tory..Old.concept/syntax.On.the.
15e00	6f 74 68 65 72 20 68 61 6e 64 20 2d 20 61 73 20 65 61 63 68 20 74 65 73 74 20 69 73 20 63 6f 6e	other.hand.-.as.each.test.is.con
15e20	74 61 69 6e 20 69 6e 20 69 74 73 20 6f 77 6e 20 66 69 6c 65 20 2d 20 6f 6e 65 20 63 61 6e 20 61	tain.in.its.own.file.-.one.can.a
15e40	6c 77 61 79 73 20 65 78 65 63 75 74 65 20 61 20 73 69 6e 67 6c 65 20 53 6d 6f 6b 65 74 65 73 74	lways.execute.a.single.Smoketest
15e60	20 62 79 20 68 61 6e 64 20 62 79 20 73 69 6d 70 6c 79 20 72 75 6e 6e 69 6e 67 20 74 68 65 20 50	.by.hand.by.simply.running.the.P
15e80	79 74 68 6f 6e 20 74 65 73 74 20 73 63 72 69 70 74 73 2e 00 4f 6e 63 65 20 79 6f 75 20 68 61 76	ython.test.scripts..Once.you.hav
15ea0	65 20 74 68 65 20 72 65 71 75 69 72 65 64 20 64 65 70 65 6e 64 65 6e 63 69 65 73 20 69 6e 73 74	e.the.required.dependencies.inst
15ec0	61 6c 6c 65 64 2c 20 79 6f 75 20 6d 61 79 20 70 72 6f 63 65 65 64 20 77 69 74 68 20 74 68 65 20	alled,.you.may.proceed.with.the.
15ee0	73 74 65 70 73 20 64 65 73 63 72 69 62 65 64 20 69 6e 20 3a 72 65 66 3a 60 62 75 69 6c 64 5f 69	steps.described.in.:ref:`build_i
15f00	73 6f 60 2e 00 4f 6e 63 65 20 79 6f 75 20 72 75 6e 20 60 60 73 68 6f 77 20 78 79 7a 60 60 20 61	so`..Once.you.run.``show.xyz``.a
15f20	6e 64 20 79 6f 75 72 20 63 6f 6e 64 69 74 69 6f 6e 20 69 73 20 74 72 69 67 67 65 72 65 64 20 79	nd.your.condition.is.triggered.y
15f40	6f 75 20 73 68 6f 75 6c 64 20 62 65 20 64 72 6f 70 70 65 64 20 69 6e 74 6f 20 74 68 65 20 70 79	ou.should.be.dropped.into.the.py
15f60	74 68 6f 6e 20 64 65 62 75 67 67 65 72 3a 00 4f 6e 65 20 69 73 20 6e 6f 74 20 62 6f 75 6e 64 20	thon.debugger:.One.is.not.bound.
15f80	74 6f 20 6c 6f 61 64 20 61 6c 6c 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 73 20 6f 6e 65 20 61	to.load.all.configurations.one.a
15fa0	66 74 65 72 20 61 6e 6f 74 68 65 72 20 62 75 74 20 63 61 6e 20 61 6c 73 6f 20 6c 6f 61 64 20 69	fter.another.but.can.also.load.i
15fc0	6e 64 69 76 69 64 75 61 6c 20 74 65 73 74 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 73 20 6f 6e	ndividual.test.configurations.on
15fe0	20 68 69 73 20 6f 77 6e 2e 00 4f 6e 65 20 6f 66 20 74 68 65 20 6d 61 6a 6f 72 20 61 64 76 61 6e	.his.own..One.of.the.major.advan
16000	74 61 67 65 73 20 69 6e 74 72 6f 64 75 63 65 64 20 69 6e 20 56 79 4f 53 20 31 2e 33 20 69 73 20	tages.introduced.in.VyOS.1.3.is.
16020	61 6e 20 61 75 74 6d 61 74 65 64 20 74 65 73 74 20 66 72 61 6d 65 77 6f 72 6b 2e 20 57 68 65 6e	an.autmated.test.framework..When
16040	20 61 73 73 65 6d 62 6c 69 6e 67 20 61 6e 20 49 53 4f 20 69 6d 61 67 65 20 6d 75 6c 74 69 70 6c	.assembling.an.ISO.image.multipl
16060	65 20 74 68 69 6e 67 73 20 63 61 6e 20 67 6f 20 77 72 6f 6e 67 20 62 61 64 6c 79 20 61 6e 64 20	e.things.can.go.wrong.badly.and.
16080	70 75 62 6c 69 73 68 69 6e 67 20 61 20 66 61 75 6c 74 79 20 49 53 4f 20 6d 61 6b 65 73 20 6e 6f	publishing.a.faulty.ISO.makes.no
160a0	20 73 65 6e 73 65 2e 20 54 68 65 20 75 73 65 72 20 69 73 20 64 69 73 61 70 70 6f 69 6e 74 65 64	.sense..The.user.is.disappointed
160c0	20 62 79 20 74 68 65 20 71 75 61 6c 69 74 79 20 6f 66 20 74 68 65 20 69 6d 61 67 65 20 61 6e 64	.by.the.quality.of.the.image.and
160e0	20 74 68 65 20 64 65 76 65 6c 6f 70 65 72 73 20 67 65 74 20 66 6c 6f 64 64 65 64 20 77 69 74 68	.the.developers.get.flodded.with
16100	20 62 75 67 20 72 65 70 6f 72 74 73 20 6f 76 65 72 20 61 6e 64 20 6f 76 65 72 20 61 67 61 69 6e	.bug.reports.over.and.over.again
16120	2e 00 4f 6e 65 20 6f 66 20 74 68 65 20 6d 61 6a 6f 72 20 61 64 76 61 6e 74 61 67 65 73 20 69 6e	..One.of.the.major.advantages.in
16140	74 72 6f 64 75 63 65 64 20 69 6e 20 56 79 4f 53 20 31 2e 33 20 69 73 20 61 6e 20 61 75 74 6f 6d	troduced.in.VyOS.1.3.is.an.autom
16160	61 74 65 64 20 74 65 73 74 20 66 72 61 6d 65 77 6f 72 6b 2e 20 57 68 65 6e 20 61 73 73 65 6d 62	ated.test.framework..When.assemb
16180	6c 69 6e 67 20 61 6e 20 49 53 4f 20 69 6d 61 67 65 20 6d 75 6c 74 69 70 6c 65 20 74 68 69 6e 67	ling.an.ISO.image.multiple.thing
161a0	73 20 63 61 6e 20 67 6f 20 77 72 6f 6e 67 20 62 61 64 6c 79 20 61 6e 64 20 70 75 62 6c 69 73 68	s.can.go.wrong.badly.and.publish
161c0	69 6e 67 20 61 20 66 61 75 6c 74 79 20 49 53 4f 20 6d 61 6b 65 73 20 6e 6f 20 73 65 6e 73 65 2e	ing.a.faulty.ISO.makes.no.sense.
161e0	20 54 68 65 20 75 73 65 72 20 69 73 20 64 69 73 61 70 70 6f 69 6e 74 65 64 20 62 79 20 74 68 65	.The.user.is.disappointed.by.the
16200	20 71 75 61 6c 69 74 79 20 6f 66 20 74 68 65 20 69 6d 61 67 65 20 61 6e 64 20 74 68 65 20 64 65	.quality.of.the.image.and.the.de
16220	76 65 6c 6f 70 65 72 73 20 67 65 74 20 66 6c 6f 64 64 65 64 20 77 69 74 68 20 62 75 67 20 72 65	velopers.get.flodded.with.bug.re
16240	70 6f 72 74 73 20 6f 76 65 72 20 61 6e 64 20 6f 76 65 72 20 61 67 61 69 6e 2e 00 4f 6e 6c 79 20	ports.over.and.over.again..Only.
16260	61 70 70 6c 69 63 61 62 6c 65 20 74 6f 20 6c 65 61 66 20 6e 6f 64 65 73 00 4f 74 68 65 72 20 70	applicable.to.leaf.nodes.Other.p
16280	61 63 6b 61 67 65 73 20 28 65 2e 67 2e 20 76 79 6f 73 2d 31 78 29 20 61 64 64 20 64 65 70 65 6e	ackages.(e.g..vyos-1x).add.depen
162a0	64 65 6e 63 69 65 73 20 74 6f 20 74 68 65 20 49 53 4f 20 62 75 69 6c 64 20 70 72 6f 63 65 64 75	dencies.to.the.ISO.build.procedu
162c0	72 65 20 6f 6e 20 65 2e 67 2e 20 74 68 65 20 77 69 72 65 67 75 61 72 64 2d 6d 6f 64 75 6c 65 73	re.on.e.g..the.wireguard-modules
162e0	20 70 61 63 6b 61 67 65 20 77 68 69 63 68 20 69 74 73 65 6c 66 20 61 64 64 73 20 61 20 64 65 70	.package.which.itself.adds.a.dep
16300	65 6e 64 65 6e 63 79 20 6f 6e 20 74 68 65 20 6b 65 72 6e 65 6c 20 76 65 72 73 69 6f 6e 20 75 73	endency.on.the.kernel.version.us
16320	65 64 20 64 75 65 20 74 6f 20 74 68 65 20 6d 6f 64 75 6c 65 20 69 74 20 73 68 69 70 73 2e 20 54	ed.due.to.the.module.it.ships..T
16340	68 69 73 20 6d 61 79 20 63 68 61 6e 67 65 20 28 66 6f 72 20 57 69 72 65 47 75 61 72 64 29 20 69	his.may.change.(for.WireGuard).i
16360	6e 20 66 75 74 75 72 65 20 6b 65 72 6e 65 6c 20 72 65 6c 65 61 73 65 73 20 62 75 74 20 61 73 20	n.future.kernel.releases.but.as.
16380	6c 6f 6e 67 20 61 73 20 77 65 20 68 61 76 65 20 6f 75 74 2d 6f 66 2d 74 72 65 65 20 6d 6f 64 75	long.as.we.have.out-of-tree.modu
163a0	6c 65 73 2e 00 4f 75 72 20 53 74 72 6f 6e 67 53 57 41 4e 20 62 75 69 6c 64 20 64 69 66 66 65 72	les..Our.StrongSWAN.build.differ
163c0	73 20 66 72 6f 6d 20 74 68 65 20 75 70 73 74 72 65 61 6d 3a 00 4f 75 72 20 60 56 79 4f 53 20 43	s.from.the.upstream:.Our.`VyOS.C
163e0	49 60 5f 20 73 79 73 74 65 6d 20 69 73 20 62 61 73 65 64 20 6f 6e 20 4a 65 6e 6b 69 6e 73 20 61	I`_.system.is.based.on.Jenkins.a
16400	6e 64 20 62 75 69 6c 64 73 20 61 6c 6c 20 6f 75 72 20 72 65 71 75 69 72 65 64 20 70 61 63 6b 61	nd.builds.all.our.required.packa
16420	67 65 73 20 66 6f 72 20 56 79 4f 53 20 31 2e 32 20 74 6f 20 31 2e 34 2e 20 49 6e 20 61 64 64 69	ges.for.VyOS.1.2.to.1.4..In.addi
16440	74 69 6f 6e 20 74 6f 20 74 68 65 20 70 61 63 6b 61 67 65 20 62 75 69 6c 64 2c 20 74 68 65 72 65	tion.to.the.package.build,.there
16460	20 69 73 20 74 68 65 20 76 79 6f 73 2d 62 75 69 6c 64 20 4a 6f 62 20 77 68 69 63 68 20 62 75 69	.is.the.vyos-build.Job.which.bui
16480	6c 64 73 20 61 6e 64 20 74 65 73 74 73 20 74 68 65 20 56 79 4f 53 20 49 53 4f 20 69 6d 61 67 65	lds.and.tests.the.VyOS.ISO.image
164a0	20 77 68 69 63 68 20 69 73 20 70 75 62 6c 69 73 68 65 64 20 61 66 74 65 72 20 61 20 73 75 63 63	.which.is.published.after.a.succ
164c0	65 73 73 66 75 6c 20 74 65 73 74 20 64 72 69 76 65 2e 00 4f 75 72 20 60 56 79 4f 53 20 43 49 60	essful.test.drive..Our.`VyOS.CI`
164e0	5f 20 73 79 73 74 65 6d 20 69 73 20 62 61 73 65 64 20 6f 6e 20 4a 65 6e 6b 69 6e 73 20 61 6e 64	_.system.is.based.on.Jenkins.and
16500	20 62 75 69 6c 64 73 20 61 6c 6c 20 6f 75 72 20 72 65 71 75 69 72 65 64 20 70 61 63 6b 61 67 65	.builds.all.our.required.package
16520	73 20 66 6f 72 20 56 79 4f 53 20 31 2e 32 20 74 6f 20 31 2e 34 2e 20 49 6e 20 61 64 64 69 74 69	s.for.VyOS.1.2.to.1.4..In.additi
16540	6f 6e 20 74 6f 20 74 68 65 20 70 61 63 6b 61 67 65 20 62 75 69 6c 64 2c 20 74 68 65 72 65 20 69	on.to.the.package.build,.there.i
16560	73 20 74 68 65 20 76 79 6f 73 2d 62 75 69 6c 64 20 4a 6f 62 20 77 68 69 63 68 20 62 75 69 6c 64	s.the.vyos-build.Job.which.build
16580	73 20 61 6e 64 20 74 65 73 74 73 20 74 68 65 20 56 79 4f 53 20 49 53 4f 20 69 6d 61 67 65 20 77	s.and.tests.the.VyOS.ISO.image.w
165a0	68 69 63 68 20 69 73 20 70 75 62 6c 69 73 68 65 64 20 61 66 74 65 72 20 61 20 73 75 63 63 65 73	hich.is.published.after.a.succes
165c0	73 66 75 6c 6c 20 74 65 73 74 20 64 72 69 76 65 2e 00 4f 75 72 20 63 6f 64 65 20 69 73 20 73 70	sfull.test.drive..Our.code.is.sp
165e0	6c 69 74 20 69 6e 74 6f 20 73 65 76 65 72 61 6c 20 6d 6f 64 75 6c 65 73 2e 20 56 79 4f 53 20 69	lit.into.several.modules..VyOS.i
16600	73 20 63 6f 6d 70 6f 73 65 64 20 6f 66 20 6d 75 6c 74 69 70 6c 65 20 69 6e 64 69 76 69 64 75 61	s.composed.of.multiple.individua
16620	6c 20 70 61 63 6b 61 67 65 73 2c 20 73 6f 6d 65 20 6f 66 20 74 68 65 6d 20 61 72 65 20 66 6f 72	l.packages,.some.of.them.are.for
16640	6b 73 20 6f 66 20 75 70 73 74 72 65 61 6d 20 70 61 63 6b 61 67 65 73 20 61 6e 64 20 61 72 65 20	ks.of.upstream.packages.and.are.
16660	70 65 72 69 6f 64 69 63 61 6c 6c 79 20 73 79 6e 63 65 64 20 77 69 74 68 20 75 70 73 74 72 65 61	periodically.synced.with.upstrea
16680	6d 2c 20 73 6f 20 6b 65 65 70 69 6e 67 20 74 68 65 20 77 68 6f 6c 65 20 73 6f 75 72 63 65 20 75	m,.so.keeping.the.whole.source.u
166a0	6e 64 65 72 20 61 20 73 69 6e 67 6c 65 20 72 65 70 6f 73 69 74 6f 72 79 20 77 6f 75 6c 64 20 62	nder.a.single.repository.would.b
166c0	65 20 76 65 72 79 20 69 6e 63 6f 6e 76 65 6e 69 65 6e 74 20 61 6e 64 20 73 6c 6f 77 2e 20 54 68	e.very.inconvenient.and.slow..Th
166e0	65 72 65 20 69 73 20 6e 6f 77 20 61 6e 20 6f 6e 67 6f 69 6e 67 20 65 66 66 6f 72 74 20 74 6f 20	ere.is.now.an.ongoing.effort.to.
16700	63 6f 6e 73 6f 6c 69 64 61 74 65 20 61 6c 6c 20 56 79 4f 53 2d 73 70 65 63 69 66 69 63 20 66 72	consolidate.all.VyOS-specific.fr
16720	61 6d 65 77 6f 72 6b 2f 63 6f 6e 66 69 67 20 70 61 63 6b 61 67 65 73 20 69 6e 74 6f 20 76 79 6f	amework/config.packages.into.vyo
16740	73 2d 31 78 20 70 61 63 6b 61 67 65 2c 20 62 75 74 20 74 68 65 20 62 61 73 69 63 20 73 74 72 75	s-1x.package,.but.the.basic.stru
16760	63 74 75 72 65 20 69 73 20 67 6f 69 6e 67 20 74 6f 20 73 74 61 79 20 74 68 65 20 73 61 6d 65 2c	cture.is.going.to.stay.the.same,
16780	20 6a 75 73 74 20 77 69 74 68 20 66 65 77 65 72 20 61 6e 64 20 66 65 77 65 72 20 70 61 63 6b 61	.just.with.fewer.and.fewer.packa
167a0	67 65 73 20 77 68 69 6c 65 20 74 68 65 20 62 61 73 65 20 63 6f 64 65 20 69 73 20 72 65 77 72 69	ges.while.the.base.code.is.rewri
167c0	74 74 65 6e 20 66 72 6f 6d 20 50 65 72 6c 2f 42 41 53 48 20 69 6e 74 6f 20 50 79 74 68 6f 6e 20	tten.from.Perl/BASH.into.Python.
167e0	75 73 69 6e 67 20 61 6e 64 20 58 4d 4c 20 62 61 73 65 64 20 69 6e 74 65 72 66 61 63 65 20 64 65	using.and.XML.based.interface.de
16800	66 69 6e 69 74 69 6f 6e 20 66 6f 72 20 74 68 65 20 43 4c 49 2e 00 4f 75 72 20 6f 70 20 6d 6f 64	finition.for.the.CLI..Our.op.mod
16820	65 20 73 63 72 69 70 74 73 20 75 73 65 20 74 68 65 20 70 79 74 68 6f 6e 2d 76 69 63 69 20 6d 6f	e.scripts.use.the.python-vici.mo
16840	64 75 6c 65 2c 20 77 68 69 63 68 20 69 73 20 6e 6f 74 20 69 6e 63 6c 75 64 65 64 20 69 6e 20 44	dule,.which.is.not.included.in.D
16860	65 62 69 61 6e 27 73 20 62 75 69 6c 64 2c 20 61 6e 64 20 69 73 6e 27 74 20 71 75 69 74 65 20 65	ebian's.build,.and.isn't.quite.e
16880	61 73 79 20 74 6f 20 69 6e 74 65 67 72 61 74 65 20 69 6e 20 74 68 61 74 20 62 75 69 6c 64 2e 20	asy.to.integrate.in.that.build..
168a0	46 6f 72 20 74 68 69 73 20 72 65 61 73 6f 6e 20 77 65 20 64 65 62 69 61 6e 69 7a 65 20 74 68 61	For.this.reason.we.debianize.tha
168c0	74 20 6d 6f 64 75 6c 65 20 62 79 20 68 61 6e 64 20 6e 6f 77 2c 20 75 73 69 6e 67 20 74 68 69 73	t.module.by.hand.now,.using.this
168e0	20 70 72 6f 63 65 64 75 72 65 3a 00 4f 75 72 20 73 6d 6f 6b 65 74 65 73 74 73 20 6e 6f 74 20 6f	.procedure:.Our.smoketests.not.o
16900	6e 6c 79 20 74 65 73 74 20 64 61 65 6d 6f 6e 73 20 61 6e 64 20 73 65 72 69 76 65 73 2c 20 62 75	nly.test.daemons.and.serives,.bu
16920	74 20 61 6c 73 6f 20 63 68 65 63 6b 20 69 66 20 77 68 61 74 20 77 65 20 63 6f 6e 66 69 67 75 72	t.also.check.if.what.we.configur
16940	65 20 66 6f 72 20 61 6e 20 69 6e 74 65 72 66 61 63 65 20 77 6f 72 6b 73 2e 20 54 68 75 73 20 74	e.for.an.interface.works..Thus.t
16960	68 65 72 65 20 69 73 20 61 20 63 6f 6d 6d 6f 6e 20 62 61 73 65 20 63 6c 61 73 73 65 64 20 6e 61	here.is.a.common.base.classed.na
16980	6d 65 64 3a 20 60 60 62 61 73 65 5f 69 6e 74 65 72 66 61 63 65 73 5f 74 65 73 74 2e 70 79 60 60	med:.``base_interfaces_test.py``
169a0	20 77 68 69 63 68 20 68 6f 6c 64 73 20 61 6c 6c 20 74 68 65 20 63 6f 6d 6d 6f 6e 20 63 6f 64 65	.which.holds.all.the.common.code
169c0	20 74 68 61 74 20 61 6e 20 69 6e 74 65 72 66 61 63 65 20 73 75 70 70 6f 72 74 73 20 61 6e 64 20	.that.an.interface.supports.and.
169e0	69 73 20 74 65 73 74 65 64 2e 00 50 61 63 6b 61 67 65 73 00 50 61 74 63 68 65 73 20 61 72 65 20	is.tested..Packages.Patches.are.
16a00	61 6c 77 61 79 73 20 6d 6f 72 65 20 74 68 61 6e 20 77 65 6c 63 6f 6d 65 2e 20 54 6f 20 68 61 76	always.more.than.welcome..To.hav
16a20	65 20 61 20 63 6c 65 61 6e 20 61 6e 64 20 65 61 73 79 20 74 6f 20 6d 61 69 6e 74 61 69 6e 20 72	e.a.clean.and.easy.to.maintain.r
16a40	65 70 6f 73 69 74 6f 72 79 20 77 65 20 68 61 76 65 20 73 6f 6d 65 20 67 75 69 64 65 6c 69 6e 65	epository.we.have.some.guideline
16a60	73 20 77 68 65 6e 20 77 6f 72 6b 69 6e 67 20 77 69 74 68 20 47 69 74 2e 20 41 20 63 6c 65 61 6e	s.when.working.with.Git..A.clean
16a80	20 72 65 70 6f 73 69 74 6f 72 79 20 65 61 73 65 73 20 74 68 65 20 61 75 74 6f 6d 61 74 69 63 20	.repository.eases.the.automatic.
16aa0	67 65 6e 65 72 61 74 69 6f 6e 20 6f 66 20 61 20 63 68 61 6e 67 65 6c 6f 67 20 66 69 6c 65 2e 00	generation.of.a.changelog.file..
16ac0	50 61 74 63 68 65 73 20 66 6f 72 20 44 4d 56 50 4e 20 61 72 65 20 6d 65 72 67 65 64 20 69 6e 00	Patches.for.DMVPN.are.merged.in.
16ae0	50 6c 65 61 73 65 20 6c 65 61 76 65 20 61 20 63 6f 6d 6d 65 6e 74 20 65 78 70 6c 61 69 6e 69 6e	Please.leave.a.comment.explainin
16b00	67 20 77 68 79 20 74 68 65 20 70 72 69 6f 72 69 74 79 20 77 61 73 20 63 68 6f 73 65 6e 20 28 65	g.why.the.priority.was.chosen.(e
16b20	2e 67 2e 20 22 61 66 74 65 72 20 69 6e 74 65 72 66 61 63 65 73 20 61 72 65 20 63 6f 6e 66 69 67	.g.."after.interfaces.are.config
16b40	75 72 65 64 22 29 00 50 6c 65 61 73 65 20 73 75 62 6d 69 74 20 79 6f 75 72 20 70 61 74 63 68 65	ured").Please.submit.your.patche
16b60	73 20 75 73 69 6e 67 20 74 68 65 20 77 65 6c 6c 2d 6b 6e 6f 77 6e 20 47 69 74 48 75 62 20 70 75	s.using.the.well-known.GitHub.pu
16b80	6c 6c 2d 72 65 71 75 65 73 74 20 61 67 61 69 6e 73 74 20 6f 75 72 20 72 65 70 6f 73 69 74 6f 72	ll-request.against.our.repositor
16ba0	69 65 73 20 66 6f 75 6e 64 20 69 6e 20 74 68 65 20 56 79 4f 53 20 47 69 74 48 75 62 20 6f 72 67	ies.found.in.the.VyOS.GitHub.org
16bc0	61 6e 69 73 61 74 69 6f 6e 20 61 74 20 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f	anisation.at.https://github.com/
16be0	76 79 6f 73 00 50 6c 65 61 73 65 20 75 73 65 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 74 65	vyos.Please.use.the.following.te
16c00	6d 70 6c 61 74 65 20 61 73 20 67 6f 6f 64 20 73 74 61 72 74 69 6e 67 20 70 6f 69 6e 74 20 77 68	mplate.as.good.starting.point.wh
16c20	65 6e 20 64 65 76 65 6c 6f 70 69 6e 67 20 6e 65 77 20 6d 6f 64 75 6c 65 73 20 6f 72 20 65 76 65	en.developing.new.modules.or.eve
16c40	6e 20 72 65 77 72 69 74 65 20 61 20 77 68 6f 6c 65 20 62 75 6e 63 68 20 6f 66 20 63 6f 64 65 20	n.rewrite.a.whole.bunch.of.code.
16c60	69 6e 20 74 68 65 20 6e 65 77 20 73 74 79 6c 65 20 58 4d 4c 2f 50 79 68 6f 6e 20 69 6e 74 65 72	in.the.new.style.XML/Pyhon.inter
16c80	66 61 63 65 2e 00 50 6c 65 61 73 65 20 75 73 65 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 74	face..Please.use.the.following.t
16ca0	65 6d 70 6c 61 74 65 20 61 73 20 67 6f 6f 64 20 73 74 61 72 74 69 6e 67 20 70 6f 69 6e 74 20 77	emplate.as.good.starting.point.w
16cc0	68 65 6e 20 64 65 76 65 6c 6f 70 69 6e 67 20 6e 65 77 20 6d 6f 64 75 6c 65 73 20 6f 72 20 65 76	hen.developing.new.modules.or.ev
16ce0	65 6e 20 72 65 77 72 69 74 65 20 61 20 77 68 6f 6c 65 20 62 75 6e 63 68 20 6f 66 20 63 6f 64 65	en.rewrite.a.whole.bunch.of.code
16d00	20 69 6e 20 74 68 65 20 6e 65 77 20 73 74 79 6c 65 20 58 4d 4c 2f 50 79 74 68 6f 6e 20 69 6e 74	.in.the.new.style.XML/Python.int
16d20	65 72 66 61 63 65 2e 00 50 6f 72 74 20 64 65 73 63 72 69 70 74 69 6f 6e 00 50 6f 72 74 20 64 69	erface..Port.description.Port.di
16d40	73 61 62 6c 65 00 50 72 65 66 65 72 20 69 6e 66 69 6e 69 74 69 76 65 73 00 50 72 65 70 61 72 65	sable.Prefer.infinitives.Prepare
16d60	20 70 61 74 63 68 2f 63 6f 6d 6d 69 74 00 50 72 65 70 61 72 65 20 72 65 6c 65 61 73 65 20 6e 6f	.patch/commit.Prepare.release.no
16d80	74 65 73 20 66 6f 72 20 75 70 63 6f 6d 69 6e 67 20 72 65 6c 65 61 73 65 73 00 50 72 65 72 65 71	tes.for.upcoming.releases.Prereq
16da0	75 69 73 69 74 65 73 00 50 72 69 6f 72 69 74 69 65 73 00 50 72 6f 70 6f 73 65 64 20 43 4c 49 20	uisites.Priorities.Proposed.CLI.
16dc0	73 79 6e 74 61 78 2c 20 69 66 20 74 68 65 20 66 65 61 74 75 72 65 20 72 65 71 75 69 72 65 73 20	syntax,.if.the.feature.requires.
16de0	6e 65 77 20 63 6f 6d 6d 61 6e 64 73 2e 20 50 6c 65 61 73 65 20 69 6e 63 6c 75 64 65 20 62 6f 74	new.commands..Please.include.bot
16e00	68 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 61 6e 64 20 6f 70 65 72 61 74 69 6f 6e 61 6c 20	h.configuration.and.operational.
16e20	6d 6f 64 65 20 63 6f 6d 6d 61 6e 64 73 2c 20 69 66 20 62 6f 74 68 20 61 72 65 20 72 65 71 75 69	mode.commands,.if.both.are.requi
16e40	72 65 64 2e 00 50 72 6f 76 69 64 65 20 61 73 20 6d 75 63 68 20 69 6e 66 6f 72 6d 61 74 69 6f 6e	red..Provide.as.much.information
16e60	20 61 73 20 79 6f 75 20 63 61 6e 00 50 79 74 68 6f 6e 00 50 79 74 68 6f 6e 20 28 6f 72 20 61 6e	.as.you.can.Python.Python.(or.an
16e80	79 20 6f 74 68 65 72 20 6c 61 6e 67 75 61 67 65 2c 20 66 6f 72 20 74 68 61 74 20 6d 61 74 74 65	y.other.language,.for.that.matte
16ea0	72 29 20 64 6f 65 73 20 6e 6f 74 20 70 72 6f 76 69 64 65 20 61 75 74 6f 6d 61 74 69 63 20 70 72	r).does.not.provide.automatic.pr
16ec0	6f 74 65 63 74 69 6f 6e 20 66 72 6f 6d 20 62 61 64 20 64 65 73 69 67 6e 2c 20 73 6f 20 77 65 20	otection.from.bad.design,.so.we.
16ee0	6e 65 65 64 20 74 6f 20 61 6c 73 6f 20 64 65 76 69 73 65 20 64 65 73 69 67 6e 20 67 75 69 64 65	need.to.also.devise.design.guide
16f00	6c 69 6e 65 73 20 61 6e 64 20 66 6f 6c 6c 6f 77 20 74 68 65 6d 20 74 6f 20 6b 65 65 70 20 74 68	lines.and.follow.them.to.keep.th
16f20	65 20 73 79 73 74 65 6d 20 65 78 74 65 6e 73 69 62 6c 65 20 61 6e 64 20 6d 61 69 6e 74 61 69 6e	e.system.extensible.and.maintain
16f40	61 62 6c 65 2e 00 50 79 74 68 6f 6e 20 33 20 2a 2a 73 68 61 6c 6c 2a 2a 20 62 65 20 75 73 65 64	able..Python.3.**shall**.be.used
16f60	2e 20 48 6f 77 20 6c 6f 6e 67 20 63 61 6e 20 77 65 20 6b 65 65 70 20 50 79 74 68 6f 6e 20 32 20	..How.long.can.we.keep.Python.2.
16f80	61 6c 69 76 65 20 61 6e 79 77 61 79 3f 20 4e 6f 20 63 6f 6e 73 69 64 65 72 61 74 69 6f 6e 73 20	alive.anyway?.No.considerations.
16fa0	66 6f 72 20 50 79 74 68 6f 6e 20 32 20 63 6f 6d 70 61 74 69 62 69 6c 69 74 79 20 2a 2a 73 68 6f	for.Python.2.compatibility.**sho
16fc0	75 6c 64 2a 2a 20 62 65 20 74 61 6b 65 6e 20 61 74 20 61 6e 79 20 74 69 6d 65 2e 00 50 79 74 68	uld**.be.taken.at.any.time..Pyth
16fe0	6f 6e 3a 20 54 61 62 73 20 2a 2a 73 68 61 6c 6c 20 6e 6f 74 2a 2a 20 62 65 20 75 73 65 64 2e 20	on:.Tabs.**shall.not**.be.used..
17000	45 76 65 72 79 20 69 6e 64 65 6e 74 61 74 69 6f 6e 20 6c 65 76 65 6c 20 73 68 6f 75 6c 64 20 62	Every.indentation.level.should.b
17020	65 20 34 20 73 70 61 63 65 73 00 51 45 4d 55 00 52 61 74 69 6f 6e 61 6c 65 3a 20 74 68 69 73 20	e.4.spaces.QEMU.Rationale:.this.
17040	73 65 65 6d 73 20 74 6f 20 62 65 20 74 68 65 20 75 6e 77 72 69 74 74 65 6e 20 73 74 61 6e 64 61	seems.to.be.the.unwritten.standa
17060	72 64 20 69 6e 20 6e 65 74 77 6f 72 6b 20 64 65 76 69 63 65 20 43 4c 49 73 2c 20 61 6e 64 20 61	rd.in.network.device.CLIs,.and.a
17080	20 67 6f 6f 64 20 61 65 73 74 68 65 74 69 63 20 63 6f 6d 70 72 6f 6d 69 73 65 2e 00 52 65 63 65	.good.aesthetic.compromise..Rece
170a0	6e 74 20 76 65 72 73 69 6f 6e 73 20 75 73 65 20 74 68 65 20 60 60 76 79 6f 73 2e 66 72 72 60 60	nt.versions.use.the.``vyos.frr``
170c0	20 66 72 61 6d 65 77 6f 72 6b 2e 20 54 68 65 20 50 79 74 68 6f 6e 20 63 6c 61 73 73 20 69 73 20	.framework..The.Python.class.is.
170e0	6c 6f 63 61 74 65 64 20 69 6e 73 69 64 65 20 6f 75 72 20 60 60 76 79 6f 73 2d 31 78 3a 70 79 74	located.inside.our.``vyos-1x:pyt
17100	68 6f 6e 2f 76 79 6f 73 2f 66 72 72 2e 70 79 60 60 2e 20 49 74 20 63 6f 6d 65 73 20 77 69 74 68	hon/vyos/frr.py``..It.comes.with
17120	20 61 6e 20 65 6d 62 65 64 64 65 64 20 64 65 62 75 67 67 69 6e 67 2f 20 28 70 72 69 6e 74 20 73	.an.embedded.debugging/.(print.s
17140	74 79 6c 65 29 20 64 65 62 75 67 67 65 72 20 61 73 20 76 79 6f 73 2e 69 66 63 6f 6e 66 69 67 20	tyle).debugger.as.vyos.ifconfig.
17160	64 6f 65 73 2e 00 52 65 70 6f 72 74 20 61 20 42 75 67 00 52 75 6e 20 74 68 65 20 66 6f 6c 6c 6f	does..Report.a.Bug.Run.the.follo
17180	77 69 6e 67 20 63 6f 6d 6d 61 6e 64 20 61 66 74 65 72 20 62 75 69 6c 64 69 6e 67 20 74 68 65 20	wing.command.after.building.the.
171a0	49 53 4f 20 69 6d 61 67 65 2e 00 52 75 6e 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 63 6f 6d	ISO.image..Run.the.following.com
171c0	6d 61 6e 64 20 61 66 74 65 72 20 62 75 69 6c 64 69 6e 67 20 74 68 65 20 51 45 4d 55 20 69 6d 61	mand.after.building.the.QEMU.ima
171e0	67 65 2e 00 53 69 6d 70 6c 79 20 75 73 65 20 6f 75 72 20 77 72 61 70 70 65 72 20 73 63 72 69 70	ge..Simply.use.our.wrapper.scrip
17200	74 20 74 6f 20 62 75 69 6c 64 20 61 6c 6c 20 6f 66 20 74 68 65 20 64 72 69 76 65 72 20 6d 6f 64	t.to.build.all.of.the.driver.mod
17220	75 6c 65 73 2e 00 53 69 6e 63 65 20 56 79 4f 53 20 68 61 73 20 73 77 69 74 63 68 65 64 20 74 6f	ules..Since.VyOS.has.switched.to
17240	20 44 65 62 69 61 6e 20 28 31 31 29 20 42 75 6c 6c 73 65 79 65 20 69 6e 20 69 74 73 20 60 60 63	.Debian.(11).Bullseye.in.its.``c
17260	75 72 72 65 6e 74 60 60 20 62 72 61 6e 63 68 2c 20 79 6f 75 20 77 69 6c 6c 20 72 65 71 75 69 72	urrent``.branch,.you.will.requir
17280	65 20 69 6e 64 69 76 69 64 75 61 6c 20 63 6f 6e 74 61 69 6e 65 72 20 66 6f 72 20 60 63 75 72 72	e.individual.container.for.`curr
172a0	65 6e 74 60 2c 20 60 65 71 75 75 6c 65 75 73 60 20 61 6e 64 20 60 63 72 75 78 60 20 62 75 69 6c	ent`,.`equuleus`.and.`crux`.buil
172c0	64 73 2e 00 53 6d 6f 6b 65 74 65 73 74 73 00 53 6d 6f 6b 65 74 65 73 74 73 20 65 78 65 63 75 74	ds..Smoketests.Smoketests.execut
172e0	65 73 20 70 72 65 64 65 66 69 6e 65 64 20 56 79 4f 53 20 43 4c 49 20 63 6f 6d 6d 61 6e 64 73 20	es.predefined.VyOS.CLI.commands.
17300	61 6e 64 20 63 68 65 63 6b 73 20 69 66 20 74 68 65 20 64 65 73 69 72 65 64 20 64 61 65 6d 6f 6e	and.checks.if.the.desired.daemon
17320	2f 73 65 72 76 69 63 65 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 69 73 20 72 65 6e 64 65 72	/service.configuration.is.render
17340	74 20 2d 20 74 68 61 74 20 69 73 20 68 6f 77 20 74 6f 20 70 75 74 20 69 74 20 22 73 68 6f 72 74	t.-.that.is.how.to.put.it."short
17360	22 2e 00 53 6f 20 69 66 20 79 6f 75 20 70 6c 61 6e 20 74 6f 20 62 75 69 6c 64 20 79 6f 75 72 20	"..So.if.you.plan.to.build.your.
17380	6f 77 6e 20 63 75 73 74 6f 6d 20 49 53 4f 20 69 6d 61 67 65 20 61 6e 64 20 77 61 6e 27 74 20 74	own.custom.ISO.image.and.wan't.t
173a0	6f 20 6d 61 6b 65 20 75 73 65 20 6f 66 20 6f 75 72 20 73 6d 6f 6b 65 74 65 73 74 73 2c 20 65 6e	o.make.use.of.our.smoketests,.en
173c0	73 75 72 65 20 74 68 61 74 20 79 6f 75 20 68 61 76 65 20 74 68 65 20 60 76 79 6f 73 2d 31 78 2d	sure.that.you.have.the.`vyos-1x-
173e0	73 6d 6f 6b 65 74 65 73 74 60 20 70 61 63 6b 61 67 65 20 69 6e 73 74 61 6c 6c 65 64 2e 00 53 6f	smoketest`.package.installed..So
17400	20 69 66 20 79 6f 75 20 70 6c 61 6e 20 74 6f 20 62 75 69 6c 64 20 79 6f 75 72 20 6f 77 6e 20 63	.if.you.plan.to.build.your.own.c
17420	75 73 74 6f 6d 20 49 53 4f 20 69 6d 61 67 65 20 61 6e 64 20 77 61 6e 74 20 74 6f 20 6d 61 6b 65	ustom.ISO.image.and.want.to.make
17440	20 75 73 65 20 6f 66 20 6f 75 72 20 73 6d 6f 6b 65 74 65 73 74 73 2c 20 65 6e 73 75 72 65 20 74	.use.of.our.smoketests,.ensure.t
17460	68 61 74 20 79 6f 75 20 68 61 76 65 20 74 68 65 20 60 76 79 6f 73 2d 31 78 2d 73 6d 6f 6b 65 74	hat.you.have.the.`vyos-1x-smoket
17480	65 73 74 60 20 70 61 63 6b 61 67 65 20 69 6e 73 74 61 6c 6c 65 64 2e 00 53 6f 6d 65 20 56 79 4f	est`.package.installed..Some.VyO
174a0	53 20 70 61 63 6b 61 67 65 73 20 28 6e 61 6d 65 6c 79 20 76 79 6f 73 2d 31 78 29 20 63 6f 6d 65	S.packages.(namely.vyos-1x).come
174c0	20 77 69 74 68 20 62 75 69 6c 64 2d 74 69 6d 65 20 74 65 73 74 73 20 77 68 69 63 68 20 76 65 72	.with.build-time.tests.which.ver
174e0	69 66 79 20 73 6f 6d 65 20 6f 66 20 74 68 65 20 69 6e 74 65 72 6e 61 6c 20 6c 69 62 72 61 72 79	ify.some.of.the.internal.library
17500	20 63 61 6c 6c 73 20 74 68 61 74 20 74 68 65 79 20 77 6f 72 6b 20 61 73 20 65 78 70 65 63 74 65	.calls.that.they.work.as.expecte
17520	64 2e 20 54 68 6f 73 65 20 74 65 73 74 73 20 61 72 65 20 63 61 72 72 69 65 64 20 6f 75 74 20 74	d..Those.tests.are.carried.out.t
17540	68 72 6f 75 67 68 20 74 68 65 20 50 79 74 68 6f 6e 20 55 6e 69 74 74 65 73 74 20 6d 6f 64 75 6c	hrough.the.Python.Unittest.modul
17560	65 2e 20 49 66 20 79 6f 75 20 77 61 6e 74 20 74 6f 20 62 75 69 6c 64 20 74 68 65 20 60 60 76 79	e..If.you.want.to.build.the.``vy
17580	6f 73 2d 31 78 60 60 20 70 61 63 6b 61 67 65 20 28 77 68 69 63 68 20 69 73 20 6f 75 72 20 6d 61	os-1x``.package.(which.is.our.ma
175a0	69 6e 20 64 65 76 65 6c 6f 70 6d 65 6e 74 20 70 61 63 6b 61 67 65 29 20 79 6f 75 20 6e 65 65 64	in.development.package).you.need
175c0	20 74 6f 20 73 74 61 72 74 20 79 6f 75 72 20 44 6f 63 6b 65 72 20 63 6f 6e 74 61 69 6e 65 72 20	.to.start.your.Docker.container.
175e0	75 73 69 6e 67 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 61 72 67 75 6d 65 6e 74 3a 20 60 60	using.the.following.argument:.``
17600	2d 2d 73 79 73 63 74 6c 20 6e 65 74 2e 69 70 76 36 2e 63 6f 6e 66 2e 6c 6f 2e 64 69 73 61 62 6c	--sysctl.net.ipv6.conf.lo.disabl
17620	65 5f 69 70 76 36 3d 30 60 60 2c 20 6f 74 68 65 72 77 69 73 65 20 74 68 6f 73 65 20 74 65 73 74	e_ipv6=0``,.otherwise.those.test
17640	73 20 77 69 6c 6c 20 66 61 69 6c 2e 00 53 6f 6d 65 20 61 62 62 72 65 76 69 61 74 69 6f 6e 73 20	s.will.fail..Some.abbreviations.
17660	61 72 65 20 74 72 61 64 69 74 69 6f 6e 61 6c 6c 79 20 77 72 69 74 74 65 6e 20 69 6e 20 6d 69 78	are.traditionally.written.in.mix
17680	65 64 20 63 61 73 65 2e 20 47 65 6e 65 72 61 6c 6c 79 2c 20 69 66 20 69 74 20 63 6f 6e 74 61 69	ed.case..Generally,.if.it.contai
176a0	6e 73 20 77 6f 72 64 73 20 22 6f 76 65 72 22 20 6f 72 20 22 76 65 72 73 69 6f 6e 22 2c 20 74 68	ns.words."over".or."version",.th
176c0	65 20 6c 65 74 74 65 72 20 2a 2a 73 68 6f 75 6c 64 2a 2a 20 62 65 20 6c 6f 77 65 72 63 61 73 65	e.letter.**should**.be.lowercase
176e0	2e 20 49 66 20 74 68 65 72 65 27 73 20 61 6e 20 61 63 63 65 70 74 65 64 20 73 70 65 6c 6c 69 6e	..If.there's.an.accepted.spellin
17700	67 20 28 65 73 70 65 63 69 61 6c 6c 79 20 69 66 20 64 65 66 69 6e 65 64 20 62 79 20 61 6e 20 52	g.(especially.if.defined.by.an.R
17720	46 43 20 6f 72 20 61 6e 6f 74 68 65 72 20 73 74 61 6e 64 61 72 64 29 2c 20 69 74 20 2a 2a 6d 75	FC.or.another.standard),.it.**mu
17740	73 74 2a 2a 20 62 65 20 66 6f 6c 6c 6f 77 65 64 2e 00 53 6f 6d 65 20 6f 66 20 74 68 65 20 63 6f	st**.be.followed..Some.of.the.co
17760	6e 66 69 67 75 72 61 74 69 6f 6e 73 20 68 61 76 65 20 70 72 65 63 6f 6e 64 69 74 69 6f 6e 73 20	nfigurations.have.preconditions.
17780	77 68 69 63 68 20 6e 65 65 64 20 74 6f 20 62 65 20 6d 65 74 2e 20 54 68 6f 73 65 20 6d 6f 73 74	which.need.to.be.met..Those.most
177a0	20 6c 69 6b 65 6c 79 20 69 6e 63 6c 75 64 65 20 67 65 6e 65 72 61 74 69 6f 6e 20 6f 66 20 63 72	.likely.include.generation.of.cr
177c0	79 70 6f 67 72 61 70 68 69 63 20 6b 65 79 73 20 62 65 66 6f 72 65 20 74 68 65 20 63 6f 6e 66 69	ypographic.keys.before.the.confi
177e0	67 20 63 61 6e 20 62 65 20 61 70 70 6c 69 65 64 20 2d 20 79 6f 75 20 77 69 6c 6c 20 67 65 74 20	g.can.be.applied.-.you.will.get.
17800	61 20 63 6f 6d 6d 69 74 20 65 72 72 6f 72 20 6f 74 68 65 72 77 69 73 65 2e 20 49 66 20 79 6f 75	a.commit.error.otherwise..If.you
17820	20 61 72 65 20 69 6e 74 65 72 65 73 74 65 64 20 68 6f 77 20 74 68 6f 73 65 20 70 72 65 63 6f 6e	.are.interested.how.those.precon
17840	64 69 74 69 6f 6e 73 20 61 72 65 20 66 75 6c 66 69 6c 6c 65 64 20 63 68 65 63 6b 20 74 68 65 20	ditions.are.fulfilled.check.the.
17860	76 79 6f 73 2d 62 75 69 6c 64 5f 20 72 65 70 6f 73 69 74 6f 72 79 20 61 6e 64 20 74 68 65 20 60	vyos-build_.repository.and.the.`
17880	60 73 63 72 69 70 74 73 2f 63 68 65 63 6b 2d 71 65 6d 75 2d 69 6e 73 74 61 6c 6c 60 60 20 66 69	`scripts/check-qemu-install``.fi
178a0	6c 65 2e 00 53 6f 6d 65 74 69 6d 65 73 20 69 74 20 6d 69 67 68 74 20 62 65 20 75 73 65 66 75 6c	le..Sometimes.it.might.be.useful
178c0	20 74 6f 20 64 65 62 75 67 20 50 79 74 68 6f 6e 20 63 6f 64 65 20 69 6e 74 65 72 61 63 74 69 76	.to.debug.Python.code.interactiv
178e0	65 6c 79 20 6f 6e 20 74 68 65 20 6c 69 76 65 20 73 79 73 74 65 6d 20 72 61 74 68 65 72 20 74 68	ely.on.the.live.system.rather.th
17900	61 6e 20 61 20 49 44 45 2e 20 54 68 69 73 20 63 61 6e 20 62 65 20 61 63 68 69 65 76 65 64 20 75	an.a.IDE..This.can.be.achieved.u
17920	73 69 6e 67 20 70 64 62 2e 00 53 74 61 72 74 20 74 68 65 20 62 75 69 6c 64 3a 00 53 74 61 72 74	sing.pdb..Start.the.build:.Start
17940	69 6e 67 20 77 69 74 68 20 56 79 4f 53 20 31 2e 32 20 74 68 65 20 72 65 6c 65 61 73 65 20 6d 6f	ing.with.VyOS.1.2.the.release.mo
17960	64 65 6c 20 6f 66 20 56 79 4f 53 20 68 61 73 20 63 68 61 6e 67 65 64 2e 20 56 79 4f 53 20 69 73	del.of.VyOS.has.changed..VyOS.is
17980	20 6e 6f 77 20 2a 2a 66 72 65 65 20 61 73 20 69 6e 20 73 70 65 65 63 68 2c 20 62 75 74 20 6e 6f	.now.**free.as.in.speech,.but.no
179a0	74 20 61 73 20 69 6e 20 62 65 65 72 2a 2a 2e 20 54 68 69 73 20 6d 65 61 6e 73 20 74 68 61 74 20	t.as.in.beer**..This.means.that.
179c0	77 68 69 6c 65 20 56 79 4f 53 20 69 73 20 73 74 69 6c 6c 20 61 6e 20 6f 70 65 6e 20 73 6f 75 72	while.VyOS.is.still.an.open.sour
179e0	63 65 20 70 72 6f 6a 65 63 74 2c 20 74 68 65 20 72 65 6c 65 61 73 65 20 49 53 4f 73 20 61 72 65	ce.project,.the.release.ISOs.are
17a00	20 6e 6f 20 6c 6f 6e 67 65 72 20 66 72 65 65 20 61 6e 64 20 63 61 6e 20 6f 6e 6c 79 20 62 65 20	.no.longer.free.and.can.only.be.
17a20	6f 62 74 61 69 6e 65 64 20 76 69 61 20 73 75 62 73 63 72 69 70 74 69 6f 6e 2c 20 6f 72 20 62 79	obtained.via.subscription,.or.by
17a40	20 63 6f 6e 74 72 69 62 75 74 69 6e 67 20 74 6f 20 74 68 65 20 63 6f 6d 6d 75 6e 69 74 79 2e 00	.contributing.to.the.community..
17a60	53 75 62 6d 69 74 20 61 20 50 61 74 63 68 00 53 75 62 6d 69 74 20 74 68 65 20 70 61 74 63 68 20	Submit.a.Patch.Submit.the.patch.
17a80	60 60 67 69 74 20 70 75 73 68 60 60 20 61 6e 64 20 63 72 65 61 74 65 20 74 68 65 20 47 69 74 48	``git.push``.and.create.the.GitH
17aa0	75 62 20 70 75 6c 6c 2d 72 65 71 75 65 73 74 2e 00 53 75 6d 6d 61 72 79 00 53 75 70 70 6f 73 65	ub.pull-request..Summary.Suppose
17ac0	20 79 6f 75 20 77 61 6e 74 20 74 6f 20 6d 61 6b 65 20 61 20 63 68 61 6e 67 65 20 69 6e 20 74 68	.you.want.to.make.a.change.in.th
17ae0	65 20 77 65 62 70 72 6f 78 79 20 73 63 72 69 70 74 20 62 75 74 20 79 65 74 20 79 6f 75 20 64 6f	e.webproxy.script.but.yet.you.do
17b00	20 6e 6f 74 20 6b 6e 6f 77 20 77 68 69 63 68 20 6f 66 20 74 68 65 20 6d 61 6e 79 20 56 79 4f 53	.not.know.which.of.the.many.VyOS
17b20	20 70 61 63 6b 61 67 65 73 20 73 68 69 70 20 74 68 69 73 20 66 69 6c 65 2e 20 59 6f 75 20 63 61	.packages.ship.this.file..You.ca
17b40	6e 20 64 65 74 65 72 6d 69 6e 65 20 74 68 65 20 56 79 4f 53 20 70 61 63 6b 61 67 65 20 6e 61 6d	n.determine.the.VyOS.package.nam
17b60	65 20 69 6e 20 71 75 65 73 74 69 6f 6e 20 62 79 20 75 73 69 6e 67 20 44 65 62 69 61 6e 27 73 20	e.in.question.by.using.Debian's.
17b80	60 60 64 70 6b 67 20 2d 53 60 60 20 63 6f 6d 6d 61 6e 64 20 6f 66 20 79 6f 75 72 20 72 75 6e 6e	``dpkg.-S``.command.of.your.runn
17ba0	69 6e 67 20 56 79 4f 53 20 69 6e 73 74 61 6c 6c 61 74 69 6f 6e 2e 00 53 79 73 74 65 6d 20 53 74	ing.VyOS.installation..System.St
17bc0	61 72 74 75 70 00 54 61 73 6b 20 61 75 74 6f 2d 63 6c 6f 73 69 6e 67 00 54 61 73 6b 73 20 74 68	artup.Task.auto-closing.Tasks.th
17be0	61 74 20 61 72 65 20 69 6d 70 6c 65 6d 65 6e 74 65 64 20 61 6e 64 20 74 65 73 74 65 64 20 62 79	at.are.implemented.and.tested.by
17c00	20 74 68 65 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 61 75 74 68 6f 72 2c 20 62 75 74 20	.the.implementation.author,.but.
17c20	72 65 71 75 69 72 65 20 74 65 73 74 69 6e 67 20 69 6e 20 74 68 65 20 72 65 61 6c 2d 77 6f 72 6c	require.testing.in.the.real-worl
17c40	64 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 74 68 61 74 20 6f 6e 6c 79 20 74 68 65 20 72 65 70 6f	d.environment.that.only.the.repo
17c60	72 74 65 72 20 63 61 6e 20 72 65 70 6c 69 63 61 74 65 20 28 65 2e 67 2e 2c 20 68 61 72 64 77 61	rter.can.replicate.(e.g.,.hardwa
17c80	72 65 20 77 65 20 64 6f 20 6e 6f 74 20 68 61 76 65 2c 20 73 70 65 63 69 66 69 63 20 6e 65 74 77	re.we.do.not.have,.specific.netw
17ca0	6f 72 6b 20 63 6f 6e 64 69 74 69 6f 6e 73 2e 2e 2e 29 2e 00 54 65 6d 70 6c 61 74 65 20 70 72 6f	ork.conditions...)..Template.pro
17cc0	63 65 73 73 6f 72 20 2a 2a 73 68 6f 75 6c 64 2a 2a 20 62 65 20 75 73 65 64 20 66 6f 72 20 67 65	cessor.**should**.be.used.for.ge
17ce0	6e 65 72 61 74 69 6e 67 20 63 6f 6e 66 69 67 20 66 69 6c 65 73 2e 20 42 75 69 6c 74 2d 69 6e 20	nerating.config.files..Built-in.
17d00	73 74 72 69 6e 67 20 66 6f 72 6d 61 74 74 69 6e 67 20 2a 2a 6d 61 79 2a 2a 20 62 65 20 75 73 65	string.formatting.**may**.be.use
17d20	64 20 66 6f 72 20 73 69 6d 70 6c 65 20 6c 69 6e 65 2d 6f 72 69 65 6e 74 65 64 20 66 6f 72 6d 61	d.for.simple.line-oriented.forma
17d40	74 73 20 77 68 65 72 65 20 65 76 65 72 79 20 6c 69 6e 65 20 69 73 20 73 65 6c 66 2d 63 6f 6e 74	ts.where.every.line.is.self-cont
17d60	61 69 6e 65 64 2c 20 73 75 63 68 20 61 73 20 69 70 74 61 62 6c 65 73 20 72 75 6c 65 73 2e 20 54	ained,.such.as.iptables.rules..T
17d80	65 6d 70 6c 61 74 65 20 70 72 6f 63 65 73 73 6f 72 20 2a 2a 6d 75 73 74 2a 2a 20 62 65 20 75 73	emplate.processor.**must**.be.us
17da0	65 64 20 66 6f 72 20 73 74 72 75 63 74 75 72 65 64 2c 20 6d 75 6c 74 69 2d 6c 69 6e 65 20 66 6f	ed.for.structured,.multi-line.fo
17dc0	72 6d 61 74 73 20 73 75 63 68 20 61 73 20 74 68 6f 73 65 20 75 73 65 64 20 62 79 20 49 53 43 20	rmats.such.as.those.used.by.ISC.
17de0	44 48 43 50 64 2e 00 54 65 73 74 69 6e 67 00 54 65 78 74 20 67 65 6e 65 72 61 74 69 6f 6e 00 54	DHCPd..Testing.Text.generation.T
17e00	68 65 20 43 4c 49 20 70 61 72 73 65 72 20 75 73 65 64 20 69 6e 20 56 79 4f 53 20 69 73 20 61 20	he.CLI.parser.used.in.VyOS.is.a.
17e20	6d 69 78 20 6f 66 20 62 61 73 68 2c 20 62 61 73 68 2d 63 6f 6d 70 6c 65 74 69 6f 6e 20 68 65 6c	mix.of.bash,.bash-completion.hel
17e40	70 65 72 20 61 6e 64 20 74 68 65 20 43 2b 2b 20 62 61 63 6b 65 6e 64 20 6c 69 62 72 61 72 79 20	per.and.the.C++.backend.library.
17e60	5b 76 79 61 74 74 61 2d 63 66 67 5d 28 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f	[vyatta-cfg](https://github.com/
17e80	76 79 6f 73 2f 76 79 61 74 74 61 2d 63 66 67 29 2e 20 54 68 69 73 20 73 65 63 74 69 6f 6e 20 69	vyos/vyatta-cfg)..This.section.i
17ea0	73 20 61 20 72 65 66 65 72 65 6e 63 65 20 6f 66 20 63 6f 6d 6d 6f 6e 20 43 4c 49 20 63 6f 6d 6d	s.a.reference.of.common.CLI.comm
17ec0	61 6e 64 73 20 61 6e 64 20 74 68 65 20 72 65 73 70 65 63 74 69 76 65 20 65 6e 74 72 79 20 70 6f	ands.and.the.respective.entry.po
17ee0	69 6e 74 20 69 6e 20 74 68 65 20 43 2f 43 2b 2b 20 63 6f 64 65 2e 00 54 68 65 20 49 6e 74 65 6c	int.in.the.C/C++.code..The.Intel
17f00	20 4e 49 43 20 64 72 69 76 65 72 73 20 64 6f 20 6e 6f 74 20 63 6f 6d 65 20 66 72 6f 6d 20 61 20	.NIC.drivers.do.not.come.from.a.
17f20	47 69 74 20 72 65 70 6f 73 69 74 6f 72 79 2c 20 69 6e 73 74 65 61 64 20 77 65 20 6a 75 73 74 20	Git.repository,.instead.we.just.
17f40	66 65 74 63 68 20 74 68 65 20 74 61 72 62 61 6c 6c 73 20 66 72 6f 6d 20 6f 75 72 20 6d 69 72 72	fetch.the.tarballs.from.our.mirr
17f60	6f 72 20 61 6e 64 20 63 6f 6d 70 69 6c 65 20 74 68 65 6d 2e 00 54 68 65 20 49 6e 74 65 6c 20 51	or.and.compile.them..The.Intel.Q
17f80	41 54 20 28 51 75 69 63 6b 20 41 73 73 69 73 74 20 54 65 63 68 6e 6f 6c 6f 67 79 29 20 64 72 69	AT.(Quick.Assist.Technology).dri
17fa0	76 65 72 73 20 64 6f 20 6e 6f 74 20 63 6f 6d 65 20 66 72 6f 6d 20 61 20 47 69 74 20 72 65 70 6f	vers.do.not.come.from.a.Git.repo
17fc0	73 69 74 6f 72 79 2c 20 69 6e 73 74 65 61 64 20 77 65 20 6a 75 73 74 20 66 65 74 63 68 20 74 68	sitory,.instead.we.just.fetch.th
17fe0	65 20 74 61 72 62 61 6c 6c 73 20 66 72 6f 6d 20 30 31 2e 6f 72 67 2c 20 49 6e 74 65 6c 27 73 20	e.tarballs.from.01.org,.Intel's.
18000	6f 70 65 6e 2d 73 6f 75 72 63 65 20 77 65 62 73 69 74 65 2e 00 54 68 65 20 4c 69 6e 75 78 20 6b	open-source.website..The.Linux.k
18020	65 72 6e 65 6c 20 75 73 65 64 20 62 79 20 56 79 4f 53 20 69 73 20 68 65 61 76 69 6c 79 20 74 69	ernel.used.by.VyOS.is.heavily.ti
18040	65 64 20 74 6f 20 74 68 65 20 49 53 4f 20 62 75 69 6c 64 20 70 72 6f 63 65 73 73 2e 20 54 68 65	ed.to.the.ISO.build.process..The
18060	20 66 69 6c 65 20 60 60 64 61 74 61 2f 64 65 66 61 75 6c 74 73 2e 6a 73 6f 6e 60 60 20 68 6f 73	.file.``data/defaults.json``.hos
18080	74 73 20 61 20 4a 53 4f 4e 20 64 65 66 69 6e 69 74 69 6f 6e 20 6f 66 20 74 68 65 20 6b 65 72 6e	ts.a.JSON.definition.of.the.kern
180a0	65 6c 20 76 65 72 73 69 6f 6e 20 75 73 65 64 20 60 60 6b 65 72 6e 65 6c 5f 76 65 72 73 69 6f 6e	el.version.used.``kernel_version
180c0	60 60 20 61 6e 64 20 74 68 65 20 60 60 6b 65 72 6e 65 6c 5f 66 6c 61 76 6f 72 60 60 20 6f 66 20	``.and.the.``kernel_flavor``.of.
180e0	74 68 65 20 6b 65 72 6e 65 6c 20 77 68 69 63 68 20 72 65 70 72 65 73 65 6e 74 73 20 74 68 65 20	the.kernel.which.represents.the.
18100	6b 65 72 6e 65 6c 27 73 20 4c 4f 43 41 4c 5f 56 45 52 53 49 4f 4e 2e 20 42 6f 74 68 20 74 6f 67	kernel's.LOCAL_VERSION..Both.tog
18120	65 74 68 65 72 20 66 6f 72 6d 20 74 68 65 20 6b 65 72 6e 65 6c 20 76 65 72 73 69 6f 6e 20 76 61	ether.form.the.kernel.version.va
18140	72 69 61 62 6c 65 20 69 6e 20 74 68 65 20 73 79 73 74 65 6d 3a 00 54 68 65 20 4d 65 6c 6c 61 6e	riable.in.the.system:.The.Mellan
18160	6f 78 20 4f 46 45 44 20 64 72 69 76 65 72 73 20 64 6f 20 6e 6f 74 20 63 6f 6d 65 20 66 72 6f 6d	ox.OFED.drivers.do.not.come.from
18180	20 61 20 47 69 74 20 72 65 70 6f 73 69 74 6f 72 79 2c 20 69 6e 73 74 65 61 64 20 77 65 20 66 65	.a.Git.repository,.instead.we.fe
181a0	74 63 68 20 74 68 65 20 74 61 72 62 61 6c 6c 20 66 72 6f 6d 20 4e 76 69 64 69 61 20 61 6e 64 20	tch.the.tarball.from.Nvidia.and.
181c0	63 6f 6d 70 69 6c 65 20 74 68 65 20 73 6f 75 72 63 65 73 20 69 74 73 20 63 6f 6e 74 61 69 6e 73	compile.the.sources.its.contains
181e0	20 61 67 61 69 6e 73 74 20 6f 75 72 20 6b 65 72 6e 65 6c 20 74 72 65 65 2e 00 54 68 65 20 52 45	.against.our.kernel.tree..The.RE
18200	41 44 4d 45 2e 6d 64 20 66 69 6c 65 20 77 69 6c 6c 20 67 75 69 64 65 20 79 6f 75 20 74 6f 20 75	ADME.md.file.will.guide.you.to.u
18220	73 65 20 74 68 65 20 74 68 69 73 20 74 6f 70 20 6c 65 76 65 6c 20 72 65 70 6f 73 69 74 6f 72 79	se.the.this.top.level.repository
18240	2e 00 54 68 65 20 60 60 61 70 70 6c 79 28 29 60 60 20 61 6e 64 20 60 60 67 65 6e 65 72 61 74 65	..The.``apply()``.and.``generate
18260	28 29 60 60 20 66 75 6e 63 74 69 6f 6e 73 20 6d 61 79 20 60 60 72 61 69 73 65 20 43 6f 6e 66 69	()``.functions.may.``raise.Confi
18280	67 45 72 72 6f 72 60 60 20 69 66 2c 20 66 6f 72 20 65 78 61 6d 70 6c 65 2c 20 74 68 65 20 64 61	gError``.if,.for.example,.the.da
182a0	65 6d 6f 6e 20 66 61 69 6c 65 64 20 74 6f 20 73 74 61 72 74 20 77 69 74 68 20 74 68 65 20 75 70	emon.failed.to.start.with.the.up
182c0	64 61 74 65 64 20 63 6f 6e 66 69 67 2e 20 49 74 20 73 68 6f 75 6c 64 6e 27 74 20 62 65 20 61 20	dated.config..It.shouldn't.be.a.
182e0	73 75 62 73 74 69 74 75 74 65 20 66 6f 72 20 70 72 6f 70 65 72 20 63 6f 6e 66 69 67 20 63 68 65	substitute.for.proper.config.che
18300	63 6b 69 6e 67 20 69 6e 20 74 68 65 20 60 60 76 65 72 69 66 79 28 29 60 60 20 66 75 6e 63 74 69	cking.in.the.``verify()``.functi
18320	6f 6e 2e 20 41 6c 6c 20 72 65 61 73 6f 6e 61 62 6c 65 20 65 66 66 6f 72 74 20 73 68 6f 75 6c 64	on..All.reasonable.effort.should
18340	20 62 65 20 6d 61 64 65 20 74 6f 20 76 65 72 69 66 79 20 74 68 61 74 20 67 65 6e 65 72 61 74 65	.be.made.to.verify.that.generate
18360	64 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 69 73 20 76 61 6c 69 64 20 61 6e 64 20 77 69 6c	d.configuration.is.valid.and.wil
18380	6c 20 62 65 20 61 63 63 65 70 74 65 64 20 62 79 20 74 68 65 20 64 61 65 6d 6f 6e 2c 20 69 6e 63	l.be.accepted.by.the.daemon,.inc
183a0	6c 75 64 69 6e 67 2c 20 77 68 65 6e 20 6e 65 63 65 73 73 61 72 79 2c 20 63 72 6f 73 73 2d 20 63	luding,.when.necessary,.cross-.c
183c0	68 65 63 6b 73 20 77 69 74 68 20 6f 74 68 65 72 20 56 79 4f 53 20 63 6f 6e 66 69 67 75 72 61 74	hecks.with.other.VyOS.configurat
183e0	69 6f 6e 20 73 75 62 74 72 65 65 73 2e 00 54 68 65 20 60 60 61 70 70 6c 79 28 29 60 60 20 66 75	ion.subtrees..The.``apply()``.fu
18400	6e 63 74 69 6f 6e 20 61 70 70 6c 69 65 73 20 74 68 65 20 67 65 6e 65 72 61 74 65 64 20 63 6f 6e	nction.applies.the.generated.con
18420	66 69 67 75 72 61 74 69 6f 6e 20 74 6f 20 74 68 65 20 6c 69 76 65 20 73 79 73 74 65 6d 2e 20 49	figuration.to.the.live.system..I
18440	74 20 73 68 6f 75 6c 64 20 75 73 65 20 6e 6f 6e 2d 64 69 73 72 75 70 74 69 76 65 20 72 65 6c 6f	t.should.use.non-disruptive.relo
18460	61 64 20 77 68 65 6e 65 76 65 72 20 70 6f 73 73 69 62 6c 65 2e 20 49 74 20 6d 61 79 20 65 78 65	ad.whenever.possible..It.may.exe
18480	63 75 74 65 20 64 69 73 72 75 70 74 69 76 65 20 6f 70 65 72 61 74 69 6f 6e 73 20 73 75 63 68 20	cute.disruptive.operations.such.
184a0	61 73 20 64 61 65 6d 6f 6e 20 70 72 6f 63 65 73 73 20 72 65 73 74 61 72 74 20 69 66 20 61 20 70	as.daemon.process.restart.if.a.p
184c0	61 72 74 69 63 75 6c 61 72 20 63 6f 6d 70 6f 6e 65 6e 74 20 64 6f 65 73 20 6e 6f 74 20 73 75 70	articular.component.does.not.sup
184e0	70 6f 72 74 20 6e 6f 6e 2d 64 69 73 72 75 70 74 69 76 65 20 72 65 6c 6f 61 64 2c 20 6f 72 20 77	port.non-disruptive.reload,.or.w
18500	68 65 6e 20 74 68 65 20 65 78 70 65 63 74 65 64 20 73 65 72 76 69 63 65 20 64 65 67 72 61 64 61	hen.the.expected.service.degrada
18520	74 69 6f 6e 20 69 73 20 6d 69 6e 69 6d 61 6c 20 28 66 6f 72 20 65 78 61 6d 70 6c 65 2c 20 69 6e	tion.is.minimal.(for.example,.in
18540	20 63 61 73 65 20 6f 66 20 61 75 78 69 6c 69 61 72 79 20 73 65 72 76 69 63 65 73 20 73 75 63 68	.case.of.auxiliary.services.such
18560	20 61 73 20 4c 4c 44 50 64 29 2e 20 49 6e 20 63 61 73 65 20 6f 66 20 68 69 67 68 20 69 6d 70 61	.as.LLDPd)..In.case.of.high.impa
18580	63 74 20 73 65 72 76 69 63 65 73 20 73 75 63 68 20 61 73 20 56 50 4e 20 64 61 65 6d 6f 6e 20 61	ct.services.such.as.VPN.daemon.a
185a0	6e 64 20 72 6f 75 74 69 6e 67 20 70 72 6f 74 6f 63 6f 6c 73 2c 20 77 68 65 6e 20 6e 6f 6e 2d 20	nd.routing.protocols,.when.non-.
185c0	64 69 73 72 75 70 74 69 76 65 20 72 65 6c 6f 61 64 20 69 73 20 73 75 70 70 6f 72 74 65 64 20 66	disruptive.reload.is.supported.f
185e0	6f 72 20 73 6f 6d 65 20 62 75 74 20 6e 6f 74 20 61 6c 6c 20 74 79 70 65 73 20 6f 66 20 63 6f 6e	or.some.but.not.all.types.of.con
18600	66 69 67 75 72 61 74 69 6f 6e 20 63 68 61 6e 67 65 73 2c 20 73 63 72 69 70 74 73 20 61 75 74 68	figuration.changes,.scripts.auth
18620	6f 72 73 20 73 68 6f 75 6c 64 20 6d 61 6b 65 20 65 66 66 6f 72 74 20 74 6f 20 64 65 74 65 72 6d	ors.should.make.effort.to.determ
18640	69 6e 65 20 69 66 20 61 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 63 68 61 6e 67 65 20 63 61	ine.if.a.configuration.change.ca
18660	6e 20 62 65 20 64 6f 6e 65 20 69 6e 20 61 20 6e 6f 6e 2d 64 69 73 72 75 70 74 69 76 65 20 77 61	n.be.done.in.a.non-disruptive.wa
18680	79 20 61 6e 64 20 6f 6e 6c 79 20 72 65 73 6f 72 74 20 74 6f 20 64 69 73 72 75 70 74 69 76 65 20	y.and.only.resort.to.disruptive.
186a0	72 65 73 74 61 72 74 20 69 66 20 69 74 20 63 61 6e 6e 6f 74 20 62 65 20 61 76 6f 69 64 65 64 2e	restart.if.it.cannot.be.avoided.
186c0	00 54 68 65 20 60 60 67 65 6e 65 72 61 74 65 28 29 60 60 20 66 75 6e 63 74 69 6f 6e 20 67 65 6e	.The.``generate()``.function.gen
186e0	65 72 61 74 65 73 20 63 6f 6e 66 69 67 20 66 69 6c 65 73 20 66 6f 72 20 73 79 73 74 65 6d 20 63	erates.config.files.for.system.c
18700	6f 6d 70 6f 6e 65 6e 74 73 2e 00 54 68 65 20 60 60 67 65 74 5f 63 6f 6e 66 69 67 28 29 60 60 20	omponents..The.``get_config()``.
18720	66 75 6e 63 74 69 6f 6e 20 6d 75 73 74 20 63 6f 6e 76 65 72 74 20 74 68 65 20 56 79 4f 53 20 63	function.must.convert.the.VyOS.c
18740	6f 6e 66 69 67 20 74 6f 20 61 6e 20 61 62 73 74 72 61 63 74 2c 20 69 6e 74 65 72 6e 61 6c 20 72	onfig.to.an.abstract,.internal.r
18760	65 70 72 65 73 65 6e 74 61 74 69 6f 6e 2e 20 4e 6f 20 6f 74 68 65 72 20 66 75 6e 63 74 69 6f 6e	epresentation..No.other.function
18780	20 69 73 20 61 6c 6c 6f 77 65 64 20 74 6f 20 63 61 6c 6c 20 74 68 65 20 60 60 76 79 6f 73 2e 63	.is.allowed.to.call.the.``vyos.c
187a0	6f 6e 66 69 67 2e 20 43 6f 6e 66 69 67 60 60 20 6f 62 6a 65 63 74 20 6d 65 74 68 6f 64 20 64 69	onfig..Config``.object.method.di
187c0	72 65 63 74 6c 79 2e 20 54 68 65 20 72 61 74 69 6f 6e 61 6c 65 20 66 6f 72 20 69 74 20 69 73 20	rectly..The.rationale.for.it.is.
187e0	74 68 61 74 20 77 68 65 6e 20 63 6f 6e 66 69 67 20 72 65 61 64 73 20 61 72 65 20 6d 69 78 65 64	that.when.config.reads.are.mixed
18800	20 77 69 74 68 20 6f 74 68 65 72 20 6c 6f 67 69 63 2c 20 69 74 27 73 20 76 65 72 79 20 68 61 72	.with.other.logic,.it's.very.har
18820	64 20 74 6f 20 63 68 61 6e 67 65 20 74 68 65 20 63 6f 6e 66 69 67 20 73 79 6e 74 61 78 20 73 69	d.to.change.the.config.syntax.si
18840	6e 63 65 20 79 6f 75 20 6e 65 65 64 20 74 6f 20 77 65 65 64 20 6f 75 74 20 65 76 65 72 79 20 6f	nce.you.need.to.weed.out.every.o
18860	63 63 75 72 72 65 6e 63 65 20 6f 66 20 74 68 65 20 6f 6c 64 20 73 79 6e 74 61 78 2e 20 49 66 20	ccurrence.of.the.old.syntax..If.
18880	73 79 6e 74 61 78 2d 73 70 65 63 69 66 69 63 20 63 6f 64 65 20 69 73 20 63 6f 6e 66 69 6e 65 64	syntax-specific.code.is.confined
188a0	20 74 6f 20 61 20 73 69 6e 67 6c 65 20 66 75 6e 63 74 69 6f 6e 2c 20 74 68 65 20 72 65 73 74 20	.to.a.single.function,.the.rest.
188c0	6f 66 20 74 68 65 20 63 6f 64 65 20 63 61 6e 20 62 65 20 6c 65 66 74 20 75 6e 74 6f 75 63 68 65	of.the.code.can.be.left.untouche
188e0	64 20 61 73 20 6c 6f 6e 67 20 61 73 20 74 68 65 20 69 6e 74 65 72 6e 61 6c 20 72 65 70 72 65 73	d.as.long.as.the.internal.repres
18900	65 6e 74 61 74 69 6f 6e 20 72 65 6d 61 69 6e 73 20 63 6f 6d 70 61 74 69 62 6c 65 2e 00 54 68 65	entation.remains.compatible..The
18920	20 60 60 6d 61 6b 65 20 74 65 73 74 60 60 20 63 6f 6d 6d 61 6e 64 20 66 72 6f 6d 20 74 68 65 20	.``make.test``.command.from.the.
18940	76 79 6f 73 2d 62 75 69 6c 64 5f 20 72 65 70 6f 73 69 74 6f 72 79 20 77 69 6c 6c 20 6c 61 75 6e	vyos-build_.repository.will.laun
18960	63 68 20 61 20 6e 65 77 20 51 45 6d 75 20 69 6e 73 74 61 6e 63 65 20 61 6e 64 20 74 68 65 20 49	ch.a.new.QEmu.instance.and.the.I
18980	53 4f 20 69 6d 61 67 65 20 69 73 20 66 69 72 73 74 20 69 6e 73 74 61 6c 6c 65 64 20 74 6f 20 74	SO.image.is.first.installed.to.t
189a0	68 65 20 76 69 72 74 75 61 6c 20 68 61 72 64 64 69 73 6b 2e 00 54 68 65 20 60 60 76 65 72 69 66	he.virtual.harddisk..The.``verif
189c0	79 28 29 60 60 20 66 75 6e 63 74 69 6f 6e 20 74 61 6b 65 73 20 79 6f 75 72 20 69 6e 74 65 72 6e	y()``.function.takes.your.intern
189e0	61 6c 20 72 65 70 72 65 73 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 63 6f 6e 66 69 67 20	al.representation.of.the.config.
18a00	61 6e 64 20 63 68 65 63 6b 73 20 69 66 20 69 74 27 73 20 76 61 6c 69 64 2c 20 6f 74 68 65 72 77	and.checks.if.it's.valid,.otherw
18a20	69 73 65 20 69 74 20 6d 75 73 74 20 72 61 69 73 65 20 60 60 43 6f 6e 66 69 67 45 72 72 6f 72 60	ise.it.must.raise.``ConfigError`
18a40	60 20 77 69 74 68 20 61 6e 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65 20 74 68 61 74 20 64 65 73	`.with.an.error.message.that.des
18a60	63 72 69 62 65 73 20 74 68 65 20 70 72 6f 62 6c 65 6d 20 61 6e 64 20 70 6f 73 73 69 62 6c 79 20	cribes.the.problem.and.possibly.
18a80	73 75 67 67 65 73 74 73 20 68 6f 77 20 74 6f 20 66 69 78 20 69 74 2e 20 49 74 20 6d 75 73 74 20	suggests.how.to.fix.it..It.must.
18aa0	6e 6f 74 20 6d 61 6b 65 20 61 6e 79 20 63 68 61 6e 67 65 73 20 74 6f 20 74 68 65 20 73 79 73 74	not.make.any.changes.to.the.syst
18ac0	65 6d 2e 20 54 68 65 20 72 61 74 69 6f 6e 61 6c 65 20 66 6f 72 20 69 74 20 69 73 20 61 67 61 69	em..The.rationale.for.it.is.agai
18ae0	6e 20 74 65 73 74 61 62 69 6c 69 74 79 20 61 6e 64 2c 20 69 6e 20 74 68 65 20 66 75 74 75 72 65	n.testability.and,.in.the.future
18b00	20 77 68 65 6e 20 74 68 65 20 63 6f 6e 66 69 67 20 62 61 63 6b 65 6e 64 20 69 73 20 72 65 61 64	.when.the.config.backend.is.read
18b20	79 20 61 6e 64 20 65 76 65 72 79 20 73 63 72 69 70 74 20 69 73 20 72 65 77 72 69 74 74 65 6e 20	y.and.every.script.is.rewritten.
18b40	69 6e 20 74 68 69 73 20 66 61 73 68 69 6f 6e 2c 20 61 62 69 6c 69 74 79 20 74 6f 20 65 78 65 63	in.this.fashion,.ability.to.exec
18b60	75 74 65 20 63 6f 6d 6d 69 74 20 64 72 79 20 72 75 6e 20 28 22 63 6f 6d 6d 69 74 20 74 65 73 74	ute.commit.dry.run.("commit.test
18b80	22 20 6c 69 6b 65 20 69 6e 20 4a 75 6e 4f 53 29 20 61 6e 64 20 61 62 6f 72 74 20 63 6f 6d 6d 69	".like.in.JunOS).and.abort.commi
18ba0	74 20 62 65 66 6f 72 65 20 6d 61 6b 69 6e 67 20 61 6e 79 20 63 68 61 6e 67 65 73 20 74 6f 20 74	t.before.making.any.changes.to.t
18bc0	68 65 20 73 79 73 74 65 6d 20 69 66 20 61 6e 20 65 72 72 6f 72 20 69 73 20 66 6f 75 6e 64 20 69	he.system.if.an.error.is.found.i
18be0	6e 20 61 6e 79 20 63 6f 6d 70 6f 6e 65 6e 74 2e 00 54 68 65 20 62 61 73 68 20 28 6f 72 20 62 65	n.any.component..The.bash.(or.be
18c00	74 74 65 72 20 76 62 61 73 68 29 20 63 6f 6d 70 6c 65 74 69 6f 6e 20 69 6e 20 56 79 4f 53 20 69	tter.vbash).completion.in.VyOS.i
18c20	73 20 64 65 66 69 6e 65 64 20 69 6e 20 2a 74 65 6d 70 6c 61 74 65 73 2a 2e 20 54 65 6d 70 6c 61	s.defined.in.*templates*..Templa
18c40	74 65 73 20 61 72 65 20 74 65 78 74 20 66 69 6c 65 73 20 28 63 61 6c 6c 65 64 20 60 60 6e 6f 64	tes.are.text.files.(called.``nod
18c60	65 2e 64 65 66 60 60 29 20 73 74 6f 72 65 64 20 69 6e 20 61 20 64 69 72 65 63 74 6f 72 79 20 74	e.def``).stored.in.a.directory.t
18c80	72 65 65 2e 20 54 68 65 20 64 69 72 65 63 74 6f 72 79 20 6e 61 6d 65 73 20 64 65 66 69 6e 65 20	ree..The.directory.names.define.
18ca0	74 68 65 20 63 6f 6d 6d 61 6e 64 20 6e 61 6d 65 73 2c 20 61 6e 64 20 74 65 6d 70 6c 61 74 65 20	the.command.names,.and.template.
18cc0	66 69 6c 65 73 20 64 65 66 69 6e 65 20 74 68 65 20 63 6f 6d 6d 61 6e 64 20 62 65 68 61 76 69 6f	files.define.the.command.behavio
18ce0	75 72 2e 20 42 65 66 6f 72 65 20 56 79 4f 53 20 31 2e 32 20 28 63 72 75 78 29 20 74 68 69 73 20	ur..Before.VyOS.1.2.(crux).this.
18d00	66 69 6c 65 73 20 77 65 72 65 20 63 72 65 61 74 65 64 20 62 79 20 68 61 6e 64 2e 20 41 66 74 65	files.were.created.by.hand..Afte
18d20	72 20 61 20 63 6f 6d 70 6c 65 78 20 72 65 64 65 73 69 67 6e 20 70 72 6f 63 65 73 73 5f 20 74 68	r.a.complex.redesign.process_.th
18d40	65 20 6e 65 77 20 73 74 79 6c 65 20 74 65 6d 70 6c 61 74 65 20 61 72 65 20 61 75 74 6f 6d 61 74	e.new.style.template.are.automat
18d60	69 63 61 6c 6c 79 20 67 65 6e 65 72 61 74 65 64 20 66 72 6f 6d 20 61 20 58 4d 4c 20 69 6e 70 75	ically.generated.from.a.XML.inpu
18d80	74 20 66 69 6c 65 2e 00 54 68 65 20 62 65 68 61 76 69 6f 72 20 79 6f 75 20 65 78 70 65 63 74 20	t.file..The.behavior.you.expect.
18da0	61 6e 64 20 68 6f 77 20 69 74 27 73 20 64 69 66 66 65 72 65 6e 74 20 66 72 6f 6d 20 74 68 65 20	and.how.it's.different.from.the.
18dc0	62 65 68 61 76 69 6f 72 20 79 6f 75 20 6f 62 73 65 72 76 65 2e 20 44 6f 6e 27 74 20 6a 75 73 74	behavior.you.observe..Don't.just
18de0	20 69 6e 63 6c 75 64 65 20 63 6f 6d 6d 61 6e 64 20 6f 75 74 70 75 74 73 20 6f 72 20 74 72 61 66	.include.command.outputs.or.traf
18e00	66 69 63 20 64 75 6d 70 73 20 e2 80 94 20 74 72 79 20 74 6f 20 65 78 70 6c 61 69 6e 20 61 74 20	fic.dumps.....try.to.explain.at.
18e20	6c 65 61 73 74 20 62 72 69 65 66 6c 79 20 77 68 79 20 74 68 65 79 20 61 72 65 20 77 72 6f 6e 67	least.briefly.why.they.are.wrong
18e40	20 61 6e 64 20 77 68 61 74 20 74 68 65 79 20 73 68 6f 75 6c 64 20 62 65 2e 00 54 68 65 20 62 75	.and.what.they.should.be..The.bu
18e60	69 6c 64 20 70 72 6f 63 65 73 73 20 6e 65 65 64 73 20 74 6f 20 62 65 20 62 75 69 6c 74 20 6f 6e	ild.process.needs.to.be.built.on
18e80	20 61 20 6c 6f 63 61 6c 20 66 69 6c 65 20 73 79 73 74 65 6d 2c 20 62 75 69 6c 64 69 6e 67 20 6f	.a.local.file.system,.building.o
18ea0	6e 20 53 4d 42 20 6f 72 20 4e 46 53 20 73 68 61 72 65 73 20 77 69 6c 6c 20 72 65 73 75 6c 74 20	n.SMB.or.NFS.shares.will.result.
18ec0	69 6e 20 74 68 65 20 63 6f 6e 74 61 69 6e 65 72 20 66 61 69 6c 69 6e 67 20 74 6f 20 62 75 69 6c	in.the.container.failing.to.buil
18ee0	64 20 70 72 6f 70 65 72 6c 79 21 20 56 69 72 74 75 61 6c 42 6f 78 20 44 72 69 76 65 20 53 68 61	d.properly!.VirtualBox.Drive.Sha
18f00	72 65 20 69 73 20 61 6c 73 6f 20 6e 6f 74 20 61 6e 20 6f 70 74 69 6f 6e 20 61 73 20 62 6c 6f 63	re.is.also.not.an.option.as.bloc
18f20	6b 20 64 65 76 69 63 65 20 6f 70 65 72 61 74 69 6f 6e 73 20 61 72 65 20 6e 6f 74 20 69 6d 70 6c	k.device.operations.are.not.impl
18f40	65 6d 65 6e 74 65 64 20 61 6e 64 20 74 68 65 20 64 72 69 76 65 20 69 73 20 61 6c 77 61 79 73 20	emented.and.the.drive.is.always.
18f60	6d 6f 75 6e 74 65 64 20 61 73 20 22 6e 6f 64 65 76 22 00 54 68 65 20 63 6f 6e 66 69 67 75 72 61	mounted.as."nodev".The.configura
18f80	74 69 6f 6e 73 20 61 72 65 20 61 6c 6c 20 64 65 72 69 76 65 64 20 66 72 6f 6d 20 70 72 6f 64 75	tions.are.all.derived.from.produ
18fa0	63 74 69 6f 6e 20 73 79 73 74 65 6d 73 20 61 6e 64 20 63 61 6e 20 6e 6f 74 20 6f 6e 6c 79 20 61	ction.systems.and.can.not.only.a
18fc0	63 74 20 61 73 20 61 20 74 65 73 74 63 61 73 65 20 62 75 74 20 61 6c 73 6f 20 61 73 20 72 65 66	ct.as.a.testcase.but.also.as.ref
18fe0	65 72 65 6e 63 65 20 69 66 20 6f 6e 65 20 77 61 6e 74 73 20 74 6f 20 65 6e 61 62 6c 65 20 61 20	erence.if.one.wants.to.enable.a.
19000	63 65 72 74 61 69 6e 20 66 65 61 74 75 72 65 2e 20 54 68 65 20 63 6f 6e 66 69 67 75 72 61 74 69	certain.feature..The.configurati
19020	6f 6e 73 20 63 61 6e 20 62 65 20 66 6f 75 6e 64 20 68 65 72 65 3a 20 68 74 74 70 73 3a 2f 2f 67	ons.can.be.found.here:.https://g
19040	69 74 68 75 62 2e 63 6f 6d 2f 76 79 6f 73 2f 76 79 6f 73 2d 31 78 2f 74 72 65 65 2f 63 75 72 72	ithub.com/vyos/vyos-1x/tree/curr
19060	65 6e 74 2f 73 6d 6f 6b 65 74 65 73 74 2f 63 6f 6e 66 69 67 73 00 54 68 65 20 63 6f 6e 74 61 69	ent/smoketest/configs.The.contai
19080	6e 65 72 20 63 61 6e 20 61 6c 73 6f 20 62 65 20 62 75 69 6c 74 20 64 69 72 65 63 74 6c 79 20 66	ner.can.also.be.built.directly.f
190a0	72 6f 6d 20 73 6f 75 72 63 65 3a 00 54 68 65 20 63 6f 6e 74 61 69 6e 65 72 20 63 61 6e 20 62 65	rom.source:.The.container.can.be
190c0	20 62 75 69 6c 74 20 62 79 20 68 61 6e 64 20 6f 72 20 62 79 20 66 65 74 63 68 69 6e 67 20 74 68	.built.by.hand.or.by.fetching.th
190e0	65 20 70 72 65 2d 62 75 69 6c 74 20 6f 6e 65 20 66 72 6f 6d 20 44 6f 63 6b 65 72 48 75 62 2e 20	e.pre-built.one.from.DockerHub..
19100	55 73 69 6e 67 20 74 68 65 20 70 72 65 2d 62 75 69 6c 74 20 63 6f 6e 74 61 69 6e 65 72 73 20 66	Using.the.pre-built.containers.f
19120	72 6f 6d 20 74 68 65 20 60 56 79 4f 53 20 44 6f 63 6b 65 72 48 75 62 20 6f 72 67 61 6e 69 73 61	rom.the.`VyOS.DockerHub.organisa
19140	74 69 6f 6e 60 5f 20 77 69 6c 6c 20 65 6e 73 75 72 65 20 74 68 61 74 20 74 68 65 20 63 6f 6e 74	tion`_.will.ensure.that.the.cont
19160	61 69 6e 65 72 20 69 73 20 61 6c 77 61 79 73 20 75 70 2d 74 6f 2d 64 61 74 65 2e 20 41 20 72 65	ainer.is.always.up-to-date..A.re
19180	62 75 69 6c 64 20 69 73 20 74 72 69 67 67 65 72 65 64 20 6f 6e 63 65 20 74 68 65 20 63 6f 6e 74	build.is.triggered.once.the.cont
191a0	61 69 6e 65 72 20 63 68 61 6e 67 65 73 20 28 70 6c 65 61 73 65 20 6e 6f 74 65 20 74 68 69 73 20	ainer.changes.(please.note.this.
191c0	77 69 6c 6c 20 74 61 6b 65 20 32 2d 33 20 68 6f 75 72 73 20 61 66 74 65 72 20 70 75 73 68 69 6e	will.take.2-3.hours.after.pushin
191e0	67 20 74 6f 20 74 68 65 20 76 79 6f 73 2d 62 75 69 6c 64 20 72 65 70 6f 73 69 74 6f 72 79 29 2e	g.to.the.vyos-build.repository).
19200	00 54 68 65 20 64 65 66 61 75 6c 74 20 74 65 6d 70 6c 61 74 65 20 70 72 6f 63 65 73 73 6f 72 20	.The.default.template.processor.
19220	66 6f 72 20 56 79 4f 53 20 63 6f 64 65 20 69 73 20 4a 69 6e 6a 61 32 5f 2e 00 54 68 65 20 65 61	for.VyOS.code.is.Jinja2_..The.ea
19240	73 69 65 73 74 20 77 61 79 20 74 6f 20 63 6f 6d 70 69 6c 65 20 79 6f 75 72 20 70 61 63 6b 61 67	siest.way.to.compile.your.packag
19260	65 20 69 73 20 77 69 74 68 20 74 68 65 20 61 62 6f 76 65 20 6d 65 6e 74 69 6f 6e 65 64 20 3a 72	e.is.with.the.above.mentioned.:r
19280	65 66 3a 60 62 75 69 6c 64 5f 64 6f 63 6b 65 72 60 20 63 6f 6e 74 61 69 6e 65 72 2c 20 69 74 20	ef:`build_docker`.container,.it.
192a0	69 6e 63 6c 75 64 65 73 20 61 6c 6c 20 72 65 71 75 69 72 65 64 20 64 65 70 65 6e 64 65 6e 63 69	includes.all.required.dependenci
192c0	65 73 20 66 6f 72 20 61 6c 6c 20 56 79 4f 53 20 72 65 6c 61 74 65 64 20 70 61 63 6b 61 67 65 73	es.for.all.VyOS.related.packages
192e0	2e 00 54 68 65 20 65 6e 74 69 72 65 20 74 65 73 74 20 69 73 20 63 6f 6e 74 72 6f 6c 6c 65 64 20	..The.entire.test.is.controlled.
19300	62 79 20 74 68 65 20 6d 61 69 6e 20 77 72 61 70 70 65 72 20 73 63 72 69 70 74 20 60 60 2f 75 73	by.the.main.wrapper.script.``/us
19320	72 2f 62 69 6e 2f 76 79 6f 73 2d 63 6f 6e 66 69 67 74 65 73 74 60 60 20 77 68 69 63 68 20 62 65	r/bin/vyos-configtest``.which.be
19340	68 61 76 65 73 20 69 6e 20 74 68 65 20 73 61 6d 65 20 77 61 79 20 61 73 20 74 68 65 20 6d 61 69	haves.in.the.same.way.as.the.mai
19360	6e 20 73 6d 6f 6b 65 74 65 73 74 20 73 63 72 69 70 74 2e 20 49 74 20 73 63 61 6e 73 20 74 68 65	n.smoketest.script..It.scans.the
19380	20 66 6f 6c 64 65 72 20 66 6f 72 20 70 6f 74 65 6e 74 69 61 6c 20 63 6f 6e 66 69 67 75 72 61 74	.folder.for.potential.configurat
193a0	69 6f 6e 20 66 69 6c 65 73 20 61 6e 64 20 69 73 73 75 65 73 20 61 20 60 60 6c 6f 61 64 60 60 20	ion.files.and.issues.a.``load``.
193c0	63 6f 6d 6d 61 6e 64 20 6f 6e 65 20 61 66 74 65 72 20 61 6e 6f 74 68 65 72 2e 00 54 68 65 20 66	command.one.after.another..The.f
193e0	69 6c 65 20 63 61 6e 20 62 65 20 70 6c 61 63 65 64 20 69 6e 20 60 60 2f 74 6d 70 60 60 20 66 6f	ile.can.be.placed.in.``/tmp``.fo
19400	72 20 6f 6e 65 20 74 69 6d 65 20 64 65 62 75 67 67 69 6e 67 20 28 61 73 20 74 68 65 20 66 69 6c	r.one.time.debugging.(as.the.fil
19420	65 20 77 69 6c 6c 20 62 65 20 72 65 6d 6f 76 65 64 20 6f 6e 20 72 65 62 6f 6f 74 29 20 6f 72 20	e.will.be.removed.on.reboot).or.
19440	70 6c 61 63 65 64 20 69 6e 20 27 2f 63 6f 6e 66 69 67 27 20 74 6f 20 73 74 61 79 20 70 65 72 6d	placed.in.'/config'.to.stay.perm
19460	61 6e 65 6e 74 6c 79 2e 00 54 68 65 20 66 69 72 73 74 20 77 6f 72 64 20 6f 66 20 65 76 65 72 79	anently..The.first.word.of.every
19480	20 68 65 6c 70 20 73 74 72 69 6e 67 20 2a 2a 6d 75 73 74 2a 2a 20 62 65 20 63 61 70 69 74 61 6c	.help.string.**must**.be.capital
194a0	69 7a 65 64 2e 20 54 68 65 72 65 20 2a 2a 6d 75 73 74 20 6e 6f 74 2a 2a 20 62 65 20 61 20 70 65	ized..There.**must.not**.be.a.pe
194c0	72 69 6f 64 20 61 74 20 74 68 65 20 65 6e 64 20 6f 66 20 68 65 6c 70 20 73 74 72 69 6e 67 73 2e	riod.at.the.end.of.help.strings.
194e0	00 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 69 6e 63 6c 75 64 65 73 20 74 68 65 20 62 75 69 6c	.The.following.includes.the.buil
19500	64 20 70 72 6f 63 65 73 73 20 66 6f 72 20 56 79 4f 53 20 31 2e 32 20 74 6f 20 74 68 65 20 6c 61	d.process.for.VyOS.1.2.to.the.la
19520	74 65 73 74 20 76 65 72 73 69 6f 6e 2e 00 54 68 65 20 66 6f 72 6d 61 74 20 73 68 6f 75 6c 64 20	test.version..The.format.should.
19540	62 65 20 61 6e 64 20 69 73 20 69 6e 73 70 69 72 65 64 20 62 79 3a 20 68 74 74 70 73 3a 2f 2f 67	be.and.is.inspired.by:.https://g
19560	69 74 2d 73 63 6d 2e 63 6f 6d 2f 62 6f 6f 6b 2f 63 68 35 2d 32 2e 68 74 6d 6c 20 49 74 20 69 73	it-scm.com/book/ch5-2.html.It.is
19580	20 61 6c 73 6f 20 77 6f 72 74 68 20 72 65 61 64 69 6e 67 20 68 74 74 70 73 3a 2f 2f 63 68 72 69	.also.worth.reading.https://chri
195a0	73 2e 62 65 61 6d 73 2e 69 6f 2f 70 6f 73 74 73 2f 67 69 74 2d 63 6f 6d 6d 69 74 2f 00 54 68 65	s.beams.io/posts/git-commit/.The
195c0	20 67 72 65 61 74 20 74 68 69 6e 67 20 61 62 6f 75 74 20 73 63 68 65 6d 61 73 20 69 73 20 6e 6f	.great.thing.about.schemas.is.no
195e0	74 20 6f 6e 6c 79 20 74 68 61 74 20 70 65 6f 70 6c 65 20 63 61 6e 20 6b 6e 6f 77 20 74 68 65 20	t.only.that.people.can.know.the.
19600	63 6f 6d 70 6c 65 74 65 20 67 72 61 6d 6d 61 72 20 66 6f 72 20 63 65 72 74 61 69 6e 2c 20 62 75	complete.grammar.for.certain,.bu
19620	74 20 61 6c 73 6f 20 74 68 61 74 20 69 74 20 63 61 6e 20 62 65 20 61 75 74 6f 6d 61 74 69 63 61	t.also.that.it.can.be.automatica
19640	6c 6c 79 20 76 65 72 69 66 69 65 64 2e 20 54 68 65 20 60 73 63 72 69 70 74 73 2f 62 75 69 6c 64	lly.verified..The.`scripts/build
19660	2d 63 6f 6d 6d 61 6e 64 2d 74 65 6d 70 6c 61 74 65 73 60 20 73 63 72 69 70 74 20 74 68 61 74 20	-command-templates`.script.that.
19680	63 6f 6e 76 65 72 74 73 20 74 68 65 20 58 4d 4c 20 64 65 66 69 6e 69 74 69 6f 6e 73 20 74 6f 20	converts.the.XML.definitions.to.
196a0	6f 6c 64 20 73 74 79 6c 65 20 74 65 6d 70 6c 61 74 65 73 20 61 6c 73 6f 20 76 65 72 69 66 69 65	old.style.templates.also.verifie
196c0	73 20 74 68 65 6d 20 61 67 61 69 6e 73 74 20 74 68 65 20 73 63 68 65 6d 61 2c 20 73 6f 20 61 20	s.them.against.the.schema,.so.a.
196e0	62 61 64 20 64 65 66 69 6e 69 74 69 6f 6e 20 77 69 6c 6c 20 63 61 75 73 65 20 74 68 65 20 70 61	bad.definition.will.cause.the.pa
19700	63 6b 61 67 65 20 62 75 69 6c 64 20 74 6f 20 66 61 69 6c 2e 20 49 20 64 6f 20 61 67 72 65 65 20	ckage.build.to.fail..I.do.agree.
19720	74 68 61 74 20 74 68 65 20 66 6f 72 6d 61 74 20 69 73 20 76 65 72 62 6f 73 65 2c 20 62 75 74 20	that.the.format.is.verbose,.but.
19740	74 68 65 72 65 20 69 73 20 6e 6f 20 6f 74 68 65 72 20 66 6f 72 6d 61 74 20 6e 6f 77 20 74 68 61	there.is.no.other.format.now.tha
19760	74 20 77 6f 75 6c 64 20 61 6c 6c 6f 77 20 74 68 69 73 2e 20 42 65 73 69 64 65 73 2c 20 61 20 73	t.would.allow.this..Besides,.a.s
19780	70 65 63 69 61 6c 69 7a 65 64 20 58 4d 4c 20 65 64 69 74 6f 72 20 63 61 6e 20 61 6c 6c 65 76 69	pecialized.XML.editor.can.allevi
197a0	61 74 65 20 74 68 65 20 69 73 73 75 65 20 77 69 74 68 20 76 65 72 62 6f 73 69 74 79 2e 00 54 68	ate.the.issue.with.verbosity..Th
197c0	65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 69 73 20 75 73 65 64 20 69 6e 20 74 68 72 65 65 20 77	e.information.is.used.in.three.w
197e0	61 79 73 3a 00 54 68 65 20 6b 65 72 6e 65 6c 20 62 75 69 6c 64 20 69 73 20 71 75 69 74 65 20 65	ays:.The.kernel.build.is.quite.e
19800	61 73 79 2c 20 6d 6f 73 74 20 6f 66 20 74 68 65 20 72 65 71 75 69 72 65 64 20 73 74 65 70 73 20	asy,.most.of.the.required.steps.
19820	63 61 6e 20 62 65 20 66 6f 75 6e 64 20 69 6e 20 74 68 65 20 60 60 76 79 6f 73 2d 62 75 69 6c 64	can.be.found.in.the.``vyos-build
19840	2f 70 61 63 6b 61 67 65 73 2f 6c 69 6e 75 78 2d 6b 65 72 6e 65 6c 2f 4a 65 6e 6b 69 6e 73 66 69	/packages/linux-kernel/Jenkinsfi
19860	6c 65 60 60 20 62 75 74 20 77 65 20 77 69 6c 6c 20 77 61 6c 6b 20 79 6f 75 20 74 68 72 6f 75 67	le``.but.we.will.walk.you.throug
19880	68 20 69 74 2e 00 54 68 65 20 6d 6f 73 74 20 6f 62 76 69 6f 75 73 20 72 65 61 73 6f 6e 73 20 63	h.it..The.most.obvious.reasons.c
198a0	6f 75 6c 64 20 62 65 3a 00 54 68 65 20 6f 72 69 67 69 6e 61 6c 20 72 65 70 6f 20 69 73 20 61 74	ould.be:.The.original.repo.is.at
198c0	20 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 64 6d 62 61 74 75 72 69 6e 2f 68 76	.https://github.com/dmbaturin/hv
198e0	69 6e 66 6f 00 54 68 65 20 6f 74 68 65 72 20 70 61 72 74 20 6f 66 20 6f 75 72 20 74 65 73 74 73	info.The.other.part.of.our.tests
19900	20 61 72 65 20 63 61 6c 6c 65 64 20 22 63 6f 6e 66 69 67 20 6c 6f 61 64 20 74 65 73 74 73 22 2e	.are.called."config.load.tests".
19920	20 54 68 65 20 63 6f 6e 66 69 67 20 6c 6f 61 64 20 74 65 73 74 73 20 77 69 6c 6c 20 6c 6f 61 64	.The.config.load.tests.will.load
19940	20 2d 20 6f 6e 65 20 61 66 74 65 72 20 61 6e 6f 74 68 65 72 20 2d 20 61 72 62 69 74 72 61 72 79	.-.one.after.another.-.arbitrary
19960	20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 66 69 6c 65 73 20 74 6f 20 74 65 73 74 20 69 66 20	.configuration.files.to.test.if.
19980	74 68 65 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 6d 69 67 72 61 74 69 6f 6e 20 73 63 72 69	the.configuration.migration.scri
199a0	70 74 73 20 77 6f 72 6b 20 61 73 20 64 65 73 69 67 6e 65 64 20 61 6e 64 20 74 68 61 74 20 61 20	pts.work.as.designed.and.that.a.
199c0	67 69 76 65 6e 20 73 65 74 20 6f 66 20 66 75 6e 63 74 69 6f 6e 61 6c 69 74 79 20 73 74 69 6c 6c	given.set.of.functionality.still
199e0	20 63 61 6e 20 62 65 20 6c 6f 61 64 65 64 20 77 69 74 68 20 61 20 66 72 65 73 68 20 56 79 4f 53	.can.be.loaded.with.a.fresh.VyOS
19a00	20 49 53 4f 20 69 6d 61 67 65 2e 00 54 68 65 20 6f 75 74 70 75 74 20 79 6f 75 20 67 65 74 20 77	.ISO.image..The.output.you.get.w
19a20	68 65 6e 20 79 6f 75 20 66 69 6e 64 20 61 20 62 75 67 20 63 61 6e 20 70 72 6f 76 69 64 65 20 6c	hen.you.find.a.bug.can.provide.l
19a40	6f 74 73 20 6f 66 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e 20 49 66 20 79 6f 75 20 67 65 74 20 61	ots.of.information..If.you.get.a
19a60	6e 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65 20 6f 6e 20 74 68 65 20 73 63 72 65 65 6e 2c 20 63	n.error.message.on.the.screen,.c
19a80	6f 70 79 20 69 74 20 65 78 61 63 74 6c 79 2e 20 48 61 76 69 6e 67 20 74 68 65 20 65 78 61 63 74	opy.it.exactly..Having.the.exact
19aa0	20 6d 65 73 73 61 67 65 20 63 61 6e 20 70 72 6f 76 69 64 65 20 64 65 74 61 69 6c 20 74 68 61 74	.message.can.provide.detail.that
19ac0	20 74 68 65 20 64 65 76 65 6c 6f 70 65 72 73 20 63 61 6e 20 75 73 65 2e 20 4c 69 6b 65 20 77 69	.the.developers.can.use..Like.wi
19ae0	73 65 20 69 66 20 79 6f 75 20 68 61 76 65 20 61 6e 79 20 6c 6f 67 20 6d 65 73 73 61 67 65 73 20	se.if.you.have.any.log.messages.
19b00	74 68 61 74 20 61 6c 73 6f 20 61 72 65 20 66 72 6f 6d 20 74 68 65 20 74 69 6d 65 20 6f 66 20 74	that.also.are.from.the.time.of.t
19b20	68 65 20 69 73 73 75 65 2c 20 69 6e 63 6c 75 64 65 20 74 68 6f 73 65 2e 20 54 68 65 79 20 6d 61	he.issue,.include.those..They.ma
19b40	79 20 61 6c 73 6f 20 63 6f 6e 74 61 69 6e 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 74 68 61 74 20	y.also.contain.information.that.
19b60	69 73 20 68 65 6c 70 66 75 6c 20 66 6f 72 20 74 68 65 20 64 65 76 65 6c 6f 70 6d 65 6e 74 20 74	is.helpful.for.the.development.t
19b80	65 61 6d 2e 00 54 68 65 20 70 61 63 6b 61 67 65 20 65 6e 64 73 20 75 70 20 69 6e 20 64 65 62 5f	eam..The.package.ends.up.in.deb_
19ba0	64 69 73 74 20 64 69 72 2e 00 54 68 65 20 72 65 61 73 6f 6e 20 69 73 20 74 68 61 74 20 74 68 65	dist.dir..The.reason.is.that.the
19bc0	20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 6d 69 67 72 61 74 69 6f 6e 20 62 61 63 6b 65 6e 64	.configuration.migration.backend
19be0	20 69 73 20 72 65 77 72 69 74 74 65 6e 20 61 6e 64 20 75 73 65 73 20 61 20 6e 65 77 20 66 6f 72	.is.rewritten.and.uses.a.new.for
19c00	6d 20 6f 66 20 22 6d 61 67 69 63 20 73 74 72 69 6e 67 22 20 77 68 69 63 68 20 69 73 20 61 70 70	m.of."magic.string".which.is.app
19c20	6c 69 65 64 20 6f 6e 20 64 65 6d 61 6e 64 20 77 68 65 6e 20 72 65 61 6c 20 63 6f 6e 66 69 67 20	lied.on.demand.when.real.config.
19c40	6d 69 67 72 61 74 69 6f 6e 20 69 73 20 72 75 6e 20 6f 6e 20 62 6f 6f 74 2e 20 57 68 65 6e 20 72	migration.is.run.on.boot..When.r
19c60	75 6e 6e 69 6e 67 20 69 6e 64 69 76 69 64 75 61 6c 20 6d 69 67 72 61 74 6f 72 73 20 66 6f 72 20	unning.individual.migrators.for.
19c80	74 65 73 74 69 6e 67 2c 20 79 6f 75 20 6e 65 65 64 20 74 6f 20 63 6f 6e 76 65 72 74 20 74 68 65	testing,.you.need.to.convert.the
19ca0	20 22 6d 61 67 69 63 20 73 74 72 69 6e 67 22 20 6f 6e 20 79 6f 75 72 20 6f 77 6e 20 62 79 3a 00	."magic.string".on.your.own.by:.
19cc0	54 68 65 20 72 65 61 73 6f 6e 20 69 73 20 74 68 61 74 20 74 68 65 20 63 6f 6e 66 69 67 75 72 61	The.reason.is.that.the.configura
19ce0	74 69 6f 6e 20 6d 69 67 72 61 74 69 6f 6e 20 62 61 63 6b 65 6e 64 20 69 73 20 72 65 77 72 69 74	tion.migration.backend.is.rewrit
19d00	74 65 6e 20 61 6e 64 20 75 73 65 73 20 61 20 6e 65 77 20 66 6f 72 6d 20 6f 66 20 22 6d 61 67 69	ten.and.uses.a.new.form.of."magi
19d20	63 20 73 74 72 69 6e 67 22 20 77 68 69 63 68 20 69 73 20 61 70 70 6c 69 65 64 20 6f 6e 20 64 65	c.string".which.is.applied.on.de
19d40	6d 61 6e 64 20 77 68 65 6e 20 72 65 61 6c 20 63 6f 6e 66 69 67 20 6d 69 67 72 61 74 69 6f 6e 20	mand.when.real.config.migration.
19d60	69 73 20 72 75 6e 20 6f 6e 20 62 6f 6f 74 2e 20 57 68 65 6e 20 72 75 6e 6e 69 6e 74 20 69 6e 64	is.run.on.boot..When.runnint.ind
19d80	69 76 69 64 75 61 6c 20 6d 69 67 72 61 74 6f 72 73 20 66 6f 72 20 74 65 73 74 69 6e 67 2c 20 79	ividual.migrators.for.testing,.y
19da0	6f 75 20 6e 65 65 64 20 74 6f 20 63 6f 6e 76 65 72 74 20 74 68 65 20 22 6d 61 67 69 63 20 73 74	ou.need.to.convert.the."magic.st
19dc0	72 69 6e 67 22 20 6f 6e 20 79 6f 75 72 20 6f 77 6e 20 62 79 3a 00 54 68 65 20 72 65 70 6f 73 69	ring".on.your.own.by:.The.reposi
19de0	74 6f 72 79 20 74 68 61 74 20 63 6f 6e 74 61 69 6e 73 20 61 6c 6c 20 74 68 65 20 49 53 4f 20 62	tory.that.contains.all.the.ISO.b
19e00	75 69 6c 64 20 73 63 72 69 70 74 73 20 69 73 3a 20 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e	uild.scripts.is:.https://github.
19e20	63 6f 6d 2f 76 79 6f 73 2f 76 79 6f 73 2d 62 75 69 6c 64 00 54 68 65 20 73 63 72 69 70 74 20 6f	com/vyos/vyos-build.The.script.o
19e40	6e 6c 79 20 73 65 61 72 63 68 65 73 20 66 6f 72 20 65 78 65 63 75 74 61 62 6c 65 20 22 74 65 73	nly.searches.for.executable."tes
19e60	74 2d 63 61 73 65 73 22 20 75 6e 64 65 72 20 60 60 2f 75 73 72 2f 6c 69 62 65 78 65 63 2f 76 79	t-cases".under.``/usr/libexec/vy
19e80	6f 73 2f 74 65 73 74 73 2f 73 6d 6f 6b 65 2f 63 6c 69 2f 60 60 20 61 6e 64 20 65 78 65 63 75 74	os/tests/smoke/cli/``.and.execut
19ea0	65 73 20 74 68 65 6d 20 6f 6e 65 20 62 79 20 6f 6e 65 2e 00 54 68 65 20 73 6f 75 72 63 65 20 63	es.them.one.by.one..The.source.c
19ec0	6f 64 65 20 72 65 6d 61 69 6e 73 20 70 75 62 6c 69 63 20 61 6e 64 20 61 6e 20 49 53 4f 20 63 61	ode.remains.public.and.an.ISO.ca
19ee0	6e 20 62 65 20 62 75 69 6c 74 20 75 73 69 6e 67 20 74 68 65 20 70 72 6f 63 65 73 73 20 6f 75 74	n.be.built.using.the.process.out
19f00	6c 69 6e 65 64 20 69 6e 20 74 68 69 73 20 63 68 61 70 74 65 72 2e 00 54 68 65 20 73 6f 75 72 63	lined.in.this.chapter..The.sourc
19f20	65 20 69 73 20 61 74 20 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 76 79 6f 73 2f	e.is.at.https://github.com/vyos/
19f40	76 79 6f 73 2d 73 74 72 6f 6e 67 73 77 61 6e 00 54 68 65 20 73 6f 75 72 63 65 20 69 73 20 6c 6f	vyos-strongswan.The.source.is.lo
19f60	63 61 74 65 64 20 61 74 20 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 76 79 6f 73	cated.at.https://github.com/vyos
19f80	2f 76 79 6f 73 2d 6e 65 74 70 6c 75 67 00 54 68 65 20 73 77 69 74 63 68 20 74 6f 20 74 68 65 20	/vyos-netplug.The.switch.to.the.
19fa0	50 79 74 68 6f 6e 20 70 72 6f 67 72 61 6d 6d 69 6e 67 20 6c 61 6e 67 75 61 67 65 20 66 6f 72 20	Python.programming.language.for.
19fc0	6e 65 77 20 63 6f 64 65 20 69 73 20 6e 6f 74 20 6d 65 72 65 6c 79 20 61 20 63 68 61 6e 67 65 20	new.code.is.not.merely.a.change.
19fe0	6f 66 20 74 68 65 20 6c 61 6e 67 75 61 67 65 2c 20 62 75 74 20 61 20 63 68 61 6e 63 65 20 74 6f	of.the.language,.but.a.chance.to
1a000	20 72 65 74 68 69 6e 6b 20 61 6e 64 20 69 6d 70 72 6f 76 65 20 74 68 65 20 70 72 6f 67 72 61 6d	.rethink.and.improve.the.program
1a020	6d 69 6e 67 20 61 70 70 72 6f 61 63 68 2e 00 54 68 65 20 73 79 73 74 65 6d 20 73 74 61 72 74 75	ming.approach..The.system.startu
1a040	70 20 63 61 6e 20 62 65 20 64 65 62 75 67 67 65 64 20 28 6c 69 6b 65 20 6c 6f 61 64 69 6e 67 20	p.can.be.debugged.(like.loading.
1a060	69 6e 20 74 68 65 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 66 69 6c 65 20 66 72 6f 6d 20 60	in.the.configuration.file.from.`
1a080	60 2f 63 6f 6e 66 69 67 2f 63 6f 6e 66 69 67 2e 62 6f 6f 74 60 60 2e 20 54 68 69 73 20 63 61 6e	`/config/config.boot``..This.can
1a0a0	20 62 65 20 61 63 68 69 65 76 65 20 62 79 20 65 78 74 65 6e 64 69 6e 67 20 74 68 65 20 4b 65 72	.be.achieve.by.extending.the.Ker
1a0c0	6e 65 6c 20 63 6f 6d 6d 61 6e 64 2d 6c 69 6e 65 20 69 6e 20 74 68 65 20 62 6f 6f 74 6c 6f 61 64	nel.command-line.in.the.bootload
1a0e0	65 72 2e 00 54 68 65 72 65 20 61 72 65 20 28 72 61 72 65 29 20 73 69 74 75 61 74 69 6f 6e 73 20	er..There.are.(rare).situations.
1a100	77 68 65 72 65 20 62 75 69 6c 64 69 6e 67 20 61 6e 20 49 53 4f 20 69 6d 61 67 65 20 69 73 20 6e	where.building.an.ISO.image.is.n
1a120	6f 74 20 70 6f 73 73 69 62 6c 65 20 61 74 20 61 6c 6c 20 64 75 65 20 74 6f 20 61 20 62 72 6f 6b	ot.possible.at.all.due.to.a.brok
1a140	65 6e 20 70 61 63 6b 61 67 65 20 66 65 65 64 20 69 6e 20 74 68 65 20 62 61 63 6b 67 72 6f 75 6e	en.package.feed.in.the.backgroun
1a160	64 2e 20 41 50 54 20 69 73 20 6e 6f 74 20 76 65 72 79 20 67 6f 6f 64 20 61 74 20 72 65 70 6f 72	d..APT.is.not.very.good.at.repor
1a180	74 69 6e 67 20 74 68 65 20 72 6f 6f 74 20 63 61 75 73 65 20 6f 66 20 74 68 65 20 69 73 73 75 65	ting.the.root.cause.of.the.issue
1a1a0	2e 20 59 6f 75 72 20 49 53 4f 20 62 75 69 6c 64 20 77 69 6c 6c 20 6c 69 6b 65 6c 79 20 66 61 69	..Your.ISO.build.will.likely.fai
1a1c0	6c 20 77 69 74 68 20 61 20 6d 6f 72 65 20 6f 72 20 6c 65 73 73 20 73 69 6d 69 6c 61 72 20 6c 6f	l.with.a.more.or.less.similar.lo
1a1e0	6f 6b 69 6e 67 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65 3a 00 54 68 65 72 65 20 61 72 65 20 64	oking.error.message:.There.are.d
1a200	69 66 66 65 72 65 6e 74 20 77 61 79 73 20 79 6f 75 20 63 61 6e 20 62 75 69 6c 64 20 56 79 4f 53	ifferent.ways.you.can.build.VyOS
1a220	2e 00 54 68 65 72 65 20 61 72 65 20 65 78 74 65 6e 73 69 6f 6e 73 20 74 6f 20 65 2e 67 2e 20 56	..There.are.extensions.to.e.g..V
1a240	49 4d 20 28 78 6d 6c 6c 69 6e 74 29 20 77 68 69 63 68 20 77 69 6c 6c 20 68 65 6c 70 20 79 6f 75	IM.(xmllint).which.will.help.you
1a260	20 74 6f 20 67 65 74 20 79 6f 75 72 20 69 6e 64 65 6e 74 69 6f 6e 20 6c 65 76 65 6c 73 20 63 6f	.to.get.your.indention.levels.co
1a280	72 72 65 63 74 2e 20 41 64 64 20 74 6f 20 66 6f 6c 6c 6f 77 69 6e 67 20 74 6f 20 79 6f 75 72 20	rrect..Add.to.following.to.your.
1a2a0	2e 76 69 6d 72 63 20 66 69 6c 65 3a 20 60 60 61 75 20 46 69 6c 65 54 79 70 65 20 78 6d 6c 20 73	.vimrc.file:.``au.FileType.xml.s
1a2c0	65 74 6c 6f 63 61 6c 20 65 71 75 61 6c 70 72 67 3d 78 6d 6c 6c 69 6e 74 5c 20 2d 2d 66 6f 72 6d	etlocal.equalprg=xmllint\.--form
1a2e0	61 74 5c 20 2d 2d 72 65 63 6f 76 65 72 5c 20 2d 5c 20 32 3e 2f 64 65 76 2f 6e 75 6c 6c 60 60 20	at\.--recover\.-\.2>/dev/null``.
1a300	6e 6f 77 20 79 6f 75 20 63 61 6e 20 63 61 6c 6c 20 74 68 65 20 6c 69 6e 74 65 72 20 75 73 69 6e	now.you.can.call.the.linter.usin
1a320	67 20 60 60 67 67 3d 47 60 60 20 69 6e 20 63 6f 6d 6d 61 6e 64 20 6d 6f 64 65 2e 00 54 68 65 72	g.``gg=G``.in.command.mode..Ther
1a340	65 20 61 72 65 20 74 77 6f 20 66 6c 61 67 73 20 61 76 61 69 6c 61 62 6c 65 20 74 6f 20 61 69 64	e.are.two.flags.available.to.aid
1a360	20 69 6e 20 64 65 62 75 67 67 69 6e 67 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 73 63 72 69	.in.debugging.configuration.scri
1a380	70 74 73 2e 20 53 69 6e 63 65 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 6c 6f 61 64 69 6e 67	pts..Since.configuration.loading
1a3a0	20 69 73 73 75 65 73 20 77 69 6c 6c 20 6d 61 6e 69 66 65 73 74 20 64 75 72 69 6e 67 20 62 6f 6f	.issues.will.manifest.during.boo
1a3c0	74 2c 20 74 68 65 20 66 6c 61 67 73 20 61 72 65 20 70 61 73 73 65 64 20 61 73 20 6b 65 72 6e 65	t,.the.flags.are.passed.as.kerne
1a3e0	6c 20 62 6f 6f 74 20 70 61 72 61 6d 65 74 65 72 73 2e 00 54 68 65 72 65 20 69 73 20 61 20 73 70	l.boot.parameters..There.is.a.sp
1a400	65 63 69 61 6c 20 73 74 61 74 75 73 20 66 6f 72 20 74 61 73 6b 73 20 77 68 65 72 65 20 61 6c 6c	ecial.status.for.tasks.where.all
1a420	20 77 6f 72 6b 20 6f 6e 20 74 68 65 20 73 69 64 65 20 6f 66 20 6d 61 69 6e 74 61 69 6e 65 72 73	.work.on.the.side.of.maintainers
1a440	20 61 6e 64 20 63 6f 6e 74 72 69 62 75 74 6f 72 73 20 69 73 20 63 6f 6d 70 6c 65 74 65 3a 20 22	.and.contributors.is.complete:."
1a460	4e 65 65 64 73 20 72 65 70 6f 72 74 65 72 20 61 63 74 69 6f 6e 22 2e 00 54 68 69 73 20 49 53 4f	Needs.reporter.action"..This.ISO
1a480	20 63 61 6e 20 62 65 20 63 75 73 74 6f 6d 69 7a 65 64 20 77 69 74 68 20 74 68 65 20 66 6f 6c 6c	.can.be.customized.with.the.foll
1a4a0	6f 77 69 6e 67 20 6c 69 73 74 20 6f 66 20 63 6f 6e 66 69 67 75 72 65 20 6f 70 74 69 6f 6e 73 2e	owing.list.of.configure.options.
1a4c0	20 54 68 65 20 66 75 6c 6c 20 61 6e 64 20 63 75 72 72 65 6e 74 20 6c 69 73 74 20 63 61 6e 20 62	.The.full.and.current.list.can.b
1a4e0	65 20 67 65 6e 65 72 61 74 65 64 20 77 69 74 68 20 60 60 2e 2f 62 75 69 6c 64 2d 76 79 6f 73 2d	e.generated.with.``./build-vyos-
1a500	69 6d 61 67 65 20 2d 2d 68 65 6c 70 60 60 3a 00 54 68 69 73 20 63 61 6e 20 61 6c 73 6f 20 62 65	image.--help``:.This.can.also.be
1a520	20 64 6f 6e 65 20 70 65 72 6d 61 6e 65 6e 74 6c 79 20 62 79 20 63 68 61 6e 67 69 6e 67 20 60 60	.done.permanently.by.changing.``
1a540	2f 62 6f 6f 74 2f 67 72 75 62 2f 67 72 75 62 2e 63 66 67 60 60 2e 00 54 68 69 73 20 63 68 61 70	/boot/grub/grub.cfg``..This.chap
1a560	74 65 72 20 6c 69 73 74 73 20 74 68 6f 73 65 20 65 78 63 65 70 74 69 6f 6e 73 20 61 6e 64 20 67	ter.lists.those.exceptions.and.g
1a580	69 76 65 73 20 79 6f 75 20 61 20 62 72 69 65 66 20 6f 76 65 72 76 69 65 77 20 77 68 61 74 20 77	ives.you.a.brief.overview.what.w
1a5a0	65 20 68 61 76 65 20 64 6f 6e 65 20 6f 6e 20 74 68 6f 73 65 20 70 61 63 6b 61 67 65 73 2e 20 49	e.have.done.on.those.packages..I
1a5c0	66 20 79 6f 75 20 6f 6e 6c 79 20 77 61 6e 74 20 74 6f 20 62 75 69 6c 64 20 79 6f 75 72 73 65 6c	f.you.only.want.to.build.yoursel
1a5e0	66 20 61 20 66 72 65 73 68 20 49 53 4f 20 79 6f 75 20 63 61 6e 20 63 6f 6d 70 6c 65 74 65 6c 79	f.a.fresh.ISO.you.can.completely
1a600	20 73 6b 69 70 20 74 68 69 73 20 63 68 61 70 74 65 72 2e 20 49 74 20 6d 61 79 20 62 65 63 6f 6d	.skip.this.chapter..It.may.becom
1a620	65 20 69 6e 74 65 72 65 73 74 69 6e 67 20 6f 6e 63 65 20 79 6f 75 20 68 61 76 65 20 61 20 56 79	e.interesting.once.you.have.a.Vy
1a640	4f 53 20 64 65 65 70 20 64 69 76 65 2e 00 54 68 69 73 20 69 73 20 64 6f 6e 65 20 62 79 20 75 74	OS.deep.dive..This.is.done.by.ut
1a660	69 6c 69 7a 69 6e 67 20 74 68 65 20 60 60 73 79 73 74 65 6d 64 2d 62 6f 6f 74 63 68 61 72 74 60	ilizing.the.``systemd-bootchart`
1a680	60 20 70 61 63 6b 61 67 65 20 77 68 69 63 68 20 69 73 20 6e 6f 77 20 69 6e 73 74 61 6c 6c 65 64	`.package.which.is.now.installed
1a6a0	20 62 79 20 64 65 66 61 75 6c 74 20 6f 6e 20 74 68 65 20 56 79 4f 53 20 31 2e 33 20 28 65 71 75	.by.default.on.the.VyOS.1.3.(equ
1a6c0	75 6c 65 75 73 29 20 62 72 61 6e 63 68 2e 20 54 68 65 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e	uleus).branch..The.configuration
1a6e0	20 69 73 20 61 6c 73 6f 20 76 65 72 73 69 6f 6e 65 64 20 73 6f 20 77 65 20 67 65 74 20 63 6f 6d	.is.also.versioned.so.we.get.com
1a700	70 61 72 61 62 6c 65 20 72 65 73 75 6c 74 73 2e 20 60 60 73 79 73 74 65 6d 64 2d 62 6f 6f 74 63	parable.results..``systemd-bootc
1a720	68 61 72 74 60 60 20 69 73 20 63 6f 6e 66 69 67 75 72 65 64 20 75 73 69 6e 67 20 74 68 69 73 20	hart``.is.configured.using.this.
1a740	66 69 6c 65 3a 20 62 6f 6f 74 63 68 61 72 74 2e 63 6f 6e 66 5f 00 54 68 69 73 20 69 73 20 77 68	file:.bootchart.conf_.This.is.wh
1a760	61 74 20 77 69 6c 6c 20 68 61 70 70 65 6e 20 77 68 65 6e 20 61 20 74 61 73 6b 20 69 73 20 73 65	at.will.happen.when.a.task.is.se
1a780	74 20 74 6f 20 22 4e 65 65 64 73 20 72 65 70 6f 72 74 65 72 20 61 63 74 69 6f 6e 22 3a 00 54 68	t.to."Needs.reporter.action":.Th
1a7a0	69 73 20 6d 65 61 6e 73 20 74 68 65 20 66 69 6c 65 20 69 6e 20 71 75 65 73 74 69 6f 6e 20 28 60	is.means.the.file.in.question.(`
1a7c0	60 2f 6f 70 74 2f 76 79 61 74 74 61 2f 73 62 69 6e 2f 76 79 61 74 74 61 2d 75 70 64 61 74 65 2d	`/opt/vyatta/sbin/vyatta-update-
1a7e0	77 65 62 70 72 6f 78 79 2e 70 6c 60 60 29 20 69 73 20 6c 6f 63 61 74 65 64 20 69 6e 20 74 68 65	webproxy.pl``).is.located.in.the
1a800	20 60 60 76 79 61 74 74 61 2d 77 65 62 70 72 6f 78 79 60 60 20 70 61 63 6b 61 67 65 20 77 68 69	.``vyatta-webproxy``.package.whi
1a820	63 68 20 63 61 6e 20 62 65 20 66 6f 75 6e 64 20 68 65 72 65 3a 20 68 74 74 70 73 3a 2f 2f 67 69	ch.can.be.found.here:.https://gi
1a840	74 68 75 62 2e 63 6f 6d 2f 76 79 6f 73 2f 76 79 61 74 74 61 2d 77 65 62 70 72 6f 78 79 00 54 68	thub.com/vyos/vyatta-webproxy.Th
1a860	69 73 20 70 61 63 6b 61 67 65 20 64 6f 65 73 6e 27 74 20 65 78 69 73 74 20 69 6e 20 44 65 62 69	is.package.doesn't.exist.in.Debi
1a880	61 6e 2e 20 41 20 64 65 62 69 61 6e 69 7a 65 64 20 66 6f 72 6b 20 69 73 20 6b 65 70 74 20 61 74	an..A.debianized.fork.is.kept.at
1a8a0	20 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 76 79 6f 73 2f 6d 64 6e 73 2d 72 65	.https://github.com/vyos/mdns-re
1a8c0	70 65 61 74 65 72 00 54 68 69 73 20 70 61 63 6b 61 67 65 20 64 6f 65 73 6e 27 74 20 65 78 69 73	peater.This.package.doesn't.exis
1a8e0	74 20 69 6e 20 44 65 62 69 61 6e 2e 20 41 20 64 65 62 69 61 6e 69 7a 65 64 20 66 6f 72 6b 20 69	t.in.Debian..A.debianized.fork.i
1a900	73 20 6b 65 70 74 20 61 74 20 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 76 79 6f	s.kept.at.https://github.com/vyo
1a920	73 2f 75 64 70 2d 62 72 6f 61 64 63 61 73 74 2d 72 65 6c 61 79 00 54 68 69 73 20 74 72 69 65 73	s/udp-broadcast-relay.This.tries
1a940	20 74 6f 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 64 65 74 65 63 74 20 77 68 69 63 68 20 62	.to.automatically.detect.which.b
1a960	6c 6f 62 73 20 61 72 65 20 6e 65 65 64 65 64 20 62 61 73 65 64 20 6f 6e 20 77 68 69 63 68 20 64	lobs.are.needed.based.on.which.d
1a980	72 69 76 65 72 73 20 77 65 72 65 20 62 75 69 6c 74 2e 20 49 66 20 69 74 20 66 61 69 6c 73 20 74	rivers.were.built..If.it.fails.t
1a9a0	6f 20 66 69 6e 64 20 74 68 65 20 63 6f 72 72 65 63 74 20 66 69 6c 65 73 20 79 6f 75 20 63 61 6e	o.find.the.correct.files.you.can
1a9c0	20 61 64 64 20 74 68 65 6d 20 6d 61 6e 75 61 6c 6c 79 20 74 6f 20 60 60 76 79 6f 73 2d 62 75 69	.add.them.manually.to.``vyos-bui
1a9e0	6c 64 2f 70 61 63 6b 61 67 65 73 2f 6c 69 6e 75 78 2d 6b 65 72 6e 65 6c 2f 62 75 69 6c 64 2d 6c	ld/packages/linux-kernel/build-l
1aa00	69 6e 75 78 2d 66 69 72 6d 77 61 72 65 2e 73 68 60 60 3a 00 54 68 69 73 20 77 69 6c 6c 20 67 75	inux-firmware.sh``:.This.will.gu
1aa20	69 64 65 20 79 6f 75 20 74 68 72 6f 75 67 68 20 74 68 65 20 70 72 6f 63 65 73 73 20 6f 66 20 62	ide.you.through.the.process.of.b
1aa40	75 69 6c 64 69 6e 67 20 61 20 56 79 4f 53 20 49 53 4f 20 75 73 69 6e 67 20 44 6f 63 6b 65 72 2e	uilding.a.VyOS.ISO.using.Docker.
1aa60	20 54 68 69 73 20 70 72 6f 63 65 73 73 20 68 61 73 20 62 65 65 6e 20 74 65 73 74 65 64 20 6f 6e	.This.process.has.been.tested.on
1aa80	20 63 6c 65 61 6e 20 69 6e 73 74 61 6c 6c 73 20 6f 66 20 44 65 62 69 61 6e 20 42 75 6c 6c 73 65	.clean.installs.of.Debian.Bullse
1aaa0	79 65 20 28 31 31 29 20 61 6e 64 20 42 6f 6f 6b 77 6f 72 6d 20 28 31 32 29 2e 00 54 68 69 73 20	ye.(11).and.Bookworm.(12)..This.
1aac0	77 69 6c 6c 20 67 75 69 64 65 20 79 6f 75 20 74 68 72 6f 75 67 68 20 74 68 65 20 70 72 6f 63 65	will.guide.you.through.the.proce
1aae0	73 73 20 6f 66 20 62 75 69 6c 64 69 6e 67 20 61 20 56 79 4f 53 20 49 53 4f 20 75 73 69 6e 67 20	ss.of.building.a.VyOS.ISO.using.
1ab00	44 6f 63 6b 65 72 5f 2e 20 54 68 69 73 20 70 72 6f 63 65 73 73 20 68 61 73 20 62 65 65 6e 20 74	Docker_..This.process.has.been.t
1ab20	65 73 74 65 64 20 6f 6e 20 63 6c 65 61 6e 20 69 6e 73 74 61 6c 6c 73 20 6f 66 20 44 65 62 69 61	ested.on.clean.installs.of.Debia
1ab40	6e 20 4a 65 73 73 69 65 2c 20 53 74 72 65 74 63 68 2c 20 61 6e 64 20 42 75 73 74 65 72 2e 00 54	n.Jessie,.Stretch,.and.Buster..T
1ab60	68 69 73 20 77 69 6c 6c 20 6c 69 6d 69 74 20 74 68 65 20 60 62 6f 6e 64 60 20 69 6e 74 65 72 66	his.will.limit.the.`bond`.interf
1ab80	61 63 65 20 74 65 73 74 20 74 6f 20 6f 6e 6c 79 20 6d 61 6b 65 20 75 73 65 20 6f 66 20 60 65 74	ace.test.to.only.make.use.of.`et
1aba0	68 31 60 20 61 6e 64 20 60 65 74 68 32 60 20 61 73 20 6d 65 6d 62 65 72 20 70 6f 72 74 73 2e 00	h1`.and.`eth2`.as.member.ports..
1abc0	54 68 6f 73 65 20 63 6f 6d 6d 6f 6e 20 74 65 73 74 73 20 63 6f 6e 73 69 73 74 73 20 6f 75 74 20	Those.common.tests.consists.out.
1abe0	6f 66 3a 00 54 69 70 73 20 61 6e 64 20 54 72 69 63 6b 73 00 54 6f 20 62 65 20 61 62 6c 65 20 74	of:.Tips.and.Tricks.To.be.able.t
1ac00	6f 20 75 73 65 20 44 6f 63 6b 65 72 5f 20 77 69 74 68 6f 75 74 20 60 60 73 75 64 6f 60 60 2c 20	o.use.Docker_.without.``sudo``,.
1ac20	74 68 65 20 63 75 72 72 65 6e 74 20 6e 6f 6e 2d 72 6f 6f 74 20 75 73 65 72 20 6d 75 73 74 20 62	the.current.non-root.user.must.b
1ac40	65 20 61 64 64 65 64 20 74 6f 20 74 68 65 20 60 60 64 6f 63 6b 65 72 60 60 20 67 72 6f 75 70 20	e.added.to.the.``docker``.group.
1ac60	62 79 20 63 61 6c 6c 69 6e 67 3a 20 60 60 73 75 64 6f 20 75 73 65 72 6d 6f 64 20 2d 61 47 20 64	by.calling:.``sudo.usermod.-aG.d
1ac80	6f 63 6b 65 72 20 79 6f 75 72 75 73 65 72 6e 61 6d 65 60 60 2e 00 54 6f 20 62 75 69 6c 64 20 56	ocker.yourusername``..To.build.V
1aca0	79 4f 53 20 6e 61 74 69 76 65 6c 79 20 79 6f 75 20 72 65 71 75 69 72 65 20 61 20 70 72 6f 70 65	yOS.natively.you.require.a.prope
1acc0	72 6c 79 20 63 6f 6e 66 69 67 75 72 65 64 20 62 75 69 6c 64 20 68 6f 73 74 20 77 69 74 68 20 74	rly.configured.build.host.with.t
1ace0	68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 44 65 62 69 61 6e 20 76 65 72 73 69 6f 6e 73 20 69 6e 73	he.following.Debian.versions.ins
1ad00	74 61 6c 6c 65 64 3a 00 54 6f 20 62 75 69 6c 64 20 6f 75 72 20 6d 6f 64 75 6c 65 73 20 77 65 20	talled:.To.build.our.modules.we.
1ad20	75 74 69 6c 69 7a 65 20 61 20 43 49 2f 43 44 20 50 69 70 65 6c 69 6e 65 20 73 63 72 69 70 74 2e	utilize.a.CI/CD.Pipeline.script.
1ad40	20 45 61 63 68 20 61 6e 64 20 65 76 65 72 79 20 56 79 4f 53 20 63 6f 6d 70 6f 6e 65 6e 74 20 63	.Each.and.every.VyOS.component.c
1ad60	6f 6d 65 73 20 77 69 74 68 20 69 74 27 73 20 6f 77 6e 20 60 60 4a 65 6e 6b 69 6e 73 66 69 6c 65	omes.with.it's.own.``Jenkinsfile
1ad80	60 60 20 77 68 69 63 68 20 69 73 20 28 6d 6f 72 65 20 6f 72 20 6c 65 73 73 29 20 61 20 63 6f 70	``.which.is.(more.or.less).a.cop
1ada0	79 2e 20 54 68 65 20 50 69 70 65 6c 69 6e 65 20 75 74 69 6c 69 7a 65 73 20 74 68 65 20 44 6f 63	y..The.Pipeline.utilizes.the.Doc
1adc0	6b 65 72 20 63 6f 6e 74 61 69 6e 65 72 20 66 72 6f 6d 20 74 68 65 20 3a 72 65 66 3a 60 62 75 69	ker.container.from.the.:ref:`bui
1ade0	6c 64 5f 69 73 6f 60 20 73 65 63 74 69 6f 6e 20 2d 20 62 75 74 20 69 6e 73 74 65 61 64 20 6f 66	ld_iso`.section.-.but.instead.of
1ae00	20 62 75 69 6c 64 69 6e 67 20 69 74 20 66 72 6f 6d 20 73 6f 75 72 63 65 20 6f 6e 20 65 76 65 72	.building.it.from.source.on.ever
1ae20	79 20 72 75 6e 2c 20 77 65 20 72 61 74 68 65 72 20 61 6c 77 61 79 73 20 66 65 74 63 68 20 61 20	y.run,.we.rather.always.fetch.a.
1ae40	66 72 65 73 68 20 63 6f 70 79 20 28 69 66 20 6e 65 65 64 65 64 29 20 66 72 6f 6d 20 44 6f 63 6b	fresh.copy.(if.needed).from.Dock
1ae60	65 72 68 75 62 5f 2e 00 54 6f 20 64 65 62 75 67 20 69 73 73 75 65 73 20 69 6e 20 70 72 69 6f 72	erhub_..To.debug.issues.in.prior
1ae80	69 74 69 65 73 20 6f 72 20 74 6f 20 73 65 65 20 77 68 61 74 27 73 20 67 6f 69 6e 67 20 6f 6e 20	ities.or.to.see.what's.going.on.
1aea0	69 6e 20 74 68 65 20 62 61 63 6b 67 72 6f 75 6e 64 20 79 6f 75 20 63 61 6e 20 75 73 65 20 74 68	in.the.background.you.can.use.th
1aec0	65 20 60 60 2f 6f 70 74 2f 76 79 61 74 74 61 2f 73 62 69 6e 2f 70 72 69 6f 72 69 74 79 2e 70 6c	e.``/opt/vyatta/sbin/priority.pl
1aee0	60 60 20 73 63 72 69 70 74 20 77 68 69 63 68 20 6c 69 73 74 73 20 74 6f 20 79 6f 75 20 74 68 65	``.script.which.lists.to.you.the
1af00	20 65 78 65 63 75 74 69 6f 6e 20 6f 72 64 65 72 20 6f 66 20 74 68 65 20 73 63 72 69 70 74 73 2e	.execution.order.of.the.scripts.
1af20	00 54 6f 20 64 65 62 75 67 20 74 68 65 20 62 75 69 6c 64 20 70 72 6f 63 65 73 73 20 61 6e 64 20	.To.debug.the.build.process.and.
1af40	67 61 69 6e 20 61 64 64 69 74 69 6f 6e 61 6c 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 6f 66 20 77	gain.additional.information.of.w
1af60	68 61 74 20 63 6f 75 6c 64 20 62 65 20 74 68 65 20 72 6f 6f 74 20 63 61 75 73 65 2c 20 79 6f 75	hat.could.be.the.root.cause,.you
1af80	20 6e 65 65 64 20 74 6f 20 75 73 65 20 60 63 68 72 6f 6f 74 60 20 74 6f 20 63 68 61 6e 67 65 20	.need.to.use.`chroot`.to.change.
1afa0	69 6e 74 6f 20 74 68 65 20 62 75 69 6c 64 20 64 69 72 65 63 74 6f 72 79 2e 20 54 68 69 73 20 69	into.the.build.directory..This.i
1afc0	73 20 65 78 70 6c 61 69 6e 65 64 20 69 6e 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 65	s.explained.in.the.following.ste
1afe0	70 20 62 79 20 73 74 65 70 20 70 72 6f 63 65 64 75 72 65 3a 00 54 6f 20 64 65 62 75 67 20 74 68	p.by.step.procedure:.To.debug.th
1b000	65 20 62 75 69 6c 64 20 70 72 6f 63 65 73 73 20 61 6e 64 20 67 61 69 6e 20 61 64 64 69 74 69 6f	e.build.process.and.gain.additio
1b020	6e 61 6c 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 6f 66 20 77 68 61 74 20 63 6f 75 6c 64 20 62 65	nal.information.of.what.could.be
1b040	20 74 68 65 20 72 6f 6f 74 20 63 61 75 73 65 2c 20 79 6f 75 20 6e 65 65 64 20 74 6f 20 75 73 65	.the.root.cause,.you.need.to.use
1b060	20 60 63 68 72 6f 6f 74 60 20 74 6f 20 63 68 61 6e 67 65 20 69 6e 74 6f 20 74 68 65 20 62 75 69	.`chroot`.to.change.into.the.bui
1b080	6c 64 20 64 69 72 65 63 74 72 79 2e 20 54 68 69 73 20 69 73 20 65 78 70 6c 61 69 6e 65 64 20 69	ld.directry..This.is.explained.i
1b0a0	6e 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 65 70 20 62 79 20 73 74 65 70 20 70 72 6f	n.the.following.step.by.step.pro
1b0c0	63 65 64 75 72 65 3a 00 54 6f 20 65 6e 61 62 6c 65 20 62 6f 6f 74 20 74 69 6d 65 20 67 72 61 70	cedure:.To.enable.boot.time.grap
1b0e0	68 69 6e 67 20 63 68 61 6e 67 65 20 74 68 65 20 4b 65 72 6e 65 6c 20 63 6f 6d 6d 61 6e 64 6c 69	hing.change.the.Kernel.commandli
1b100	6e 65 20 61 6e 64 20 61 64 64 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 72 69 6e 67 3a	ne.and.add.the.following.string:
1b120	20 60 60 69 6e 69 74 3d 2f 75 73 72 2f 6c 69 62 2f 73 79 73 74 65 6d 64 2f 73 79 73 74 65 6d 64	.``init=/usr/lib/systemd/systemd
1b140	2d 62 6f 6f 74 63 68 61 72 74 60 60 00 54 6f 20 65 6e 61 62 6c 65 20 62 6f 6f 74 20 74 69 6d 65	-bootchart``.To.enable.boot.time
1b160	20 67 72 61 70 68 69 6e 67 20 63 68 61 6e 67 65 20 74 68 65 20 4b 65 72 6e 65 6c 20 63 6f 6d 6d	.graphing.change.the.Kernel.comm
1b180	61 6e 64 6c 69 6e 65 20 61 6e 64 20 61 64 64 20 74 68 65 20 66 6f 6c 6f 77 69 6e 67 20 73 74 72	andline.and.add.the.folowing.str
1b1a0	69 6e 67 3a 20 60 60 69 6e 69 74 3d 2f 75 73 72 2f 6c 69 62 2f 73 79 73 74 65 6d 64 2f 73 79 73	ing:.``init=/usr/lib/systemd/sys
1b1c0	74 65 6d 64 2d 62 6f 6f 74 63 68 61 72 74 60 60 00 54 6f 20 65 6e 61 62 6c 65 20 64 65 62 75 67	temd-bootchart``.To.enable.debug
1b1e0	67 69 6e 67 20 6a 75 73 74 20 72 75 6e 3a 20 60 60 24 20 74 6f 75 63 68 20 2f 74 6d 70 2f 76 79	ging.just.run:.``$.touch./tmp/vy
1b200	6f 73 2e 66 72 72 2e 64 65 62 75 67 60 60 00 54 6f 20 65 6e 61 62 6c 65 20 73 6d 6f 6b 65 74 65	os.frr.debug``.To.enable.smokete
1b220	73 74 20 64 65 62 75 67 67 69 6e 67 20 28 70 72 69 6e 74 20 6f 66 20 74 68 65 20 43 4c 49 20 73	st.debugging.(print.of.the.CLI.s
1b240	65 74 20 63 6f 6d 6d 61 6e 64 73 20 75 73 65 64 29 20 79 6f 75 20 63 61 6e 20 72 75 6e 3a 20 60	et.commands.used).you.can.run:.`
1b260	60 74 6f 75 63 68 20 2f 74 6d 70 2f 76 79 6f 73 2e 73 6d 6f 6b 65 74 65 73 74 2e 64 65 62 75 67	`touch./tmp/vyos.smoketest.debug
1b280	60 60 2e 00 54 6f 20 65 6e 73 75 72 65 20 75 6e 69 66 6f 72 6d 20 6c 6f 6f 6b 20 61 6e 64 20 66	``..To.ensure.uniform.look.and.f
1b2a0	65 65 6c 2c 20 61 6e 64 20 69 6d 70 72 6f 76 65 20 72 65 61 64 61 62 69 6c 69 74 79 2c 20 77 65	eel,.and.improve.readability,.we
1b2c0	20 73 68 6f 75 6c 64 20 66 6f 6c 6c 6f 77 20 61 20 73 65 74 20 6f 66 20 67 75 69 64 65 6c 69 6e	.should.follow.a.set.of.guidelin
1b2e0	65 73 20 63 6f 6e 73 69 73 74 65 6e 74 6c 79 2e 00 54 6f 20 6d 61 6b 65 20 74 68 69 73 20 61 70	es.consistently..To.make.this.ap
1b300	70 72 6f 61 63 68 20 77 6f 72 6b 2c 20 65 76 65 72 79 20 63 68 61 6e 67 65 20 6d 75 73 74 20 62	proach.work,.every.change.must.b
1b320	65 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 61 20 74 61 73 6b 20 6e 75 6d 62 65 72 20	e.associated.with.a.task.number.
1b340	28 70 72 65 66 69 78 65 64 20 77 69 74 68 20 2a 2a 54 2a 2a 29 20 61 6e 64 20 61 20 63 6f 6d 70	(prefixed.with.**T**).and.a.comp
1b360	6f 6e 65 6e 74 2e 20 49 66 20 74 68 65 72 65 20 69 73 20 6e 6f 20 62 75 67 20 72 65 70 6f 72 74	onent..If.there.is.no.bug.report
1b380	2f 66 65 61 74 75 72 65 20 72 65 71 75 65 73 74 20 66 6f 72 20 74 68 65 20 63 68 61 6e 67 65 73	/feature.request.for.the.changes
1b3a0	20 79 6f 75 20 61 72 65 20 67 6f 69 6e 67 20 74 6f 20 6d 61 6b 65 2c 20 79 6f 75 20 68 61 76 65	.you.are.going.to.make,.you.have
1b3c0	20 74 6f 20 63 72 65 61 74 65 20 61 20 50 68 61 62 72 69 63 61 74 6f 72 5f 20 74 61 73 6b 20 66	.to.create.a.Phabricator_.task.f
1b3e0	69 72 73 74 2e 20 4f 6e 63 65 20 74 68 65 72 65 20 69 73 20 61 6e 20 65 6e 74 72 79 20 69 6e 20	irst..Once.there.is.an.entry.in.
1b400	50 68 61 62 72 69 63 61 74 6f 72 5f 2c 20 79 6f 75 20 73 68 6f 75 6c 64 20 72 65 66 65 72 65 6e	Phabricator_,.you.should.referen
1b420	63 65 20 69 74 73 20 69 64 20 69 6e 20 79 6f 75 72 20 63 6f 6d 6d 69 74 20 6d 65 73 73 61 67 65	ce.its.id.in.your.commit.message
1b440	2c 20 61 73 20 73 68 6f 77 6e 20 62 65 6c 6f 77 3a 00 54 6f 20 6d 61 6e 75 61 6c 6c 79 20 64 6f	,.as.shown.below:.To.manually.do
1b460	77 6e 6c 6f 61 64 20 74 68 65 20 63 6f 6e 74 61 69 6e 65 72 20 66 72 6f 6d 20 44 6f 63 6b 65 72	wnload.the.container.from.Docker
1b480	48 75 62 2c 20 72 75 6e 3a 00 54 6f 20 73 74 61 72 74 2c 20 63 6c 6f 6e 65 20 74 68 65 20 72 65	Hub,.run:.To.start,.clone.the.re
1b4a0	70 6f 73 69 74 6f 72 79 20 74 6f 20 79 6f 75 72 20 6c 6f 63 61 6c 20 6d 61 63 68 69 6e 65 3a 00	pository.to.your.local.machine:.
1b4c0	54 6f 20 74 61 6b 65 20 79 6f 75 72 20 6e 65 77 6c 79 20 63 72 65 61 74 65 64 20 70 61 63 6b 61	To.take.your.newly.created.packa
1b4e0	67 65 20 6f 6e 20 61 20 74 65 73 74 20 64 72 69 76 65 20 79 6f 75 20 63 61 6e 20 73 69 6d 70 6c	ge.on.a.test.drive.you.can.simpl
1b500	79 20 53 43 50 20 69 74 20 74 6f 20 61 20 72 75 6e 6e 69 6e 67 20 56 79 4f 53 20 69 6e 73 74 61	y.SCP.it.to.a.running.VyOS.insta
1b520	6e 63 65 20 61 6e 64 20 69 6e 73 74 61 6c 6c 20 74 68 65 20 6e 65 77 20 60 2a 2e 64 65 62 60 20	nce.and.install.the.new.`*.deb`.
1b540	70 61 63 6b 61 67 65 20 6f 76 65 72 20 74 68 65 20 63 75 72 72 65 6e 74 20 72 75 6e 6e 69 6e 67	package.over.the.current.running
1b560	20 6f 6e 65 2e 00 54 72 6f 75 62 6c 65 73 68 6f 6f 74 69 6e 67 00 55 6e 6c 65 73 73 20 61 62 73	.one..Troubleshooting.Unless.abs
1b580	6f 6c 75 74 65 6c 79 20 6e 65 63 65 73 73 61 72 79 2c 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e	olutely.necessary,.configuration
1b5a0	20 73 63 72 69 70 74 73 20 73 68 6f 75 6c 64 20 6e 6f 74 20 6d 6f 64 69 66 79 20 74 68 65 20 61	.scripts.should.not.modify.the.a
1b5c0	63 74 69 76 65 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 6f 66 20 73 79 73 74 65 6d 20 63 6f	ctive.configuration.of.system.co
1b5e0	6d 70 6f 6e 65 6e 74 73 20 64 69 72 65 63 74 6c 79 2e 20 57 68 65 6e 65 76 65 72 20 61 74 20 61	mponents.directly..Whenever.at.a
1b600	6c 6c 20 70 6f 73 73 69 62 6c 65 2c 20 73 63 72 69 70 74 73 20 73 68 6f 75 6c 64 20 67 65 6e 65	ll.possible,.scripts.should.gene
1b620	72 61 74 65 20 61 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 66 69 6c 65 20 6f 72 20 66 69 6c	rate.a.configuration.file.or.fil
1b640	65 73 20 74 68 61 74 20 63 61 6e 20 62 65 20 61 70 70 6c 69 65 64 20 77 69 74 68 20 61 20 73 69	es.that.can.be.applied.with.a.si
1b660	6e 67 6c 65 20 63 6f 6d 6d 61 6e 64 20 73 75 63 68 20 61 73 20 72 65 6c 6f 61 64 69 6e 67 20 61	ngle.command.such.as.reloading.a
1b680	20 73 65 72 76 69 63 65 20 74 68 72 6f 75 67 68 20 73 79 73 74 65 6d 64 20 69 6e 69 74 2e 20 49	.service.through.systemd.init..I
1b6a0	6e 73 65 72 74 69 6e 67 20 73 74 61 74 65 6d 65 6e 74 73 20 6f 6e 65 20 62 79 20 6f 6e 65 20 69	nserting.statements.one.by.one.i
1b6c0	73 20 70 61 72 74 69 63 75 6c 61 72 6c 79 20 64 69 73 63 6f 75 72 61 67 65 64 2c 20 66 6f 72 20	s.particularly.discouraged,.for.
1b6e0	65 78 61 6d 70 6c 65 2c 20 77 68 65 6e 20 63 6f 6e 66 69 67 75 72 69 6e 67 20 6e 65 74 66 69 6c	example,.when.configuring.netfil
1b700	74 65 72 20 72 75 6c 65 73 2c 20 73 61 76 69 6e 67 20 74 68 65 6d 20 74 6f 20 61 20 66 69 6c 65	ter.rules,.saving.them.to.a.file
1b720	20 61 6e 64 20 6c 6f 61 64 69 6e 67 20 69 74 20 77 69 74 68 20 69 70 74 61 62 6c 65 73 2d 72 65	.and.loading.it.with.iptables-re
1b740	73 74 6f 72 65 20 73 68 6f 75 6c 64 20 61 6c 77 61 79 73 20 62 65 20 70 72 65 66 65 72 72 65 64	store.should.always.be.preferred
1b760	20 74 6f 20 65 78 65 63 75 74 69 6e 67 20 69 70 74 61 62 6c 65 73 20 64 69 72 65 63 74 6c 79 2e	.to.executing.iptables.directly.
1b780	00 55 70 73 74 72 65 61 6d 20 70 61 63 6b 61 67 65 73 00 55 73 65 20 6f 66 20 61 62 62 72 65 76	.Upstream.packages.Use.of.abbrev
1b7a0	69 61 74 69 6f 6e 73 20 61 6e 64 20 61 63 72 6f 6e 79 6d 73 00 55 73 65 20 6f 66 20 6e 75 6d 62	iations.and.acronyms.Use.of.numb
1b7c0	65 72 73 00 55 73 65 20 6f 66 20 6e 75 6d 62 65 72 73 20 69 6e 20 63 6f 6d 6d 61 6e 64 20 6e 61	ers.Use.of.numbers.in.command.na
1b7e0	6d 65 73 20 2a 2a 73 68 6f 75 6c 64 2a 2a 20 62 65 20 61 76 6f 69 64 65 64 20 75 6e 6c 65 73 73	mes.**should**.be.avoided.unless
1b800	20 61 20 6e 75 6d 62 65 72 20 69 73 20 61 20 70 61 72 74 20 6f 66 20 61 20 70 72 6f 74 6f 63 6f	.a.number.is.a.part.of.a.protoco
1b820	6c 20 6e 61 6d 65 20 6f 72 20 73 69 6d 69 6c 61 72 2e 20 54 68 75 73 2c 20 60 60 70 72 6f 74 6f	l.name.or.similar..Thus,.``proto
1b840	63 6f 6c 73 20 6f 73 70 66 76 33 60 60 20 69 73 20 70 65 72 66 65 63 74 6c 79 20 66 69 6e 65 2c	cols.ospfv3``.is.perfectly.fine,
1b860	20 62 75 74 20 73 6f 6d 65 74 68 69 6e 67 20 6c 69 6b 65 20 60 60 73 65 72 76 65 72 2d 31 60 60	.but.something.like.``server-1``
1b880	20 69 73 20 71 75 65 73 74 69 6f 6e 61 62 6c 65 20 61 74 20 62 65 73 74 2e 00 55 73 65 20 6f 66	.is.questionable.at.best..Use.of
1b8a0	20 76 65 72 62 73 00 55 73 65 20 72 65 67 65 78 00 55 73 65 66 75 6c 20 63 6f 6d 6d 61 6e 64 73	.verbs.Use.regex.Useful.commands
1b8c0	20 61 72 65 3a 00 56 49 46 20 28 69 6e 63 6c 2e 20 56 49 46 2d 53 2f 56 49 46 2d 43 29 00 56 4c	.are:.VIF.(incl..VIF-S/VIF-C).VL
1b8e0	41 4e 73 20 28 51 69 6e 51 20 61 6e 64 20 72 65 67 75 6c 61 72 20 38 30 32 2e 31 71 29 00 56 4d	ANs.(QinQ.and.regular.802.1q).VM
1b900	77 61 72 65 00 56 65 72 62 73 20 2a 2a 73 68 6f 75 6c 64 2a 2a 20 62 65 20 61 76 6f 69 64 65 64	ware.Verbs.**should**.be.avoided
1b920	2e 20 49 66 20 61 20 76 65 72 62 20 63 61 6e 20 62 65 20 6f 6d 69 74 74 65 64 2c 20 6f 6d 69 74	..If.a.verb.can.be.omitted,.omit
1b940	20 69 74 2e 00 56 65 72 62 73 2c 20 77 68 65 6e 20 74 68 65 79 20 61 72 65 20 6e 65 63 65 73 73	.it..Verbs,.when.they.are.necess
1b960	61 72 79 2c 20 2a 2a 73 68 6f 75 6c 64 2a 2a 20 62 65 20 69 6e 20 74 68 65 69 72 20 69 6e 66 69	ary,.**should**.be.in.their.infi
1b980	6e 69 74 69 76 65 20 66 6f 72 6d 2e 00 56 69 72 74 75 61 6c 69 7a 61 74 69 6f 6e 20 50 6c 61 74	nitive.form..Virtualization.Plat
1b9a0	66 6f 72 6d 73 00 56 79 4f 53 20 43 4c 49 20 69 73 20 61 6c 6c 20 61 62 6f 75 74 20 70 72 69 6f	forms.VyOS.CLI.is.all.about.prio
1b9c0	72 69 74 69 65 73 2e 20 45 76 65 72 79 20 43 4c 49 20 6e 6f 64 65 20 68 61 73 20 61 20 63 6f 72	rities..Every.CLI.node.has.a.cor
1b9e0	72 65 73 70 6f 6e 64 69 6e 67 20 60 60 6e 6f 64 65 2e 64 65 66 60 60 20 66 69 6c 65 20 61 6e 64	responding.``node.def``.file.and
1ba00	20 70 6f 73 73 69 62 6c 79 20 61 6e 20 61 74 74 61 63 68 65 64 20 73 63 72 69 70 74 20 74 68 61	.possibly.an.attached.script.tha
1ba20	74 20 69 73 20 65 78 65 63 75 74 65 64 20 77 68 65 6e 20 74 68 65 20 6e 6f 64 65 20 69 73 20 70	t.is.executed.when.the.node.is.p
1ba40	72 65 73 65 6e 74 2e 20 4e 6f 64 65 73 20 63 61 6e 20 68 61 76 65 20 61 20 70 72 69 6f 72 69 74	resent..Nodes.can.have.a.priorit
1ba60	79 2c 20 61 6e 64 20 6f 6e 20 73 79 73 74 65 6d 20 62 6f 6f 74 75 70 20 2d 20 6f 72 20 61 6e 79	y,.and.on.system.bootup.-.or.any
1ba80	20 6f 74 68 65 72 20 60 60 63 6f 6d 6d 69 74 60 60 20 74 6f 20 74 68 65 20 63 6f 6e 66 69 67 20	.other.``commit``.to.the.config.
1baa0	61 6c 6c 20 73 63 72 69 70 74 73 20 61 72 65 20 65 78 65 63 75 74 65 64 20 66 72 6f 6d 20 6c 6f	all.scripts.are.executed.from.lo
1bac0	77 65 73 74 20 74 6f 20 68 69 67 65 73 74 20 70 72 69 6f 72 69 74 79 2e 20 54 68 69 73 20 69 73	west.to.higest.priority..This.is
1bae0	20 67 6f 6f 64 20 61 73 20 74 68 69 73 20 67 69 76 65 73 20 61 20 64 65 74 65 72 6d 69 6e 69 73	.good.as.this.gives.a.determinis
1bb00	74 69 63 20 62 65 68 61 76 69 6f 72 2e 00 56 79 4f 53 20 43 4c 49 20 69 73 20 61 6c 6c 20 61 62	tic.behavior..VyOS.CLI.is.all.ab
1bb20	6f 75 74 20 70 72 69 6f 72 69 74 69 65 73 2e 20 45 76 65 72 79 20 43 4c 49 20 6e 6f 64 65 20 68	out.priorities..Every.CLI.node.h
1bb40	61 73 20 61 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 60 60 6e 6f 64 65 2e 64 65 66 60 60 20	as.a.corresponding.``node.def``.
1bb60	66 69 6c 65 20 61 6e 64 20 70 6f 73 73 69 62 6c 79 20 61 6e 20 61 74 74 61 63 68 65 64 20 73 63	file.and.possibly.an.attached.sc
1bb80	72 69 70 74 20 74 68 61 74 20 69 73 20 65 78 65 63 75 74 65 64 20 77 68 65 6e 20 74 68 65 20 6e	ript.that.is.executed.when.the.n
1bba0	6f 64 65 20 69 73 20 70 72 65 73 65 6e 74 2e 20 4e 6f 64 65 73 20 63 61 6e 20 68 61 76 65 20 61	ode.is.present..Nodes.can.have.a
1bbc0	20 70 72 69 6f 72 69 74 79 2c 20 61 6e 64 20 6f 6e 20 73 79 73 74 65 6d 20 62 6f 6f 74 75 70 20	.priority,.and.on.system.bootup.
1bbe0	2d 20 6f 72 20 61 6e 79 20 6f 74 68 65 72 20 60 60 63 6f 6d 6d 69 74 60 60 20 74 6f 20 74 68 65	-.or.any.other.``commit``.to.the
1bc00	20 63 6f 6e 66 69 67 20 61 6c 6c 20 73 63 72 69 70 74 73 20 61 72 65 20 65 78 65 63 75 74 65 64	.config.all.scripts.are.executed
1bc20	20 66 72 6f 6d 20 6c 6f 77 65 73 74 20 74 6f 20 68 69 67 68 65 73 74 20 70 72 69 6f 72 69 74 79	.from.lowest.to.highest.priority
1bc40	2e 20 54 68 69 73 20 69 73 20 67 6f 6f 64 20 61 73 20 74 68 69 73 20 67 69 76 65 73 20 61 20 64	..This.is.good.as.this.gives.a.d
1bc60	65 74 65 72 6d 69 6e 69 73 74 69 63 20 62 65 68 61 76 69 6f 72 2e 00 56 79 4f 53 20 68 61 73 20	eterministic.behavior..VyOS.has.
1bc80	73 77 69 74 63 68 65 64 20 74 6f 20 44 65 62 69 61 6e 20 28 31 32 29 20 42 6f 6f 6b 77 6f 72 6d	switched.to.Debian.(12).Bookworm
1bca0	20 69 6e 20 69 74 73 20 60 60 63 75 72 72 65 6e 74 60 60 20 62 72 61 6e 63 68 2c 20 44 75 65 20	.in.its.``current``.branch,.Due.
1bcc0	74 6f 20 73 6f 66 74 77 61 72 65 20 76 65 72 73 69 6f 6e 20 75 70 64 61 74 65 73 2c 20 69 74 20	to.software.version.updates,.it.
1bce0	69 73 20 72 65 63 6f 6d 6d 65 6e 64 65 64 20 74 6f 20 75 73 65 20 74 68 65 20 6f 66 66 69 63 69	is.recommended.to.use.the.offici
1bd00	61 6c 20 44 6f 63 6b 65 72 20 48 75 62 20 69 6d 61 67 65 20 74 6f 20 62 75 69 6c 64 20 56 79 4f	al.Docker.Hub.image.to.build.VyO
1bd20	53 20 49 53 4f 2e 00 56 79 4f 53 20 69 74 73 65 6c 66 20 63 6f 6d 65 73 20 77 69 74 68 20 61 20	S.ISO..VyOS.itself.comes.with.a.
1bd40	62 75 6e 63 68 20 6f 66 20 70 61 63 6b 61 67 65 73 20 74 68 61 74 20 61 72 65 20 73 70 65 63 69	bunch.of.packages.that.are.speci
1bd60	66 69 63 20 74 6f 20 6f 75 72 20 73 79 73 74 65 6d 20 61 6e 64 20 74 68 75 73 20 63 61 6e 6e 6f	fic.to.our.system.and.thus.canno
1bd80	74 20 62 65 20 66 6f 75 6e 64 20 69 6e 20 61 6e 79 20 44 65 62 69 61 6e 20 6d 69 72 72 6f 72 2e	t.be.found.in.any.Debian.mirror.
1bda0	20 54 68 6f 73 65 20 70 61 63 6b 61 67 65 73 20 63 61 6e 20 62 65 20 66 6f 75 6e 64 20 61 74 20	.Those.packages.can.be.found.at.
1bdc0	74 68 65 20 60 56 79 4f 53 20 47 69 74 48 75 62 20 70 72 6f 6a 65 63 74 60 5f 20 69 6e 20 74 68	the.`VyOS.GitHub.project`_.in.th
1bde0	65 69 72 20 73 6f 75 72 63 65 20 66 6f 72 6d 61 74 20 63 61 6e 20 65 61 73 69 6c 79 20 62 65 20	eir.source.format.can.easily.be.
1be00	63 6f 6d 70 69 6c 65 64 20 69 6e 74 6f 20 61 20 63 75 73 74 6f 6d 20 44 65 62 69 61 6e 20 28 60	compiled.into.a.custom.Debian.(`
1be20	2a 2e 64 65 62 60 29 20 70 61 63 6b 61 67 65 2e 00 56 79 4f 53 20 6d 61 6b 65 73 20 75 73 65 20	*.deb`).package..VyOS.makes.use.
1be40	6f 66 20 4a 65 6e 6b 69 6e 73 5f 20 61 73 20 6f 75 72 20 43 6f 6e 74 69 6e 75 6f 75 73 20 49 6e	of.Jenkins_.as.our.Continuous.In
1be60	74 65 67 72 61 74 69 6f 6e 20 28 43 49 29 20 73 65 72 76 69 63 65 2e 20 4f 75 72 20 60 56 79 4f	tegration.(CI).service..Our.`VyO
1be80	53 20 43 49 60 5f 20 73 65 72 76 65 72 20 69 73 20 70 75 62 6c 69 63 6c 79 20 61 63 63 65 73 73	S.CI`_.server.is.publicly.access
1bea0	69 62 6c 65 20 68 65 72 65 3a 20 68 74 74 70 73 3a 2f 2f 63 69 2e 76 79 6f 73 2e 6e 65 74 2e 20	ible.here:.https://ci.vyos.net..
1bec0	59 6f 75 20 63 61 6e 20 67 65 74 20 61 20 62 72 69 65 66 20 6f 76 65 72 76 69 65 77 20 6f 66 20	You.can.get.a.brief.overview.of.
1bee0	61 6c 6c 20 72 65 71 75 69 72 65 64 20 63 6f 6d 70 6f 6e 65 6e 74 73 20 73 68 69 70 70 65 64 20	all.required.components.shipped.
1bf00	69 6e 20 61 20 56 79 4f 53 20 49 53 4f 2e 00 57 65 20 61 67 61 69 6e 20 6d 61 6b 65 20 75 73 65	in.a.VyOS.ISO..We.again.make.use
1bf20	20 6f 66 20 61 20 68 65 6c 70 65 72 20 73 63 72 69 70 74 20 61 6e 64 20 73 6f 6d 65 20 70 61 74	.of.a.helper.script.and.some.pat
1bf40	63 68 65 73 20 74 6f 20 6d 61 6b 65 20 74 68 65 20 62 75 69 6c 64 20 77 6f 72 6b 2e 20 4a 75 73	ches.to.make.the.build.work..Jus
1bf60	74 20 72 75 6e 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 63 6f 6d 6d 61 6e 64 3a 00 57 65 20	t.run.the.following.command:.We.
1bf80	61 73 73 69 67 6e 20 74 68 61 74 20 73 74 61 74 75 73 20 74 6f 3a 00 57 65 20 64 69 66 66 65 72	assign.that.status.to:.We.differ
1bfa0	65 6e 74 69 61 74 65 20 69 6e 20 74 77 6f 20 69 6e 64 65 70 65 6e 64 65 6e 74 20 74 65 73 74 73	entiate.in.two.independent.tests
1bfc0	2c 20 77 68 69 63 68 20 61 72 65 20 62 6f 74 68 20 72 75 6e 20 69 6e 20 70 61 72 61 6c 6c 65 6c	,.which.are.both.run.in.parallel
1bfe0	20 62 79 20 74 77 6f 20 73 65 70 61 72 61 74 65 20 51 45 6d 75 20 69 6e 73 74 61 6e 63 65 73 20	.by.two.separate.QEmu.instances.
1c000	77 68 69 63 68 20 61 72 65 20 6c 61 75 6e 63 68 65 64 20 76 69 61 20 60 60 6d 61 6b 65 20 74 65	which.are.launched.via.``make.te
1c020	73 74 60 60 20 61 6e 64 20 60 60 6d 61 6b 65 20 74 65 73 74 63 60 60 20 66 72 6f 6d 20 77 69 74	st``.and.``make.testc``.from.wit
1c040	68 69 6e 20 74 68 65 20 76 79 6f 73 2d 62 75 69 6c 64 5f 20 72 65 70 6f 73 69 74 6f 72 79 2e 00	hin.the.vyos-build_.repository..
1c060	57 65 20 6e 6f 77 20 61 72 65 20 66 72 65 65 20 74 6f 20 72 75 6e 20 61 6e 79 20 63 6f 6d 6d 61	We.now.are.free.to.run.any.comma
1c080	6e 64 20 77 65 20 77 6f 75 6c 64 20 6c 69 6b 65 20 74 6f 20 75 73 65 20 66 6f 72 20 64 65 62 75	nd.we.would.like.to.use.for.debu
1c0a0	67 67 69 6e 67 2c 20 65 2e 67 2e 20 72 65 2d 69 6e 73 74 61 6c 6c 69 6e 67 20 74 68 65 20 66 61	gging,.e.g..re-installing.the.fa
1c0c0	69 6c 65 64 20 70 61 63 6b 61 67 65 20 61 66 74 65 72 20 75 70 64 61 74 69 6e 67 20 74 68 65 20	iled.package.after.updating.the.
1c0e0	72 65 70 6f 73 69 74 6f 72 79 2e 00 57 65 20 6e 6f 77 20 6e 65 65 64 20 74 6f 20 6d 6f 75 6e 74	repository..We.now.need.to.mount
1c100	20 73 6f 6d 65 20 72 65 71 75 69 72 65 64 2c 20 76 6f 6c 61 74 69 6c 65 20 66 69 6c 65 73 79 73	.some.required,.volatile.filesys
1c120	74 65 6d 73 00 57 65 20 6f 6e 6c 79 20 61 63 63 65 70 74 20 62 75 67 66 69 78 65 73 20 69 6e 20	tems.We.only.accept.bugfixes.in.
1c140	70 61 63 6b 61 67 65 73 20 6f 74 68 65 72 20 74 68 61 6e 20 68 74 74 70 73 3a 2f 2f 67 69 74 68	packages.other.than.https://gith
1c160	75 62 2e 63 6f 6d 2f 76 79 6f 73 2f 76 79 6f 73 2d 31 78 20 61 73 20 6e 6f 20 6e 65 77 20 66 75	ub.com/vyos/vyos-1x.as.no.new.fu
1c180	6e 63 74 69 6f 6e 61 6c 69 74 79 20 73 68 6f 75 6c 64 20 75 73 65 20 74 68 65 20 6f 6c 64 20 73	nctionality.should.use.the.old.s
1c1a0	74 79 6c 65 20 74 65 6d 70 6c 61 74 65 73 20 28 60 60 6e 6f 64 65 2e 64 65 66 60 60 20 61 6e 64	tyle.templates.(``node.def``.and
1c1c0	20 50 65 72 6c 2f 42 41 53 48 20 63 6f 64 65 2e 20 55 73 65 20 74 68 65 20 6e 65 77 20 73 74 79	.Perl/BASH.code..Use.the.new.sty
1c1e0	6c 65 20 58 4d 4c 2f 50 79 74 68 6f 6e 20 69 6e 74 65 72 66 61 63 65 20 69 6e 73 74 65 61 64 2e	le.XML/Python.interface.instead.
1c200	00 57 65 20 77 69 6c 6c 20 6e 6f 74 20 61 75 74 6f 2d 63 6c 6f 73 65 20 74 61 73 6b 73 20 77 69	.We.will.not.auto-close.tasks.wi
1c220	74 68 20 61 6e 79 20 6f 74 68 65 72 20 73 74 61 74 75 73 20 61 6e 64 20 77 69 6c 6c 20 6e 6f 74	th.any.other.status.and.will.not
1c240	20 63 6c 6f 73 65 20 74 61 73 6b 73 20 66 6f 72 20 74 68 65 20 6c 61 63 6b 20 6f 66 20 6d 61 69	.close.tasks.for.the.lack.of.mai
1c260	6e 74 61 69 6e 65 72 20 61 63 74 69 76 69 74 79 21 00 57 68 61 74 20 63 6f 6d 6d 61 6e 64 73 20	ntainer.activity!.What.commands.
1c280	64 69 64 20 79 6f 75 20 75 73 65 3f 20 55 73 65 20 65 2e 67 2e 20 60 60 72 75 6e 20 73 68 6f 77	did.you.use?.Use.e.g..``run.show
1c2a0	20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 63 6f 6d 6d 61 6e 64 73 60 60 00 57 68 61 74 20 77	.configuration.commands``.What.w
1c2c0	61 73 20 74 68 65 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 70 72 69 6f 72 20 74 6f 20 74 68	as.the.configuration.prior.to.th
1c2e0	65 20 63 68 61 6e 67 65 3f 00 57 68 61 74 20 77 65 72 65 20 79 6f 75 20 61 74 74 65 6d 70 74 69	e.change?.What.were.you.attempti
1c300	6e 67 20 74 6f 20 61 63 68 69 65 76 65 3f 00 57 68 61 74 2f 77 68 79 2f 68 6f 77 20 73 6f 6d 65	ng.to.achieve?.What/why/how.some
1c320	74 68 69 6e 67 20 68 61 73 20 62 65 65 6e 20 63 68 61 6e 67 65 64 2c 20 6d 61 6b 65 73 20 65 76	thing.has.been.changed,.makes.ev
1c340	65 72 79 6f 6e 65 27 73 20 6c 69 66 65 20 65 61 73 69 65 72 20 77 68 65 6e 20 77 6f 72 6b 69 6e	eryone's.life.easier.when.workin
1c360	67 20 77 69 74 68 20 60 67 69 74 20 62 69 73 65 63 74 60 00 57 68 65 6e 20 61 6e 64 20 49 53 4f	g.with.`git.bisect`.When.and.ISO
1c380	20 69 6d 61 67 65 20 69 73 20 61 73 73 65 6d 62 6c 65 64 20 62 79 20 74 68 65 20 60 56 79 4f 53	.image.is.assembled.by.the.`VyOS
1c3a0	20 43 49 60 5f 2c 20 74 68 65 20 60 60 42 55 49 4c 44 5f 53 4d 4f 4b 45 54 45 53 54 60 60 20 70	.CI`_,.the.``BUILD_SMOKETEST``.p
1c3c0	61 72 61 6d 65 74 65 72 20 69 73 20 65 6e 61 62 6c 65 64 20 62 79 20 64 65 66 61 75 6c 74 2c 20	arameter.is.enabled.by.default,.
1c3e0	77 68 69 63 68 20 77 69 6c 6c 20 65 78 74 65 6e 64 20 74 68 65 20 49 53 4f 20 63 6f 6e 66 69 67	which.will.extend.the.ISO.config
1c400	75 72 61 74 69 6f 6e 20 6c 69 6e 65 20 77 69 74 68 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20	uration.line.with.the.following.
1c420	70 61 63 6b 61 67 65 73 3a 00 57 68 65 6e 20 68 61 76 69 6e 67 20 74 72 6f 75 62 6c 65 20 63 6f	packages:.When.having.trouble.co
1c440	6d 70 69 6c 69 6e 67 20 79 6f 75 72 20 6f 77 6e 20 49 53 4f 20 69 6d 61 67 65 20 6f 72 20 64 65	mpiling.your.own.ISO.image.or.de
1c460	62 75 67 67 69 6e 67 20 4a 65 6e 6b 69 6e 73 20 69 73 73 75 65 73 20 79 6f 75 20 63 61 6e 20 66	bugging.Jenkins.issues.you.can.f
1c480	6f 6c 6c 6f 77 20 74 68 65 20 73 74 65 70 73 20 61 74 20 3a 72 65 66 3a 60 69 73 6f 5f 62 75 69	ollow.the.steps.at.:ref:`iso_bui
1c4a0	6c 64 5f 69 73 73 75 65 73 60 2e 00 57 68 65 6e 20 6d 6f 64 69 66 79 69 6e 67 20 74 68 65 20 73	ld_issues`..When.modifying.the.s
1c4c0	6f 75 72 63 65 20 63 6f 64 65 2c 20 72 65 6d 65 6d 62 65 72 20 74 68 65 73 65 20 72 75 6c 65 73	ource.code,.remember.these.rules
1c4e0	20 6f 66 20 74 68 65 20 6c 65 67 61 63 79 20 65 6c 69 6d 69 6e 61 74 69 6f 6e 20 63 61 6d 70 61	.of.the.legacy.elimination.campa
1c500	69 67 6e 3a 00 57 68 65 6e 20 74 68 65 20 62 75 69 6c 64 20 69 73 20 73 75 63 63 65 73 73 66 75	ign:.When.the.build.is.successfu
1c520	6c 2c 20 74 68 65 20 72 65 73 75 6c 74 69 6e 67 20 69 73 6f 20 63 61 6e 20 62 65 20 66 6f 75 6e	l,.the.resulting.iso.can.be.foun
1c540	64 20 69 6e 73 69 64 65 20 74 68 65 20 60 60 62 75 69 6c 64 60 60 20 64 69 72 65 63 74 6f 72 79	d.inside.the.``build``.directory
1c560	20 61 73 20 60 60 6c 69 76 65 2d 69 6d 61 67 65 2d 5b 61 72 63 68 69 74 65 63 74 75 72 65 5d 2e	.as.``live-image-[architecture].
1c580	68 79 62 72 69 64 2e 69 73 6f 60 60 2e 00 57 68 65 6e 20 77 72 69 74 69 6e 67 20 61 20 6e 65 77	hybrid.iso``..When.writing.a.new
1c5a0	20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 6d 69 67 72 61 74 6f 72 20 69 74 20 6d 61 79 20 68	.configuration.migrator.it.may.h
1c5c0	61 70 70 65 6e 20 74 68 61 74 20 79 6f 75 20 73 65 65 20 61 6e 20 65 72 72 6f 72 20 77 68 65 6e	appen.that.you.see.an.error.when
1c5e0	20 79 6f 75 20 74 72 79 20 74 6f 20 69 6e 76 6f 6b 65 20 69 74 20 6d 61 6e 75 61 6c 6c 79 20 6f	.you.try.to.invoke.it.manually.o
1c600	6e 20 61 20 64 65 76 65 6c 6f 70 6d 65 6e 74 20 73 79 73 74 65 6d 2e 20 54 68 69 73 20 65 72 72	n.a.development.system..This.err
1c620	6f 72 20 77 69 6c 6c 20 6c 6f 6f 6b 20 6c 69 6b 65 3a 00 57 68 65 6e 20 79 6f 75 20 61 72 65 20	or.will.look.like:.When.you.are.
1c640	61 62 6c 65 20 74 6f 20 76 65 72 69 66 79 20 74 68 61 74 20 69 74 20 69 73 20 61 63 74 75 61 6c	able.to.verify.that.it.is.actual
1c660	6c 79 20 61 20 62 75 67 2c 20 73 70 65 6e 64 20 73 6f 6d 65 20 74 69 6d 65 20 74 6f 20 64 6f 63	ly.a.bug,.spend.some.time.to.doc
1c680	75 6d 65 6e 74 20 68 6f 77 20 74 6f 20 72 65 70 72 6f 64 75 63 65 20 74 68 65 20 69 73 73 75 65	ument.how.to.reproduce.the.issue
1c6a0	2e 20 54 68 69 73 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 63 61 6e 20 62 65 20 69 6e 76 61	..This.documentation.can.be.inva
1c6c0	6c 75 61 62 6c 65 2e 00 57 68 65 6e 20 79 6f 75 20 61 72 65 20 77 6f 72 6b 69 6e 67 20 6f 6e 20	luable..When.you.are.working.on.
1c6e0	69 6e 74 65 72 66 61 63 65 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 61 6e 64 20 79 6f 75 20	interface.configuration.and.you.
1c700	61 6c 73 6f 20 77 61 6e 27 74 20 74 6f 20 74 65 73 74 20 69 66 20 74 68 65 20 53 6d 6f 6b 65 74	also.wan't.to.test.if.the.Smoket
1c720	65 73 74 73 20 70 61 73 73 20 79 6f 75 20 77 6f 75 6c 64 20 6e 6f 72 6d 61 6c 6c 79 20 6c 6f 6f	ests.pass.you.would.normally.loo
1c740	73 65 20 74 68 65 20 72 65 6d 6f 74 65 20 53 53 48 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 74 6f 20	se.the.remote.SSH.connection.to.
1c760	79 6f 75 72 20 3a 61 62 62 72 3a 60 44 55 54 20 28 44 65 76 69 63 65 20 55 6e 64 65 72 20 54 65	your.:abbr:`DUT.(Device.Under.Te
1c780	73 74 29 60 2e 20 54 6f 20 68 61 6e 64 6c 65 20 74 68 69 73 20 69 73 73 75 65 2c 20 73 6f 6d 65	st)`..To.handle.this.issue,.some
1c7a0	20 6f 66 20 74 68 65 20 69 6e 74 65 72 66 61 63 65 20 62 61 73 65 64 20 74 65 73 74 73 20 63 61	.of.the.interface.based.tests.ca
1c7c0	6e 20 62 65 20 63 61 6c 6c 65 64 20 77 69 74 68 20 61 6e 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20	n.be.called.with.an.environment.
1c7e0	76 61 72 69 61 62 6c 65 20 62 65 66 6f 72 65 68 61 6e 64 20 74 6f 20 6c 69 6d 69 74 20 74 68 65	variable.beforehand.to.limit.the
1c800	20 6e 75 6d 62 65 72 20 6f 66 20 69 6e 74 65 72 66 61 63 65 73 20 75 73 65 64 20 69 6e 20 74 68	.number.of.interfaces.used.in.th
1c820	65 20 74 65 73 74 2e 20 42 79 20 64 65 66 61 75 6c 74 20 61 6c 6c 20 69 6e 74 65 72 66 61 63 65	e.test..By.default.all.interface
1c840	20 65 2e 67 2e 20 61 6c 6c 20 45 74 68 65 72 6e 65 74 20 69 6e 74 65 72 66 61 63 65 73 20 61 72	.e.g..all.Ethernet.interfaces.ar
1c860	65 20 75 73 65 64 2e 00 57 68 65 6e 20 79 6f 75 20 61 72 65 20 77 6f 72 6b 69 6e 67 20 6f 6e 20	e.used..When.you.are.working.on.
1c880	69 6e 74 65 72 66 61 63 65 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 61 6e 64 20 79 6f 75 20	interface.configuration.and.you.
1c8a0	61 6c 73 6f 20 77 61 6e 74 20 74 6f 20 74 65 73 74 20 69 66 20 74 68 65 20 53 6d 6f 6b 65 74 65	also.want.to.test.if.the.Smokete
1c8c0	73 74 73 20 70 61 73 73 20 79 6f 75 20 77 6f 75 6c 64 20 6e 6f 72 6d 61 6c 6c 79 20 6c 6f 6f 73	sts.pass.you.would.normally.loos
1c8e0	65 20 74 68 65 20 72 65 6d 6f 74 65 20 53 53 48 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 74 6f 20 79	e.the.remote.SSH.connection.to.y
1c900	6f 75 72 20 3a 61 62 62 72 3a 60 44 55 54 20 28 44 65 76 69 63 65 20 55 6e 64 65 72 20 54 65 73	our.:abbr:`DUT.(Device.Under.Tes
1c920	74 29 60 2e 20 54 6f 20 68 61 6e 64 6c 65 20 74 68 69 73 20 69 73 73 75 65 2c 20 73 6f 6d 65 20	t)`..To.handle.this.issue,.some.
1c940	6f 66 20 74 68 65 20 69 6e 74 65 72 66 61 63 65 20 62 61 73 65 64 20 74 65 73 74 73 20 63 61 6e	of.the.interface.based.tests.can
1c960	20 62 65 20 63 61 6c 6c 65 64 20 77 69 74 68 20 61 6e 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 76	.be.called.with.an.environment.v
1c980	61 72 69 61 62 6c 65 20 62 65 66 6f 72 65 68 61 6e 64 20 74 6f 20 6c 69 6d 69 74 20 74 68 65 20	ariable.beforehand.to.limit.the.
1c9a0	6e 75 6d 62 65 72 20 6f 66 20 69 6e 74 65 72 66 61 63 65 73 20 75 73 65 64 20 69 6e 20 74 68 65	number.of.interfaces.used.in.the
1c9c0	20 74 65 73 74 2e 20 42 79 20 64 65 66 61 75 6c 74 20 61 6c 6c 20 69 6e 74 65 72 66 61 63 65 20	.test..By.default.all.interface.
1c9e0	65 2e 67 2e 20 61 6c 6c 20 45 74 68 65 72 6e 65 74 20 69 6e 74 65 72 66 61 63 65 73 20 61 72 65	e.g..all.Ethernet.interfaces.are
1ca00	20 75 73 65 64 2e 00 57 68 65 6e 20 79 6f 75 20 62 65 6c 69 65 76 65 20 79 6f 75 20 68 61 76 65	.used..When.you.believe.you.have
1ca20	20 66 6f 75 6e 64 20 61 20 62 75 67 2c 20 69 74 20 69 73 20 61 6c 77 61 79 73 20 61 20 67 6f 6f	.found.a.bug,.it.is.always.a.goo
1ca40	64 20 69 64 65 61 20 74 6f 20 76 65 72 69 66 79 20 74 68 65 20 69 73 73 75 65 20 70 72 69 6f 72	d.idea.to.verify.the.issue.prior
1ca60	20 74 6f 20 6f 70 65 6e 69 6e 67 20 61 20 62 75 67 20 72 65 71 75 65 73 74 2e 00 57 68 65 6e 20	.to.opening.a.bug.request..When.
1ca80	79 6f 75 20 77 69 73 68 20 74 6f 20 68 61 76 65 20 61 20 64 65 76 65 6c 6f 70 65 72 20 66 69 78	you.wish.to.have.a.developer.fix
1caa0	20 61 20 62 75 67 20 74 68 61 74 20 79 6f 75 20 66 6f 75 6e 64 2c 20 68 65 6c 70 69 6e 67 20 74	.a.bug.that.you.found,.helping.t
1cac0	68 65 6d 20 72 65 70 72 6f 64 75 63 65 20 74 68 65 20 69 73 73 75 65 20 69 73 20 62 65 6e 65 66	hem.reproduce.the.issue.is.benef
1cae0	69 63 69 61 6c 20 74 6f 20 65 76 65 72 79 6f 6e 65 2e 20 42 65 20 73 75 72 65 20 74 6f 20 69 6e	icial.to.everyone..Be.sure.to.in
1cb00	63 6c 75 64 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 61 62 6f 75 74 20 74 68 65 20 68 61 72 64	clude.information.about.the.hard
1cb20	77 61 72 65 20 79 6f 75 20 61 72 65 20 75 73 69 6e 67 2c 20 63 6f 6d 6d 61 6e 64 73 20 74 68 61	ware.you.are.using,.commands.tha
1cb40	74 20 79 6f 75 20 77 65 72 65 20 72 75 6e 6e 69 6e 67 2c 20 61 6e 79 20 6f 74 68 65 72 20 61 63	t.you.were.running,.any.other.ac
1cb60	74 69 76 69 74 69 65 73 20 74 68 61 74 20 79 6f 75 20 6d 61 79 20 68 61 76 65 20 62 65 65 6e 20	tivities.that.you.may.have.been.
1cb80	64 6f 69 6e 67 20 61 74 20 74 68 65 20 74 69 6d 65 2e 20 54 68 69 73 20 61 64 64 69 74 69 6f 6e	doing.at.the.time..This.addition
1cba0	61 6c 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 63 61 6e 20 62 65 20 76 65 72 79 20 75 73 65 66 75	al.information.can.be.very.usefu
1cbc0	6c 2e 00 57 68 69 63 68 20 76 65 72 73 69 6f 6e 20 6f 66 20 56 79 4f 53 20 61 72 65 20 79 6f 75	l..Which.version.of.VyOS.are.you
1cbe0	20 75 73 69 6e 67 3f 20 60 60 72 75 6e 20 73 68 6f 77 20 76 65 72 73 69 6f 6e 60 60 00 57 69 72	.using?.``run.show.version``.Wir
1cc00	65 47 75 61 72 64 00 57 72 69 74 69 6e 67 20 67 6f 6f 64 20 63 6f 6d 6d 69 74 20 6d 65 73 73 61	eGuard.Writing.good.commit.messa
1cc20	67 65 73 00 58 4d 4c 20 28 75 73 65 64 20 66 6f 72 20 43 4c 49 20 64 65 66 69 6e 69 74 69 6f 6e	ges.XML.(used.for.CLI.definition
1cc40	73 29 00 58 4d 4c 20 69 6e 74 65 72 66 61 63 65 20 64 65 66 69 6e 69 74 69 6f 6e 20 66 69 6c 65	s).XML.interface.definition.file
1cc60	73 20 75 73 65 20 74 68 65 20 60 78 6d 6c 2e 69 6e 60 20 66 69 6c 65 20 65 78 74 65 6e 73 69 6f	s.use.the.`xml.in`.file.extensio
1cc80	6e 20 77 68 69 63 68 20 77 61 73 20 69 6d 70 6c 65 6d 65 6e 74 65 64 20 69 6e 20 3a 76 79 74 61	n.which.was.implemented.in.:vyta
1cca0	73 6b 3a 60 54 31 38 34 33 60 2e 20 58 4d 4c 20 69 6e 74 65 72 66 61 63 65 20 64 65 66 69 6e 69	sk:`T1843`..XML.interface.defini
1ccc0	74 69 6f 6e 73 20 74 65 6e 64 20 74 6f 20 68 61 76 65 20 61 20 6c 6f 74 20 6f 66 20 64 75 70 6c	tions.tend.to.have.a.lot.of.dupl
1cce0	69 63 61 74 65 64 20 63 6f 64 65 20 69 6e 20 61 72 65 61 73 20 73 75 63 68 20 61 73 3a 00 58 4d	icated.code.in.areas.such.as:.XM
1cd00	4c 20 69 6e 74 65 72 66 61 63 65 20 64 65 66 69 6e 69 74 69 6f 6e 73 20 66 6f 72 20 56 79 4f 53	L.interface.definitions.for.VyOS
1cd20	20 63 6f 6d 65 20 77 69 74 68 20 61 20 52 65 6c 61 78 4e 47 20 73 63 68 65 6d 61 20 61 6e 64 20	.come.with.a.RelaxNG.schema.and.
1cd40	61 72 65 20 6c 6f 63 61 74 65 64 20 69 6e 20 74 68 65 20 76 79 6f 73 2d 31 78 5f 20 6d 6f 64 75	are.located.in.the.vyos-1x_.modu
1cd60	6c 65 2e 20 54 68 69 73 20 73 63 68 65 6d 61 20 69 73 20 61 20 73 6c 69 67 68 74 6c 79 20 6d 6f	le..This.schema.is.a.slightly.mo
1cd80	64 69 66 69 65 64 20 73 63 68 65 6d 61 20 66 72 6f 6d 20 56 79 43 6f 6e 66 5f 20 61 6c 69 61 73	dified.schema.from.VyConf_.alias
1cda0	20 56 79 4f 53 20 32 2e 30 20 53 6f 20 56 79 4f 53 20 31 2e 32 2e 78 20 69 6e 74 65 72 66 61 63	.VyOS.2.0.So.VyOS.1.2.x.interfac
1cdc0	65 20 64 65 66 69 6e 69 74 69 6f 6e 73 20 77 69 6c 6c 20 62 65 20 72 65 75 73 61 62 6c 65 20 69	e.definitions.will.be.reusable.i
1cde0	6e 20 4e 65 78 74 67 65 6e 20 56 79 4f 53 20 56 65 72 73 69 6f 6e 73 20 77 69 74 68 20 76 65 72	n.Nextgen.VyOS.Versions.with.ver
1ce00	79 20 6d 69 6e 69 6d 61 6c 20 63 68 61 6e 67 65 73 2e 00 58 4d 4c 3a 20 54 61 62 73 20 2a 2a 73	y.minimal.changes..XML:.Tabs.**s
1ce20	68 61 6c 6c 20 6e 6f 74 2a 2a 20 62 65 20 75 73 65 64 2e 20 45 76 65 72 79 20 69 6e 64 65 6e 74	hall.not**.be.used..Every.indent
1ce40	61 74 69 6f 6e 20 6c 65 76 65 6c 20 73 68 6f 75 6c 64 20 62 65 20 32 20 73 70 61 63 65 73 00 59	ation.level.should.be.2.spaces.Y
1ce60	6f 75 20 63 61 6e 20 61 6c 73 6f 20 70 6c 61 63 65 20 74 68 65 20 67 65 6e 65 72 61 74 65 64 20	ou.can.also.place.the.generated.
1ce80	60 2a 2e 64 65 62 60 20 69 6e 74 6f 20 79 6f 75 72 20 49 53 4f 20 62 75 69 6c 64 20 65 6e 76 69	`*.deb`.into.your.ISO.build.envi
1cea0	72 6f 6e 6d 65 6e 74 20 74 6f 20 69 6e 63 6c 75 64 65 20 69 74 20 69 6e 20 61 20 63 75 73 74 6f	ronment.to.include.it.in.a.custo
1cec0	6d 20 69 73 6f 2c 20 73 65 65 20 3a 72 65 66 3a 60 62 75 69 6c 64 5f 63 75 73 74 6f 6d 5f 70 61	m.iso,.see.:ref:`build_custom_pa
1cee0	63 6b 61 67 65 73 60 20 66 6f 72 20 6d 6f 72 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e 00 59 6f	ckages`.for.more.information..Yo
1cf00	75 20 63 61 6e 20 63 72 65 61 74 65 20 79 6f 75 72 73 65 6c 66 20 73 6f 6d 65 20 68 61 6e 64 79	u.can.create.yourself.some.handy
1cf20	20 42 61 73 68 20 61 6c 69 61 73 65 73 20 74 6f 20 61 6c 77 61 79 73 20 6c 61 75 6e 63 68 20 74	.Bash.aliases.to.always.launch.t
1cf40	68 65 20 6c 61 74 65 73 74 20 2d 20 70 65 72 20 72 65 6c 65 61 73 65 20 74 72 61 69 6e 20 28 60	he.latest.-.per.release.train.(`
1cf60	63 75 72 72 65 6e 74 60 20 6f 72 20 60 63 72 75 78 60 29 20 2d 20 63 6f 6e 74 61 69 6e 65 72 2e	current`.or.`crux`).-.container.
1cf80	20 41 64 64 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 74 6f 20 79 6f 75 72 20 60 60 2e 62 61	.Add.the.following.to.your.``.ba
1cfa0	73 68 5f 61 6c 69 61 73 65 73 60 60 20 66 69 6c 65 3a 00 59 6f 75 20 63 61 6e 20 74 79 70 65 20	sh_aliases``.file:.You.can.type.
1cfc0	60 60 68 65 6c 70 60 60 20 74 6f 20 67 65 74 20 61 6e 20 6f 76 65 72 76 69 65 77 20 6f 66 20 74	``help``.to.get.an.overview.of.t
1cfe0	68 65 20 61 76 61 69 6c 61 62 6c 65 20 63 6f 6d 6d 61 6e 64 73 2c 20 61 6e 64 20 60 60 68 65 6c	he.available.commands,.and.``hel
1d000	70 20 63 6f 6d 6d 61 6e 64 60 60 20 74 6f 20 67 65 74 20 6d 6f 72 65 20 69 6e 66 6f 72 6d 61 74	p.command``.to.get.more.informat
1d020	69 6f 6e 20 6f 6e 20 65 61 63 68 20 63 6f 6d 6d 61 6e 64 2e 00 59 6f 75 20 68 61 76 65 20 61 6e	ion.on.each.command..You.have.an
1d040	20 69 64 65 61 20 6f 66 20 68 6f 77 20 74 6f 20 6d 61 6b 65 20 56 79 4f 53 20 62 65 74 74 65 72	.idea.of.how.to.make.VyOS.better
1d060	20 6f 72 20 79 6f 75 20 61 72 65 20 69 6e 20 6e 65 65 64 20 6f 66 20 61 20 73 70 65 63 69 66 69	.or.you.are.in.need.of.a.specifi
1d080	63 20 66 65 61 74 75 72 65 20 77 68 69 63 68 20 61 6c 6c 20 75 73 65 72 73 20 6f 66 20 56 79 4f	c.feature.which.all.users.of.VyO
1d0a0	53 20 77 6f 75 6c 64 20 62 65 6e 65 66 69 74 20 66 72 6f 6d 3f 20 54 6f 20 73 65 6e 64 20 61 20	S.would.benefit.from?.To.send.a.
1d0c0	66 65 61 74 75 72 65 20 72 65 71 75 65 73 74 20 70 6c 65 61 73 65 20 73 65 61 72 63 68 20 50 68	feature.request.please.search.Ph
1d0e0	61 62 72 69 63 61 74 6f 72 5f 20 69 66 20 74 68 65 72 65 20 69 73 20 61 6c 72 65 61 64 79 20 61	abricator_.if.there.is.already.a
1d100	20 72 65 71 75 65 73 74 20 70 65 6e 64 69 6e 67 2e 20 59 6f 75 20 63 61 6e 20 65 6e 68 61 6e 63	.request.pending..You.can.enhanc
1d120	65 20 69 74 20 6f 72 20 69 66 20 79 6f 75 20 64 6f 6e 27 74 20 66 69 6e 64 20 6f 6e 65 2c 20 63	e.it.or.if.you.don't.find.one,.c
1d140	72 65 61 74 65 20 61 20 6e 65 77 20 6f 6e 65 20 62 79 20 75 73 65 20 74 68 65 20 71 75 69 63 6b	reate.a.new.one.by.use.the.quick
1d160	20 6c 69 6e 6b 20 69 6e 20 74 68 65 20 6c 65 66 74 20 73 69 64 65 20 75 6e 64 65 72 20 74 68 65	.link.in.the.left.side.under.the
1d180	20 73 70 65 63 69 66 69 63 20 70 72 6f 6a 65 63 74 2e 00 59 6f 75 20 68 61 76 65 20 61 6e 20 69	.specific.project..You.have.an.i
1d1a0	64 65 61 20 6f 66 20 68 6f 77 20 74 6f 20 6d 61 6b 65 20 56 79 4f 53 20 62 65 74 74 65 72 20 6f	dea.of.how.to.make.VyOS.better.o
1d1c0	72 20 79 6f 75 20 61 72 65 20 69 6e 20 6e 65 65 64 20 6f 66 20 61 20 73 70 65 63 69 66 69 63 20	r.you.are.in.need.of.a.specific.
1d1e0	66 65 61 74 75 72 65 20 77 68 69 63 68 20 61 6c 6c 20 75 73 65 72 73 20 6f 66 20 56 79 4f 53 20	feature.which.all.users.of.VyOS.
1d200	77 6f 75 6c 64 20 62 65 6e 65 66 69 74 20 66 72 6f 6d 3f 20 54 6f 20 73 65 6e 64 20 61 20 66 65	would.benefit.from?.To.send.a.fe
1d220	61 74 75 72 65 20 72 65 71 75 65 73 74 20 70 6c 65 61 73 65 20 73 65 61 72 63 68 20 50 68 61 62	ature.request.please.search.Phab
1d240	72 69 63 61 74 6f 72 5f 20 74 6f 20 63 68 65 63 6b 20 69 66 20 74 68 65 72 65 20 69 73 20 61 6c	ricator_.to.check.if.there.is.al
1d260	72 65 61 64 79 20 61 20 72 65 71 75 65 73 74 20 70 65 6e 64 69 6e 67 2e 20 59 6f 75 20 63 61 6e	ready.a.request.pending..You.can
1d280	20 65 6e 68 61 6e 63 65 20 69 74 20 6f 72 20 69 66 20 79 6f 75 20 64 6f 6e 27 74 20 66 69 6e 64	.enhance.it.or.if.you.don't.find
1d2a0	20 6f 6e 65 2c 20 63 72 65 61 74 65 20 61 20 6e 65 77 20 6f 6e 65 20 62 79 20 75 73 65 20 74 68	.one,.create.a.new.one.by.use.th
1d2c0	65 20 71 75 69 63 6b 20 6c 69 6e 6b 20 69 6e 20 74 68 65 20 6c 65 66 74 20 73 69 64 65 20 75 6e	e.quick.link.in.the.left.side.un
1d2e0	64 65 72 20 74 68 65 20 73 70 65 63 69 66 69 63 20 70 72 6f 6a 65 63 74 2e 00 59 6f 75 20 68 61	der.the.specific.project..You.ha
1d300	76 65 20 79 6f 75 72 20 6f 77 6e 20 63 75 73 74 6f 6d 20 6b 65 72 6e 65 6c 20 60 2a 2e 64 65 62	ve.your.own.custom.kernel.`*.deb
1d320	60 20 70 61 63 6b 61 67 65 73 20 69 6e 20 74 68 65 20 60 70 61 63 6b 61 67 65 73 60 20 66 6f 6c	`.packages.in.the.`packages`.fol
1d340	64 65 72 20 62 75 74 20 6e 65 67 6c 65 63 74 65 64 20 74 6f 20 63 72 65 61 74 65 20 61 6c 6c 20	der.but.neglected.to.create.all.
1d360	72 65 71 75 69 72 65 64 20 6f 75 74 2d 6f 66 20 74 72 65 65 20 6d 6f 64 75 6c 65 73 20 6c 69 6b	required.out-of.tree.modules.lik
1d380	65 20 41 63 63 65 6c 2d 50 50 50 2c 20 49 6e 74 65 6c 20 51 41 54 20 6f 72 20 49 6e 74 65 6c 20	e.Accel-PPP,.Intel.QAT.or.Intel.
1d3a0	4e 49 43 20 64 72 69 76 65 72 73 00 59 6f 75 20 68 61 76 65 20 79 6f 75 72 20 6f 77 6e 20 63 75	NIC.drivers.You.have.your.own.cu
1d3c0	73 74 6f 6d 20 6b 65 72 6e 65 6c 20 60 2a 2e 64 65 62 60 20 70 61 63 6b 61 67 65 73 20 69 6e 20	stom.kernel.`*.deb`.packages.in.
1d3e0	74 68 65 20 60 70 61 63 6b 61 67 65 73 60 20 66 6f 6c 64 65 72 20 62 75 74 20 6e 65 67 6c 65 63	the.`packages`.folder.but.neglec
1d400	74 65 64 20 74 6f 20 63 72 65 61 74 65 20 61 6c 6c 20 72 65 71 75 69 72 65 64 20 6f 75 74 2d 6f	ted.to.create.all.required.out-o
1d420	66 20 74 72 65 65 20 6d 6f 64 75 6c 65 73 20 6c 69 6b 65 20 41 63 63 65 6c 2d 50 50 50 2c 20 57	f.tree.modules.like.Accel-PPP,.W
1d440	69 72 65 47 75 61 72 64 2c 20 49 6e 74 65 6c 20 51 41 54 2c 20 49 6e 74 65 6c 20 4e 49 43 00 59	ireGuard,.Intel.QAT,.Intel.NIC.Y
1d460	6f 75 20 6d 75 73 74 20 63 72 65 61 74 65 20 61 20 74 61 73 6b 20 62 65 66 6f 72 65 20 79 6f 75	ou.must.create.a.task.before.you
1d480	20 73 74 61 72 74 20 77 6f 72 6b 69 6e 67 20 6f 6e 20 61 20 66 65 61 74 75 72 65 2e 20 59 65 73	.start.working.on.a.feature..Yes
1d4a0	2c 20 65 76 65 6e 20 69 66 20 69 74 27 73 20 61 20 74 69 6e 79 20 66 65 61 74 75 72 65 20 e2 80	,.even.if.it's.a.tiny.feature...
1d4c0	94 20 77 65 20 75 73 65 20 74 68 65 20 74 61 73 6b 20 74 72 61 63 6b 65 72 20 74 6f 20 67 65 6e	..we.use.the.task.tracker.to.gen
1d4e0	65 72 61 74 65 20 72 65 6c 65 61 73 65 20 6e 6f 74 65 73 2c 20 73 6f 20 69 74 27 73 20 65 73 73	erate.release.notes,.so.it's.ess
1d500	65 6e 74 69 61 6c 20 74 68 61 74 20 65 76 65 72 79 74 68 69 6e 67 20 69 73 20 72 65 66 6c 65 63	ential.that.everything.is.reflec
1d520	74 65 64 20 74 68 65 72 65 2e 00 59 6f 75 20 6d 75 73 74 20 69 6e 63 6c 75 64 65 20 61 74 20 6c	ted.there..You.must.include.at.l
1d540	65 61 73 74 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 3a 00 59 6f 75 20 73 68 6f 75 64 6c 20 6e	east.the.following:.You.shoudl.n
1d560	6f 77 20 73 65 65 20 61 20 50 79 74 68 6f 6e 20 62 61 63 6b 74 72 61 63 65 20 77 68 69 63 68 20	ow.see.a.Python.backtrace.which.
1d580	77 69 6c 6c 20 68 65 6c 70 20 75 73 20 74 6f 20 68 61 6e 64 6c 65 20 74 68 65 20 69 73 73 75 65	will.help.us.to.handle.the.issue
1d5a0	2c 20 70 6c 65 61 73 65 20 61 74 74 61 63 68 20 69 74 20 74 6f 20 74 68 65 20 50 68 61 62 72 69	,.please.attach.it.to.the.Phabri
1d5c0	63 61 74 6f 72 5f 20 74 61 73 6b 2e 00 59 6f 75 20 73 68 6f 75 6c 64 20 69 6e 63 6c 75 64 65 20	cator_.task..You.should.include.
1d5e0	74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 3a 00 59 6f 75 20 73	the.following.information:.You.s
1d600	68 6f 75 6c 64 20 6e 6f 77 20 73 65 65 20 61 20 50 79 74 68 6f 6e 20 62 61 63 6b 74 72 61 63 65	hould.now.see.a.Python.backtrace
1d620	20 77 68 69 63 68 20 77 69 6c 6c 20 68 65 6c 70 20 75 73 20 74 6f 20 68 61 6e 64 6c 65 20 74 68	.which.will.help.us.to.handle.th
1d640	65 20 69 73 73 75 65 2c 20 70 6c 65 61 73 65 20 61 74 74 61 63 68 20 69 74 20 74 6f 20 74 68 65	e.issue,.please.attach.it.to.the
1d660	20 50 68 61 62 72 69 63 61 74 6f 72 5f 20 74 61 73 6b 2e 00 59 6f 75 20 74 68 65 6e 20 63 61 6e	.Phabricator_.task..You.then.can
1d680	20 70 72 6f 63 65 65 64 20 77 69 74 68 20 63 6c 6f 6e 69 6e 67 20 79 6f 75 72 20 66 6f 72 6b 20	.proceed.with.cloning.your.fork.
1d6a0	6f 72 20 61 64 64 20 61 20 6e 65 77 20 72 65 6d 6f 74 65 20 74 6f 20 79 6f 75 72 20 6c 6f 63 61	or.add.a.new.remote.to.your.loca
1d6c0	6c 20 72 65 70 6f 73 69 74 6f 72 79 3a 00 59 6f 75 72 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e	l.repository:.Your.configuration
1d6e0	20 73 63 72 69 70 74 20 6f 72 20 6f 70 65 72 61 74 69 6f 6e 20 6d 6f 64 65 20 73 63 72 69 70 74	.script.or.operation.mode.script
1d700	20 77 68 69 63 68 20 69 73 20 61 6c 73 6f 20 77 72 69 74 74 65 6e 20 69 6e 20 50 79 74 68 6f 6e	.which.is.also.written.in.Python
1d720	33 20 73 68 6f 75 6c 64 20 68 61 76 65 20 61 20 6c 69 6e 65 20 62 72 65 61 6b 20 6f 6e 20 38 30	3.should.have.a.line.break.on.80
1d740	20 63 68 61 72 61 63 74 65 72 73 2e 20 54 68 69 73 20 73 65 65 6d 73 20 74 6f 20 62 65 20 61 20	.characters..This.seems.to.be.a.
1d760	62 69 74 20 6f 64 64 20 6e 6f 77 61 64 61 79 73 20 62 75 74 20 61 73 20 73 6f 6d 65 20 70 65 6f	bit.odd.nowadays.but.as.some.peo
1d780	70 6c 65 20 61 6c 73 6f 20 77 6f 72 6b 20 72 65 6d 6f 74 65 6c 79 20 6f 72 20 70 72 6f 67 72 61	ple.also.work.remotely.or.progra
1d7a0	6d 20 75 73 69 6e 67 20 76 69 28 6d 29 20 74 68 69 73 20 69 73 20 61 20 66 61 69 72 20 67 6f 6f	m.using.vi(m).this.is.a.fair.goo
1d7c0	64 20 73 74 61 6e 64 61 72 64 20 77 68 69 63 68 20 49 20 68 6f 70 65 20 77 65 20 63 61 6e 20 72	d.standard.which.I.hope.we.can.r
1d7e0	65 6c 79 20 6f 6e 2e 00 60 2e 2f 63 6f 6e 66 69 67 75 72 65 20 2d 2d 65 6e 61 62 6c 65 2d 70 79	ely.on..`./configure.--enable-py
1d800	74 68 6f 6e 2d 65 67 67 73 60 00 60 49 50 76 34 2c 20 49 50 76 36 20 61 6e 64 20 44 48 43 50 28	thon-eggs`.`IPv4,.IPv6.and.DHCP(
1d820	76 36 29 60 5f 20 61 64 64 72 65 73 73 20 61 73 73 69 67 6e 6d 65 6e 74 00 60 49 50 76 34 2c 20	v6)`_.address.assignment.`IPv4,.
1d840	49 50 76 36 60 5f 20 61 64 64 72 65 73 73 20 61 73 73 69 67 6e 6d 65 6e 74 00 60 4d 41 43 20 61	IPv6`_.address.assignment.`MAC.a
1d860	64 64 72 65 73 73 60 5f 20 61 73 73 69 67 6e 6d 65 6e 74 00 60 56 4c 41 4e 20 28 56 49 46 29 60	ddress`_.assignment.`VLAN.(VIF)`
1d880	5f 20 64 65 66 69 6e 69 74 69 6f 6e 00 60 60 4a 65 6e 6b 69 6e 73 3a 20 61 64 64 20 63 75 72 72	_.definition.``Jenkins:.add.curr
1d8a0	65 6e 74 20 47 69 74 20 63 6f 6d 6d 69 74 20 49 44 20 74 6f 20 62 75 69 6c 64 20 64 65 73 63 72	ent.Git.commit.ID.to.build.descr
1d8c0	69 70 74 69 6f 6e 60 60 00 60 60 63 6f 6d 6d 61 6e 64 60 60 20 2d 20 4f 6e 63 65 20 73 65 74 2c	iption``.``command``.-.Once.set,
1d8e0	20 61 6c 6c 20 63 6f 6d 6d 61 6e 64 73 20 75 73 65 64 2c 20 61 6e 64 20 74 68 65 69 72 20 72 65	.all.commands.used,.and.their.re
1d900	73 70 6f 6e 73 65 73 20 72 65 63 65 69 76 65 64 20 66 72 6f 6d 20 74 68 65 20 4f 53 2c 20 77 69	sponses.received.from.the.OS,.wi
1d920	6c 6c 20 62 65 20 70 72 65 73 65 6e 74 65 64 20 6f 6e 20 74 68 65 20 73 63 72 65 65 6e 20 66 6f	ll.be.presented.on.the.screen.fo
1d940	72 20 69 6e 73 70 65 63 74 69 6f 6e 2e 00 60 60 63 6f 6d 6d 69 74 60 60 00 60 60 64 64 63 6c 69	r.inspection..``commit``.``ddcli
1d960	65 6e 74 3a 20 54 31 30 33 30 3a 20 61 75 74 6f 20 63 72 65 61 74 65 20 72 75 6e 74 69 6d 65 20	ent:.T1030:.auto.create.runtime.
1d980	64 69 72 65 63 74 6f 72 69 65 73 60 60 00 60 60 64 65 76 65 6c 6f 70 65 72 60 60 20 2d 20 53 68	directories``.``developer``.-.Sh
1d9a0	6f 75 6c 64 20 61 20 63 6f 6d 6d 61 6e 64 20 66 61 69 6c 2c 20 69 6e 73 74 65 61 64 20 6f 66 20	ould.a.command.fail,.instead.of.
1d9c0	70 72 69 6e 74 69 6e 67 20 61 20 6d 65 73 73 61 67 65 20 74 6f 20 74 68 65 20 75 73 65 72 20 65	printing.a.message.to.the.user.e
1d9e0	78 70 6c 61 69 6e 69 6e 67 20 68 6f 77 20 74 6f 20 72 65 70 6f 72 74 20 69 73 73 75 65 73 2c 20	xplaining.how.to.report.issues,.
1da00	74 68 65 20 70 79 74 68 6f 6e 20 69 6e 74 65 72 70 72 65 74 65 72 20 77 69 6c 6c 20 73 74 61 72	the.python.interpreter.will.star
1da20	74 20 61 20 50 42 44 20 70 6f 73 74 2d 6d 6f 72 74 65 6d 20 73 65 73 73 69 6f 6e 20 74 6f 20 61	t.a.PBD.post-mortem.session.to.a
1da40	6c 6c 6f 77 20 74 68 65 20 64 65 76 65 6c 6f 70 65 72 20 74 6f 20 64 65 62 75 67 20 74 68 65 20	llow.the.developer.to.debug.the.
1da60	69 73 73 75 65 2e 20 41 73 20 74 68 65 20 64 65 62 75 67 67 65 72 20 77 69 6c 6c 20 77 61 69 74	issue..As.the.debugger.will.wait
1da80	20 66 72 6f 6d 20 69 6e 70 75 74 20 66 72 6f 6d 20 74 68 65 20 64 65 76 65 6c 6f 70 65 72 2c 20	.from.input.from.the.developer,.
1daa0	69 74 20 68 61 73 20 74 68 65 20 63 61 70 61 63 69 74 79 20 74 6f 20 70 72 65 76 65 6e 74 20 61	it.has.the.capacity.to.prevent.a
1dac0	20 72 6f 75 74 65 72 20 74 6f 20 62 6f 6f 74 20 61 6e 64 20 74 68 65 72 65 66 6f 72 65 20 73 68	.router.to.boot.and.therefore.sh
1dae0	6f 75 6c 64 20 6f 6e 6c 79 20 62 65 20 70 65 72 6d 61 6e 65 6e 74 6c 79 20 73 65 74 20 75 70 20	ould.only.be.permanently.set.up.
1db00	6f 6e 20 70 72 6f 64 75 63 74 69 6f 6e 20 69 66 20 79 6f 75 20 61 72 65 20 72 65 61 64 79 20 74	on.production.if.you.are.ready.t
1db20	6f 20 73 65 65 20 74 68 65 20 4f 53 20 66 61 69 6c 20 74 6f 20 62 6f 6f 74 2e 00 60 60 69 66 63	o.see.the.OS.fail.to.boot..``ifc
1db40	6f 6e 66 69 67 60 60 20 2d 20 4f 6e 63 65 20 73 65 74 2c 20 61 6c 6c 20 63 6f 6d 6d 61 6e 64 73	onfig``.-.Once.set,.all.commands
1db60	20 75 73 65 64 2c 20 61 6e 64 20 74 68 65 69 72 20 72 65 73 70 6f 6e 73 65 73 20 72 65 63 65 69	.used,.and.their.responses.recei
1db80	76 65 64 20 66 72 6f 6d 20 74 68 65 20 4f 53 2c 20 77 69 6c 6c 20 62 65 20 70 72 65 73 65 6e 74	ved.from.the.OS,.will.be.present
1dba0	65 64 20 6f 6e 20 74 68 65 20 73 63 72 65 65 6e 20 66 6f 72 20 69 6e 73 70 65 63 74 69 6f 6e 2e	ed.on.the.screen.for.inspection.
1dbc0	00 60 60 6c 6f 67 60 60 20 2d 20 49 6e 20 73 6f 6d 65 20 72 61 72 65 20 63 61 73 65 73 2c 20 69	.``log``.-.In.some.rare.cases,.i
1dbe0	74 20 6d 61 79 20 62 65 20 75 73 65 66 75 6c 20 74 6f 20 73 65 65 20 77 68 61 74 20 74 68 65 20	t.may.be.useful.to.see.what.the.
1dc00	4f 53 20 69 73 20 64 6f 69 6e 67 2c 20 69 6e 63 6c 75 64 69 6e 67 20 64 75 72 69 6e 67 20 62 6f	OS.is.doing,.including.during.bo
1dc20	6f 74 2e 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 73 65 6e 64 73 20 61 6c 6c 20 63 6f 6d 6d 61 6e	ot..This.option.sends.all.comman
1dc40	64 73 20 75 73 65 64 20 62 79 20 56 79 4f 53 20 74 6f 20 61 20 66 69 6c 65 2e 20 54 68 65 20 64	ds.used.by.VyOS.to.a.file..The.d
1dc60	65 66 61 75 6c 74 20 66 69 6c 65 20 69 73 20 60 60 2f 74 6d 70 2f 66 75 6c 6c 2d 6c 6f 67 60 60	efault.file.is.``/tmp/full-log``
1dc80	20 62 75 74 20 69 74 20 63 61 6e 20 62 65 20 63 68 61 6e 67 65 64 2e 00 60 60 73 65 74 60 60 00	.but.it.can.be.changed..``set``.
1dca0	60 60 76 79 6f 73 2d 62 75 69 6c 64 60 60 20 72 65 70 6f 20 69 73 20 6f 75 74 64 61 74 65 64 2c	``vyos-build``.repo.is.outdated,
1dcc0	20 70 6c 65 61 73 65 20 60 60 67 69 74 20 70 75 6c 6c 60 60 20 74 6f 20 75 70 64 61 74 65 20 74	.please.``git.pull``.to.update.t
1dce0	6f 20 74 68 65 20 6c 61 74 65 73 74 20 72 65 6c 65 61 73 65 20 6b 65 72 6e 65 6c 20 76 65 72 73	o.the.latest.release.kernel.vers
1dd00	69 6f 6e 20 66 72 6f 6d 20 75 73 2e 00 60 60 76 79 6f 73 2d 63 6f 6e 66 69 67 2d 64 65 62 75 67	ion.from.us..``vyos-config-debug
1dd20	60 60 20 2d 20 44 75 72 69 6e 67 20 64 65 76 65 6c 6f 70 6d 65 6e 74 2c 20 63 6f 64 69 6e 67 20	``.-.During.development,.coding.
1dd40	65 72 72 6f 72 73 20 63 61 6e 20 6c 65 61 64 20 74 6f 20 61 20 63 6f 6d 6d 69 74 20 66 61 69 6c	errors.can.lead.to.a.commit.fail
1dd60	75 72 65 20 6f 6e 20 62 6f 6f 74 2c 20 70 6f 73 73 69 62 6c 79 20 72 65 73 75 6c 74 69 6e 67 20	ure.on.boot,.possibly.resulting.
1dd80	69 6e 20 61 20 66 61 69 6c 65 64 20 69 6e 69 74 69 61 6c 69 7a 61 74 69 6f 6e 20 6f 66 20 74 68	in.a.failed.initialization.of.th
1dda0	65 20 43 4c 49 2e 20 49 6e 20 74 68 69 73 20 63 69 72 63 75 6d 73 74 61 6e 63 65 2c 20 74 68 65	e.CLI..In.this.circumstance,.the
1ddc0	20 6b 65 72 6e 65 6c 20 62 6f 6f 74 20 70 61 72 61 6d 65 74 65 72 20 60 60 76 79 6f 73 2d 63 6f	.kernel.boot.parameter.``vyos-co
1dde0	6e 66 69 67 2d 64 65 62 75 67 60 60 20 77 69 6c 6c 20 65 6e 73 75 72 65 20 61 63 63 65 73 73 20	nfig-debug``.will.ensure.access.
1de00	74 6f 20 74 68 65 20 73 79 73 74 65 6d 20 61 73 20 75 73 65 72 20 60 60 76 79 6f 73 60 60 2c 20	to.the.system.as.user.``vyos``,.
1de20	61 6e 64 20 77 69 6c 6c 20 6c 6f 67 20 61 20 50 79 74 68 6f 6e 20 73 74 61 63 6b 20 74 72 61 63	and.will.log.a.Python.stack.trac
1de40	65 20 74 6f 20 74 68 65 20 66 69 6c 65 20 60 60 2f 74 6d 70 2f 62 6f 6f 74 2d 63 6f 6e 66 69 67	e.to.the.file.``/tmp/boot-config
1de60	2d 74 72 61 63 65 60 60 2e 20 46 69 6c 65 20 60 60 62 6f 6f 74 2d 63 6f 6e 66 69 67 2d 74 72 61	-trace``..File.``boot-config-tra
1de80	63 65 60 60 20 77 69 6c 6c 20 67 65 6e 65 72 61 74 65 20 6f 6e 6c 79 20 69 66 20 63 6f 6e 66 69	ce``.will.generate.only.if.confi
1dea0	67 20 6c 6f 61 64 65 64 20 77 69 74 68 20 61 20 66 61 69 6c 75 72 65 20 73 74 61 74 75 73 2e 00	g.loaded.with.a.failure.status..
1dec0	60 60 76 79 6f 73 2d 64 65 62 75 67 60 60 20 2d 20 41 64 64 69 6e 67 20 74 68 65 20 70 61 72 61	``vyos-debug``.-.Adding.the.para
1dee0	6d 65 74 65 72 20 74 6f 20 74 68 65 20 6c 69 6e 75 78 20 62 6f 6f 74 20 6c 69 6e 65 20 77 69 6c	meter.to.the.linux.boot.line.wil
1df00	6c 20 70 72 6f 64 75 63 65 20 74 69 6d 69 6e 67 20 72 65 73 75 6c 74 73 20 66 6f 72 20 74 68 65	l.produce.timing.results.for.the
1df20	20 65 78 65 63 75 74 69 6f 6e 20 6f 66 20 73 63 72 69 70 74 73 20 64 75 72 69 6e 67 20 63 6f 6d	.execution.of.scripts.during.com
1df40	6d 69 74 2e 20 49 66 20 6f 6e 65 20 69 73 20 73 65 65 69 6e 67 20 61 6e 20 75 6e 65 78 70 65 63	mit..If.one.is.seeing.an.unexpec
1df60	74 65 64 20 64 65 6c 61 79 20 64 75 72 69 6e 67 20 6d 61 6e 75 61 6c 20 6f 72 20 62 6f 6f 74 20	ted.delay.during.manual.or.boot.
1df80	63 6f 6d 6d 69 74 2c 20 74 68 69 73 20 6d 61 79 20 62 65 20 75 73 65 66 75 6c 20 69 6e 20 69 64	commit,.this.may.be.useful.in.id
1dfa0	65 6e 74 69 66 79 69 6e 67 20 62 6f 74 74 6c 65 6e 65 63 6b 73 2e 20 54 68 65 20 69 6e 74 65 72	entifying.bottlenecks..The.inter
1dfc0	6e 61 6c 20 66 6c 61 67 20 69 73 20 60 60 56 59 4f 53 5f 44 45 42 55 47 60 60 2c 20 61 6e 64 20	nal.flag.is.``VYOS_DEBUG``,.and.
1dfe0	69 73 20 66 6f 75 6e 64 20 69 6e 20 76 79 61 74 74 61 2d 63 66 67 5f 2e 20 4f 75 74 70 75 74 20	is.found.in.vyatta-cfg_..Output.
1e000	69 73 20 64 69 72 65 63 74 65 64 20 74 6f 20 60 60 2f 76 61 72 2f 6c 6f 67 2f 76 79 61 74 74 61	is.directed.to.``/var/log/vyatta
1e020	2f 63 66 67 2d 73 74 64 6f 75 74 2e 6c 6f 67 60 60 2e 00 60 63 64 20 73 72 63 2f 6c 69 62 63 68	/cfg-stdout.log``..`cd.src/libch
1e040	61 72 6f 6e 2f 70 6c 75 67 69 6e 73 2f 76 69 63 69 2f 70 79 74 68 6f 6e 60 00 60 63 64 20 76 79	aron/plugins/vici/python`.`cd.vy
1e060	6f 73 2d 73 74 72 6f 6e 67 73 77 61 6e 60 00 60 6d 61 6b 65 60 00 60 70 79 74 68 6f 6e 33 20 73	os-strongswan`.`make`.`python3.s
1e080	65 74 75 70 2e 70 79 20 2d 2d 63 6f 6d 6d 61 6e 64 2d 70 61 63 6b 61 67 65 73 3d 73 74 64 65 62	etup.py.--command-packages=stdeb
1e0a0	2e 63 6f 6d 6d 61 6e 64 20 62 64 69 73 74 5f 64 65 62 60 00 61 6c 6c 6f 77 65 64 3a 20 2f 70 61	.command.bdist_deb`.allowed:./pa
1e0c0	74 68 2f 74 6f 2f 73 63 72 69 70 74 00 61 6c 6c 6f 77 65 64 3a 20 63 6c 69 2d 73 68 65 6c 6c 2d	th/to/script.allowed:.cli-shell-
1e0e0	61 70 69 20 6c 69 73 74 4e 6f 64 65 73 20 76 70 6e 20 69 70 73 65 63 20 65 73 70 2d 67 72 6f 75	api.listNodes.vpn.ipsec.esp-grou
1e100	70 00 61 6c 6c 6f 77 65 64 3a 20 65 63 68 6f 20 66 6f 6f 20 62 61 72 00 62 65 67 69 6e 3a 2f 63	p.allowed:.echo.foo.bar.begin:/c
1e120	72 65 61 74 65 3a 2f 64 65 6c 65 74 65 3a 00 63 6f 6d 6d 69 74 3a 65 78 70 72 65 73 73 69 6f 6e	reate:/delete:.commit:expression
1e140	3a 00 63 6f 6e 74 69 6e 65 20 65 78 65 63 75 74 69 6f 6e 20 75 73 69 6e 67 20 60 60 63 6f 6e 74	:.contine.execution.using.``cont
1e160	60 60 00 63 6f 6e 74 69 6e 75 65 20 65 78 65 63 75 74 69 6f 6e 20 75 73 69 6e 67 20 60 60 63 6f	``.continue.execution.using.``co
1e180	6e 74 60 60 00 64 65 66 61 75 6c 74 3a 00 65 78 61 6d 69 6e 65 20 76 61 72 69 61 62 6c 65 73 20	nt``.default:.examine.variables.
1e1a0	75 73 69 6e 67 20 60 60 70 70 28 76 61 72 29 60 60 00 67 65 74 20 61 20 62 61 63 6b 74 72 61 63	using.``pp(var)``.get.a.backtrac
1e1c0	65 20 75 73 69 6e 67 20 60 60 62 74 60 60 00 68 65 6c 70 3a 20 4d 79 20 6e 6f 64 65 00 68 74 74	e.using.``bt``.help:.My.node.htt
1e1e0	70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 76 79 6f 73 2f 76 79 61 74 74 61 2d 63 66 67 2f	ps://github.com/vyos/vyatta-cfg/
1e200	62 6c 6f 62 2f 30 66 34 32 37 38 36 61 30 62 33 2f 73 72 63 2f 63 6f 6d 6d 69 74 2f 63 6f 6d 6d	blob/0f42786a0b3/src/commit/comm
1e220	69 74 2d 61 6c 67 6f 72 69 74 68 6d 2e 63 70 70 23 4c 31 32 35 32 00 68 74 74 70 73 3a 2f 2f 67	it-algorithm.cpp#L1252.https://g
1e240	69 74 68 75 62 2e 63 6f 6d 2f 76 79 6f 73 2f 76 79 61 74 74 61 2d 63 66 67 2f 62 6c 6f 62 2f 30	ithub.com/vyos/vyatta-cfg/blob/0
1e260	66 34 32 37 38 36 61 30 62 33 2f 73 72 63 2f 63 73 74 6f 72 65 2f 63 73 74 6f 72 65 2e 63 70 70	f42786a0b3/src/cstore/cstore.cpp
1e280	23 4c 32 35 34 39 00 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 76 79 6f 73 2f 76	#L2549.https://github.com/vyos/v
1e2a0	79 61 74 74 61 2d 63 66 67 2f 62 6c 6f 62 2f 30 66 34 32 37 38 36 61 30 62 33 2f 73 72 63 2f 63	yatta-cfg/blob/0f42786a0b3/src/c
1e2c0	73 74 6f 72 65 2f 63 73 74 6f 72 65 2e 63 70 70 23 4c 33 35 32 00 68 76 69 6e 66 6f 00 6b 65 65	store/cstore.cpp#L352.hvinfo.kee
1e2e0	70 61 6c 69 76 65 64 00 6d 64 6e 73 2d 72 65 70 65 61 74 65 72 00 6d 75 6c 74 69 3a 00 6d 79 6e	palived.mdns-repeater.multi:.myn
1e300	6f 64 65 2f 6e 6f 64 65 2e 64 65 66 00 6d 79 6e 6f 64 65 2f 6e 6f 64 65 2e 74 61 67 20 2c 20 74	ode/node.def.mynode/node.tag.,.t
1e320	61 67 3a 00 70 72 69 6f 72 69 74 79 3a 20 39 39 39 00 73 74 72 6f 6e 67 73 77 61 6e 00 73 74 72	ag:.priority:.999.strongswan.str
1e340	6f 6e 67 73 77 61 6e 2d 6e 6d 20 70 61 63 6b 61 67 65 20 62 75 69 6c 64 20 69 73 20 64 69 73 61	ongswan-nm.package.build.is.disa
1e360	62 6c 65 64 20 73 69 6e 63 65 20 77 65 20 64 6f 6e 27 74 20 75 73 65 20 4e 65 74 77 6f 72 6b 4d	bled.since.we.don't.use.NetworkM
1e380	61 6e 61 67 65 72 00 73 79 6e 74 61 78 3a 65 78 70 72 65 73 73 69 6f 6e 3a 20 24 56 41 52 28 40	anager.syntax:expression:.$VAR(@
1e3a0	29 20 69 6e 20 22 66 6f 6f 22 2c 20 22 62 61 72 22 2c 20 22 62 61 7a 22 00 73 79 6e 74 61 78 3a	).in."foo",."bar",."baz".syntax:
1e3c0	65 78 70 72 65 73 73 69 6f 6e 3a 20 28 61 72 69 74 68 6d 65 74 69 63 20 65 78 70 72 65 73 73 69	expression:.(arithmetic.expressi
1e3e0	6f 6e 29 00 73 79 6e 74 61 78 3a 65 78 70 72 65 73 73 69 6f 6e 3a 20 65 78 65 63 20 2e 2e 2e 00	on).syntax:expression:.exec.....
1e400	73 79 6e 74 61 78 3a 65 78 70 72 65 73 73 69 6f 6e 3a 20 70 61 74 74 65 72 6e 00 75 64 70 2d 62	syntax:expression:.pattern.udp-b
1e420	72 6f 61 64 63 61 73 74 2d 72 65 6c 61 79 00 76 61 6c 5f 68 65 6c 70 3a 20 3c 66 6f 72 6d 61 74	roadcast-relay.val_help:.<format
1e440	3e 3b 20 73 6f 6d 65 20 73 74 72 69 6e 67 00 76 79 6f 73 2d 6e 65 74 70 6c 75 67 00	>;.some.string.vyos-netplug.