arch/sparc/kernel/prom_common.c
Source file repositories/reference/linux-study-clean/arch/sparc/kernel/prom_common.c
File Facts
- System
- Linux kernel
- Corpus path
arch/sparc/kernel/prom_common.c- Extension
.c- Size
- 3500 bytes
- Lines
- 162
- Domain
- Architecture Layer
- Bucket
- arch/sparc
- Inferred role
- Architecture Layer: exported/initcall integration point
- Status
- integration implementation candidate
Why This File Exists
CPU and platform-specific kernel glue: boot entry, traps, syscall entry, interrupts, page tables, context switch, and low-level barriers.
- CPU and platform-specific kernel glue: boot entry, traps, syscall entry, interrupts, page tables, context switch, and low-level barriers.
- Exports symbols or registers init work; inspect boot/module ordering and who consumes the exported contract.
- Uses kernel synchronization; read lock ordering, sleepability, and interrupt context assumptions before translating.
- Defines or uses C structs; map object ownership, embedded links, reference counts, and lock ownership.
Dependency Surface
linux/kernel.hlinux/export.hlinux/errno.hlinux/mutex.hlinux/slab.hlinux/of.hlinux/of_pdt.hasm/prom.hasm/oplib.hprom.h
Detected Declarations
function of_getintprop_defaultfunction of_set_propertyfunction of_find_in_proplistfunction handle_nextprop_quirksfunction prom_common_nextpropfunction prom_build_devicetreeexport of_console_deviceexport of_console_pathexport of_console_optionsexport of_getintprop_defaultexport of_set_property_mutexexport of_set_propertyexport of_find_in_proplist
Annotated Snippet
if (!strcasecmp(prop->name, name)) {
void *old_val = prop->value;
int ret;
ret = prom_setprop(dp->phandle, name, val, len);
err = -EINVAL;
if (ret >= 0) {
prop->value = new_val;
prop->length = len;
if (OF_IS_DYNAMIC(prop))
kfree(old_val);
OF_MARK_DYNAMIC(prop);
err = 0;
}
break;
}
prevp = &(*prevp)->next;
}
raw_spin_unlock_irqrestore(&devtree_lock, flags);
mutex_unlock(&of_set_property_mutex);
/* XXX Upate procfs if necessary... */
return err;
}
EXPORT_SYMBOL(of_set_property);
int of_find_in_proplist(const char *list, const char *match, int len)
{
while (len > 0) {
int l;
if (!strcmp(list, match))
return 1;
l = strlen(list) + 1;
list += l;
len -= l;
}
return 0;
}
EXPORT_SYMBOL(of_find_in_proplist);
/*
* SPARC32 and SPARC64's prom_nextprop() do things differently
* here, despite sharing the same interface. SPARC32 doesn't fill in 'buf',
* returning NULL on an error. SPARC64 fills in 'buf', but sets it to an
* empty string upon error.
*/
static int __init handle_nextprop_quirks(char *buf, const char *name)
{
size_t name_len;
name_len = name ? strlen(name) : 0;
if (name_len == 0)
return -1;
#ifdef CONFIG_SPARC32
strscpy(buf, name, name_len + 1);
#endif
return 0;
}
static int __init prom_common_nextprop(phandle node, char *prev, char *buf)
{
const char *name;
buf[0] = '\0';
name = prom_nextprop(node, prev, buf);
return handle_nextprop_quirks(buf, name);
}
unsigned int prom_early_allocated __initdata;
static struct of_pdt_ops prom_sparc_ops __initdata = {
.nextprop = prom_common_nextprop,
.getproplen = prom_getproplen,
.getproperty = prom_getproperty,
.getchild = prom_getchild,
.getsibling = prom_getsibling,
};
void __init prom_build_devicetree(void)
{
of_pdt_build_devicetree(prom_root_node, &prom_sparc_ops);
of_console_init();
Annotation
- Immediate include surface: `linux/kernel.h`, `linux/export.h`, `linux/errno.h`, `linux/mutex.h`, `linux/slab.h`, `linux/of.h`, `linux/of_pdt.h`, `asm/prom.h`.
- Detected declarations: `function of_getintprop_default`, `function of_set_property`, `function of_find_in_proplist`, `function handle_nextprop_quirks`, `function prom_common_nextprop`, `function prom_build_devicetree`, `export of_console_device`, `export of_console_path`, `export of_console_options`, `export of_getintprop_default`.
- Atlas domain: Architecture Layer / arch/sparc.
- Implementation status: integration implementation candidate.
- Synchronization appears in or near this file; preserve lock ordering, sleepability, and interrupt-context constraints.
Implementation Notes
- This generated page is the file-by-file coverage layer; curated subsystem chapters should link here when they synthesize a multi-file control flow.
- Core OS pages should be promoted from atlas-only to deep-reviewed when they explain data structures, invariants, locking, lifecycle, and C implementation snippets.
- Driver-family pages are intentionally pattern-oriented unless they are part of the selected PCIe/NVMe representative device path.