Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/itztravelintime/tinuioregistry
A Swift library to access information from the macOS IORegistry.
https://github.com/itztravelintime/tinuioregistry
iokit ioregistryexplorer macos swift
Last synced: 19 days ago
JSON representation
A Swift library to access information from the macOS IORegistry.
- Host: GitHub
- URL: https://github.com/itztravelintime/tinuioregistry
- Owner: ITzTravelInTime
- License: lgpl-2.1
- Created: 2022-02-11T08:39:05.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2022-09-11T23:29:36.000Z (over 2 years ago)
- Last Synced: 2024-10-25T05:53:29.082Z (2 months ago)
- Topics: iokit, ioregistryexplorer, macos, swift
- Language: Swift
- Homepage:
- Size: 131 KB
- Stars: 5
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# TINUIORegistry
A Swift library to access information from the IORegistry in a Swift-friendly easy-to-use way.
## Features and usage
**Reading the NVRAM:**
This feature allows you to access the system NVRAM to gather values, here is an exmaple:
(WARNING: This feature might not work with sandboxed apps)
```swift
import TINUIORegistry
let boot_args = TINUIORegistry.IONVRAM.getString("boot-args") ?? "[Fail]"
print(boot_args)
```
**Getting a list of disks and partitions with some info:**
This feature allows you to get a list of disks and patitions taken from the IORegistry.
This example lists all the BSD names of available disks and partitions:
```swift
import TINUIORegistry
let list = TINUIORegistry.IODeviceTreeDisk.simpleList()
for item in list{
print(item.DeviceIdentifier.rawValue)
}
```
**Iterating trought the IORegistry entries:**
This feature allows for recursive iteration trought the IORegistry tree structure entry by entry.
In this example it's used to find the RTC entry (for an intel mac) and then prints it's property table:
```swift
import TINUIORegistry
let iterator = IORecursiveIterator(plane: .service) // creates an iterator object
while iterator.next(){ //executes the iterations
guard let entry = iterator.entry else{ //Tries to get the current registry entry pointed by the iterator.
continue
}
guard let name = entry.getName() else{ //Gets the name of the obtained entry
continue
}
//print(name)
if name != "TMR" && name != "RTC" && name != "RTC0" && name != "RTC1"{ //checks if the entry name is that of the RTC device
continue
}
//gets and prints the property table of the entry
for i in entry.getRawPropertyTable() ?? [:]{
print(i)
}
break //exits from the loop
}
```
**Using specific IORegistry entries:**
It's possible to interact with registry entries by initializing a new `IOEntry` object from a string containing a IORegistry entry's path.
Here is an example in which an `IOEntry` object is initialised using the registry path to the system nvram and then the "boot-arg" value is retrived from it:
```swift
import TINUIORegistry
let nvram = IOEntry(fromRegistryPath: "IODeviceTree:/options", plane: .service)
let boot_args = nvram?.getString("boot-args") ?? "[Fail]"
print(boot_args)
```
## Who should use this Library?
This library should be used by swift apps/programs for macOS that needs to retrive information from the IORegistry.
This code is intended for macOS only since it requires the system library 'IOKit'.
## About the project
This code was created for of my [TINU project](https://github.com/ITzTravelInTime/TINU) and it has been made into it's own library to make the main project's source less complex and more focused on it's aim.
Also having this as it's own library allows for code to be updated separately and so various versions of the main TINU app will be able to be compiled all with the latest version of this library.
## Libraries used:
- [ITzTravelInTime/SwiftPackagesBase](https://github.com/ITzTravelInTime/SwiftPackagesBase) - Created, developed and maintained by ITzTravelInTime
## Credits
- ITzTravelInTime (Pietro Caruso) - Project creator and main developer
## Contacts
- ITzTravelInTime (Pietro Caruso): [email protected]
## Legal info
TINUNotifications: A Swift library to access information from the IORegistry in a Swift-friendly easy-to-use way.
Copyright (C) 2022 Pietro Caruso
This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version.
This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public License along with this library; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA