[S] Change in flashrom[main]: libflashrom: Iterator like API to get list of programmers

[Dmitry Zhadinets (Code Review)]

Attention is currently required from: Anastasia Klimchuk.

Dmitry Zhadinets has uploaded this change for review. ( https://review.coreboot.org/c/flashrom/+/86947?usp=email )

Change subject: libflashrom: Iterator like API to get list of programmers
......................................................................

libflashrom: Iterator like API to get list of programmers

Change-Id: I89cce7625e8731ee26331934f36cfd1c8c570225
Signed-off-by: Dmitry Zhadinets 
---
M include/libflashrom.h
M libflashrom.c
M libflashrom.map
M tests/libflashrom.c
4 files changed, 22 insertions(+), 1 deletion(-)

git pull ssh://review.coreboot.org:29418/flashrom refs/changes/47/86947/1

diff --git a/include/libflashrom.h b/include/libflashrom.h
index 7f90fa4..7ee60a8 100644
--- a/include/libflashrom.h
+++ b/include/libflashrom.h
@@ -168,6 +168,13 @@
  */
 const char ** flashrom_supported_programmers(void);
 /**
+ * @brief Return the name of the programmer with the given ID, starting from 0.
+ *
+ * @return NULL if n is larger than the number of available programmers or less
+ * than zero.
+ */
+const char *flashrom_get_programmer_name(int n);
+/**
  * @brief Returns list of supported flash chips
  * @return List of supported flash chips, or NULL if an error occurred
  */
diff --git a/libflashrom.c b/libflashrom.c
index 76ab32a..ad19073 100644
--- a/libflashrom.c
+++ b/libflashrom.c
@@ -156,6 +156,13 @@
    return result;
 }

+const char *flashrom_get_programmer_name(int n)
+{
+	if (n < 0 || (size_t)n >= programmer_table_size)
+		return NULL;
+	return programmer_table[n]->name;
+}
+
 struct flashrom_flashchip_info *flashrom_supported_flash_chips(void)
 {
    struct flashrom_flashchip_info *supported_flashchips =
diff --git a/libflashrom.map b/libflashrom.map
index 9af163e..e2c734e 100644
--- a/libflashrom.map
+++ b/libflashrom.map
@@ -7,6 +7,7 @@
     flashrom_flash_getsize;
     flashrom_flash_probe;
     flashrom_flash_release;
+    flashrom_get_programmer_name;
     flashrom_image_read;
     flashrom_image_verify;
     flashrom_image_write;
diff --git a/tests/libflashrom.c b/tests/libflashrom.c
index 173c8a9..653df28 100644
--- a/tests/libflashrom.c
+++ b/tests/libflashrom.c
@@ -1,7 +1,7 @@
 /*
  * This file is part of the flashrom project.
  *
- * Copyright 2020 Google LLC
+ * Copyright 2025 Dmitry Zhadinets 
  *
  * This program is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
@@ -18,6 +18,7 @@
  #include <include/test.h>
  #include "tests.h"
  #include "libflashrom.h"
+ extern const size_t programmer_table_size;

void enumerators_test_success(void **state)
 {
@@ -29,6 +30,11 @@
    flashrom_data_free(array);
     assert_int_not_equal(ptr - array, 0);

+    assert_null(flashrom_get_programmer_name(-1));
+    assert_non_null(flashrom_get_programmer_name(0));
+    assert_null(flashrom_get_programmer_name(programmer_table_size));
+    assert_non_null(flashrom_get_programmer_name(programmer_table_size - 1));
+
 #if CONFIG_DUMMY == 1
     struct flashrom_programmer *flashprog = NULL;
     flashrom_programmer_init(&flashprog, "dummy", "emulate=SST25VF040.REMS");