Merge pull request #10 from qtc-de/dev

Formatting changes

Author: qtc-de

CHANGELOG.md

@@ -6,7 +6,7 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 
-## v1.3.0 - Apr 07, 2025
+## v1.3.0 - Apr 08, 2025
 
 ### Added
 

README.md

@@ -1,5 +1,5 @@
 <div align="center">
-  <img src="https://github.com/qtc-de/rpv/assets/49147108/89c49bf5-6f97-455e-b9e1-b38b27e58658"/>
+  <img src="https://github.com/user-attachments/assets/be814b15-8485-412e-a3a5-fa0989865bd7"/>
 </div>
 <br/>
 

alternate/default-x64.v

@@ -84,7 +84,8 @@ pub const compatible_rpc_versions = [
 // available in future. Up to this point, we need to keep the x64 and x86
 // struct definitions in separate files.
 @[if x64]
-pub struct RpcInterface {
+pub struct RpcInterface
+{
 pub:
 	p_rpc_server                  &RpcServer = unsafe { nil }
 	flags                         u32
@@ -125,7 +126,8 @@ pub:
 // available in future. Up to this point, we need to keep the x64 and x86
 // struct definitions in separate files.
 @[if x64]
-pub struct RpcServer {
+pub struct RpcServer
+{
 pub:
 	mutex                   Mutex
 	is_listening1           u32
@@ -169,7 +171,8 @@ pub:
 // available in future. Up to this point, we need to keep the x64 and x86
 // struct definitions in separate files.
 @[if x64]
-pub struct RpcAddress {
+pub struct RpcAddress
+{
 pub:
 	vtable       voidptr
 	magic        u32

alternate/default-x86.v

@@ -84,7 +84,8 @@ pub const compatible_rpc_versions = [
 // available in future. Up to this point, we need to keep the x64 and x86
 // struct definitions in separate files.
 @[if x86]
-pub struct RpcInterface {
+pub struct RpcInterface
+{
 pub:
 	p_rpc_server                  &RpcServer = unsafe { nil }
 	flags                         u32
@@ -121,7 +122,8 @@ pub:
 // available in future. Up to this point, we need to keep the x64 and x86
 // struct definitions in separate files.
 @[if x86]
-pub struct RpcServer {
+pub struct RpcServer
+{
 pub:
 	mutex                   Mutex
 	is_listening1           int
@@ -160,7 +162,8 @@ pub:
 // available in future. Up to this point, we need to keep the x64 and x86
 // struct definitions in separate files.
 @[if x86]
-pub struct RpcAddress {
+pub struct RpcAddress
+{
 pub:
 	vtable       voidptr
 	magic        u32

examples/list.v

@@ -2,10 +2,8 @@ module main
 
 import qtc_de.rpv
 
-/*
- * This example attempts to list all running processes that
- * expose RPC endpoints.
- */
+// This example attempts to list all running processes that
+// expose RPC endpoints.
 
 fn main()
 {

internals/rpc-common.v

@@ -12,14 +12,16 @@ type RpcCallbackFunction = fn (intf_handle voidptr, context voidptr) RPC_STATUS
 
 // ListEntry represents one node in a list with a forward and a backward pointer.
 // It is used within RtlCriticalSectionDebug and the RpcServer struct.
-pub struct ListEntry {
+pub struct ListEntry
+{
 	f_link &ListEntry = unsafe { nil }
 	b_link &ListEntry = unsafe { nil }
 }
 
 // RtlCriticalSectionDebug is a mutex related structure. It is not really used by rpv
 // but needs to be defined as it is part of other RpcStructures.
-pub struct RtlCriticalSectionDebug {
+pub struct RtlCriticalSectionDebug
+{
 	section_type                  u16
 	creator_back_trace_index      u16
 	critical_section              &RtlCriticalSection = unsafe { nil }
@@ -33,7 +35,8 @@ pub struct RtlCriticalSectionDebug {
 
 // RtlCriticalSection is a mutex related structure. It is not really used by rpv
 // but needs to be defined as it is part of other RpcStructures.
-pub struct RtlCriticalSection {
+pub struct RtlCriticalSection
+{
 	debug_info      &RtlCriticalSectionDebug = unsafe { nil }
 	lock_count      u32
 	recursion_count u32
@@ -45,15 +48,17 @@ pub struct RtlCriticalSection {
 // Mutex is a synchronization struct to signal ownership of a thread on a
 // critical section. It is not really used by rpv but needs to be defined
 // as it is part of other RpcStructures.
-pub struct Mutex {
+pub struct Mutex
+{
 	critical_section RtlCriticalSection
 }
 
 // SimpleDict represents a simple dictionary struct. Actually, it feels more
 // like an array than a dictionary, as contained elements are simply references
 // by the p_array (pointer array) member. Internal RPC structs use this struct
 // to reference to different elements like e.g. their interfaces.
-pub struct SimpleDict {
+pub struct SimpleDict
+{
 pub:
 	p_array           &voidptr = unsafe { nil }
 	array_size        u32
@@ -63,15 +68,17 @@ pub:
 
 // RpcProtSeqEndpoint is an internal RPC structure. It is not really used
 // by rpv but needs to be defined as it is part of other RpcStructures.
-pub struct RpcProtSeqEndpoint {
+pub struct RpcProtSeqEndpoint
+{
 	rpc_protocol_sequence &char = unsafe { nil }
 	endpoint              &char = unsafe { nil }
 }
 
 // RpcServerInterface is an internal RPC structure that stores interface related
 // information. It is contained within the RpcInterface struct and provides
 // information such as the interface id, it's transfer syntax and RPC flags.
-pub struct RpcServerInterface {
+pub struct RpcServerInterface
+{
 pub:
 	length             u32
 	interface_id       C.RPC_IF_ID
@@ -87,7 +94,8 @@ pub:
 // C.RPC_IF_ID represents an ID of an RPC interface. This is basically an GUID
 // but also contains a major and minor version.
 @[typedef]
-pub struct C.RPC_IF_ID {
+pub struct C.RPC_IF_ID
+{
 	Uuid      C.GUID
 	VersMajor u16
 	VersMinor u16
@@ -104,7 +112,8 @@ pub fn (this C.RPC_IF_ID) equals(other C.RPC_IF_ID) bool
 // RPC interface. rpv uses it to determine the method count, that can be obtained
 // from the DispatchTableCount property.
 @[typedef]
-pub struct C.RPC_DISPATCH_TABLE {
+pub struct C.RPC_DISPATCH_TABLE
+{
 	DispatchTableCount u32
 	DispatchTable      voidptr
 	Reserved           isize
@@ -117,15 +126,16 @@ pub struct C.RPC_DISPATCH_TABLE {
 // property, which contains the offset of the different methods within the ProcString,
 // to decompile RPC methods.
 @[typedef]
-pub struct C.MIDL_SERVER_INFO {
+pub struct C.MIDL_SERVER_INFO
+{
 	pStubDesc       &C.MIDL_STUB_DESC = unsafe { nil }
-	DispatchTable   &voidptr     = unsafe { nil }
-	ProcString      &char        = unsafe { nil }
-	FmtStringOffset &u16         = unsafe { nil }
-	ThunkTable      &voidptr     = unsafe { nil }
-	pTransferSyntax &C.RPC_IF_ID = unsafe { nil }
-	nCount          &u32    = unsafe { nil }
-	pSyntaxInfo     voidptr = unsafe { nil }
+	DispatchTable   &voidptr          = unsafe { nil }
+	ProcString      &char             = unsafe { nil }
+	FmtStringOffset &u16              = unsafe { nil }
+	ThunkTable      &voidptr          = unsafe { nil }
+	pTransferSyntax &C.RPC_IF_ID      = unsafe { nil }
+	nCount          &u32              = unsafe { nil }
+	pSyntaxInfo     voidptr           = unsafe { nil }
 }
 
 // C.MIDL_STUB_DESC contains information about an RPC stub. For rpv, mainly the pFormatTypes
@@ -134,7 +144,8 @@ pub struct C.MIDL_SERVER_INFO {
 // RPC methods. Moreover, Reserved5 is required for parsing NDR expressions. Actually the
 // member is named pExprInfo by Microsoft, but within the mingw libraries it is Reserved5.
 @[typedef]
-pub struct C.MIDL_STUB_DESC {
+pub struct C.MIDL_STUB_DESC
+{
 	RpcInterfaceInformation     voidptr = unsafe { nil }
 	pfnAllocate                 voidptr = unsafe { nil }
 	pfnFree                     voidptr = unsafe { nil }
@@ -146,35 +157,36 @@ pub struct C.MIDL_STUB_DESC {
 	pFormatTypes                &char   = unsafe { nil } // mIDA: type_raw
 	fCheckBounds                int
 	// Ndr library version.
-	Version           u32
-	pMallocFreeStruct voidptr = unsafe { nil }
-	MIDLVersion       u32
-	CommFaultOffsets  &C.COMM_FAULT_OFFSETS = unsafe { nil }
+	Version                     u32
+	pMallocFreeStruct           voidptr = unsafe { nil }
+	MIDLVersion                 u32
+	CommFaultOffsets            &C.COMM_FAULT_OFFSETS = unsafe { nil }
 	// New fields for version 3.0+
-	aUserMarshalQuadruple voidptr = unsafe { nil }
+	aUserMarshalQuadruple       voidptr               = unsafe { nil }
 	// Notify routines - added for NT5, MIDL 5.0
-	NotifyRoutineTable voidptr = unsafe { nil }
+	NotifyRoutineTable          voidptr               = unsafe { nil }
 	// Reserved for future use.
-	mFlags &u32 = unsafe { nil }
+	mFlags                      &u32                  = unsafe { nil }
 	// International support routines - added for 64bit post NT5
-	CsRoutineTables voidptr = unsafe { nil }
-	Reserved4       voidptr = unsafe { nil }
-	Reserved5       voidptr = unsafe { nil } // mIDA: expr_table - RpcView: pExprInfo
-	// Fields up to now present in win2000 release.
+	CsRoutineTables             voidptr               = unsafe { nil }
+	Reserved4                   voidptr               = unsafe { nil }
+	Reserved5                   voidptr               = unsafe { nil } // mIDA: expr_table - RpcView: pExprInfo
 }
 
 // NDR_EXPR_DESC is the struct that is pointed to by C.MIDL_STUB_DESC.Reserved5, alias
 // pExprInfo. It is used by rpv to parse NDR expressions. 
-pub struct NDR_EXPR_DESC {
-	pub:
-	p_offset voidptr
+pub struct NDR_EXPR_DESC
+{
+pub:
+	p_offset      voidptr
 	p_format_expr voidptr
 }
 
 // C.MIDL_SYNTAX_INFO is a struct that is used within internal RPC struct definitions.
 // It is currently not used by rpv.
 @[typedef]
-pub struct C.MIDL_SYNTAX_INFO {
+pub struct C.MIDL_SYNTAX_INFO
+{
 	TransferSyntax        C.RPC_SYNTAX_IDENTIFIER
 	DispatchTable         &C.RPC_DISPATCH_TABLE
 	ProcString            &char
@@ -187,47 +199,53 @@ pub struct C.MIDL_SYNTAX_INFO {
 // C.MIDL_INTERFACE_METHOD_PROPERTIES is a struct that is used within internal RPC struct definitions.
 // It is currently not used by rpv.
 @[typedef]
-pub struct C.MIDL_INTERFACE_METHOD_PROPERTIES {
+pub struct C.MIDL_INTERFACE_METHOD_PROPERTIES
+{
 	MethodCount      u16
 	MethodProperties &C.MIDL_METHOD_PROPERTY_MAP
 }
 
 // C.MIDL_METHOD_PROPERTY_MAP is a struct that is used within internal RPC struct definitions.
 // It is currently not used by rpv.
 @[typedef]
-pub struct C.MIDL_METHOD_PROPERTY_MAP {
+pub struct C.MIDL_METHOD_PROPERTY_MAP
+{
 	count      u32
 	Properties &C.MIDL_METHOD_PROPERTY
 }
 
 // C.MIDL_METHOD_PROPERTY is a struct that is used within internal RPC struct definitions.
 // It is currently not used by rpv.
 @[typedef]
-pub struct C.MIDL_METHOD_PROPERTY {
+pub struct C.MIDL_METHOD_PROPERTY
+{
 	Id    u32
 	value usize
 }
 
 // C.UUID_VECTOR is a struct that is used within internal RPC struct definitions.
 // It is currently not used by rpv.
 @[typedef]
-pub struct C.UUID_VECTOR {
+pub struct C.UUID_VECTOR
+{
 	Count u32
 	Uuid  [1]&C.GUID
 }
 
 // C.RPC_SYNTAX_IDENTIFIER is a struct that is used within internal RPC struct definitions.
 // It is currently not used by rpv.
 @[typedef]
-pub struct C.RPC_SYNTAX_IDENTIFIER {
+pub struct C.RPC_SYNTAX_IDENTIFIER
+{
 	SyntaxGUID    C.GUID
 	SyntaxVersion C.RPC_VERSION
 }
 
 // C.RPC_VERSION is a struct that is used within internal RPC struct definitions.
 // It is currently not used by rpv.
 @[typedef]
-pub struct C.RPC_VERSION {
+pub struct C.RPC_VERSION
+{
 	MajorVersion u16
 	MinorVersion u16
 }
@@ -236,7 +254,8 @@ pub struct C.RPC_VERSION {
 // This includes for example the utilized security packages and the associated
 // principal. rpv uses this struct only to parse the information and makes it
 // accessible within the RpcAuthInfo struct.
-pub struct RPC_AUTH_INFO {
+pub struct RPC_AUTH_INFO
+{
 pub:
 	principal  &u16 = unsafe { nil }
 	auth_svc   u32
@@ -246,17 +265,20 @@ pub:
 
 pub const max_simple_dict_entries = 0x200
 pub const iid_iunknown = win.new_guid('00000000-0000-0000-C000-000000000046') or { panic(err) }
-pub const dce_transfer_syntax = C.RPC_IF_ID{
+pub const dce_transfer_syntax = C.RPC_IF_ID
+{
 	Uuid:      win.new_guid('8A885D04-1CEB-11C9-9FE8-08002B104860') or { panic(err) }
 	VersMajor: 2
 	VersMinor: 0
 }
-pub const ndr64_transfer_syntax = C.RPC_IF_ID{
+pub const ndr64_transfer_syntax = C.RPC_IF_ID
+{
 	Uuid:      win.new_guid('71710533-BEBA-4937-8319-B5DBEF9CCC36') or { panic(err) }
 	VersMajor: 2
 	VersMinor: 0
 }
-pub const ior_callback = C.RPC_IF_ID{
+pub const ior_callback = C.RPC_IF_ID
+{
 	Uuid:      win.new_guid('18f70770-8e64-11cf-9af1-0020AF6E72F4') or { panic(err) }
 	VersMajor: 0
 	VersMinor: 0

internals/rpc-internal-structs.v

@@ -83,7 +83,8 @@ pub const compatible_rpc_versions = [
 // available in future. Up to this point, we need to keep the x64 and x86
 // struct definitions in separate files.
 @[if x64]
-pub struct RpcInterface {
+pub struct RpcInterface
+{
 pub:
 	p_rpc_server                  &RpcServer = unsafe { nil }
 	flags                         u32
@@ -124,7 +125,8 @@ pub:
 // available in future. Up to this point, we need to keep the x64 and x86
 // struct definitions in separate files.
 @[if x64]
-pub struct RpcServer {
+pub struct RpcServer
+{
 pub:
 	mutex                   Mutex
 	is_listening1           u32
@@ -168,7 +170,8 @@ pub:
 // available in future. Up to this point, we need to keep the x64 and x86
 // struct definitions in separate files.
 @[if x64]
-pub struct RpcAddress {
+pub struct RpcAddress
+{
 pub:
 	vtable       voidptr
 	magic        u32