summaryrefslogtreecommitdiffstats
path: root/modules-available/serversetup-bwlp-ipxe/inc/scriptbuilderbase.inc.php
blob: 84cfd7dbf1d9cf1234ca4271117c0c95173aa88f (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
<?php

abstract class ScriptBuilderBase
{

	private $lblId = 0;

	protected $serverIp;

	protected $platform = '';

	protected $clientIp;

	protected $uuid;

	/**
	 * @var bool Running iPXE has slx-extensions
	 */
	protected $hasExtension = false;

	public function hasExtensions()
	{
		return $this->hasExtension;
	}

	public function platform()
	{
		return $this->platform;
	}

	public function uuid()
	{
		return $this->uuid;
	}

	public function clientIp()
	{
		return $this->clientIp;
	}

	public function getLabel()
	{
		return 'b' . mt_rand(100, 999) . 'x' . (++$this->lblId);
	}

	public function __construct($platform = null, $serverIp = null, $slxExtensions = null)
	{
		$this->clientIp = $_SERVER['REMOTE_ADDR'];
		if (substr($this->clientIp, 0, 7) === '::ffff:') {
			$this->clientIp = substr($this->clientIp, 7);
		}
		$this->serverIp = $serverIp ?? $_SERVER['SERVER_ADDR'] ?? Property::getServerIp();
		$this->platform = $platform ?? Request::any('platform', false, 'string');
		if ($this->platform !== false) {
			$this->platform = strtoupper($this->platform);
		}
		if ($this->platform !== 'EFI' && $this->platform !== 'PCBIOS') {
			$this->platform = '';
		}
		$this->hasExtension = $slxExtensions ?? (bool)Request::any('slx-extensions', false, 'int');
		$this->uuid = Request::any('uuid', false, 'string');
		if (!preg_match('/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i', $this->uuid)) {
			$this->uuid = false;
		}
	}

	/**
	 * Output given string (script) to client, in a suitable encoding, headers, etc.
	 * @param string $string
	 */
	public abstract function output($string);

	public abstract function bootstrapLive();

	public abstract function getMenu(IPxeMenu $menu, bool $bootstrap);

	/**
	 * @param MenuEntry|null $menuEntry The according menu entry, or null if invalid.
	 * @param bool $honorPassword Whether we should generate a password dialog if protected, or skip
	 * @return string generated script/code/...
	 */
	public abstract function getMenuEntry($menuEntry, $honorPassword = true);

	/**
	 * @param BootEntry|null|false $bootEntry
	 * @return string
	 */
	public abstract function getBootEntry($bootEntry);

	public abstract function getSpecial($special);

	/**
	 * @param IPxeMenu|null $menu
	 * @return string
	 */
	public abstract function menuToScript($menu);

	/**
	 * Pass EITHER only $agnostic, OR $bios and/or $efi
	 * If $agnostic is given, it should be used unconditionally,
	 * and $bios/$efi should be ignored.
	 * @param ExecData $agnostic
	 * @param ExecData $bios
	 * @param ExecData $efi
	 * @return string
	 */
	public abstract function execDataToScript($agnostic, $bios, $efi);

}