Skip to content

Commit 762d29f

Browse files
committed
add Cb reference to porting guide
1 parent df5163c commit 762d29f

File tree

1 file changed

+8
-1
lines changed

1 file changed

+8
-1
lines changed

Porting.md

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -71,7 +71,7 @@ The list of entry names for each host is defined in host/entry_{host}.go
7171
under the function host.Names().
7272

7373

74-
# Supporting concepts Devices, Inputs, Outputs, Duplex, Packets
74+
# Supporting concepts Devices, Inputs, Outputs, Duplex, Packets, Cbs
7575
To implement an Entry Point, ZikiChombo provides some support code in
7676
[libsio](http://godoc.org/zikichombo.org/sio/libsio). The only required part
7777
of this code to reference is libsio/Dev to implement an Entry.
@@ -80,6 +80,13 @@ Other parts of this code, libsio.{Input,Output,Duplex,Packet,DuplexPacket}
8080
provide interfaces for synchronising with the host via Go channels and
8181
implementations to adapt these structures to sound.{Source,Sink,Duplex}.
8282

83+
There is also a libsio.Cb, which is a mechanism for interfacing
84+
the blocking calls in sound.{Source,Sink,Duplex} to lower level
85+
callback interfaces in C. Cb is tuned for the case the lower level
86+
C API runs the callback in a different thread, possibly with a different
87+
scheduling priority. see [gddo](http://godoc.org/zikichombo.org/sio/libsio#Cb)
88+
for details.
89+
8390
## Import directions
8491
Package zikichombo.org/sio imports the package implementing entry points
8592
for registration side effects

0 commit comments

Comments
 (0)