Skip to content

Use Go functionality to provide Podman bindings in C, C++ and other languages (via C shared lib)

License

Notifications You must be signed in to change notification settings

jmguzik/podman-bindings-c

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Podman Go bindings exported to C

Sample Application for Podman Go Bindings via C shared library

This directory contains a sample application to run Podman operations in external applications via a set of Go bindings which are later exported as C shared library. Due to a limitation of such export, wrappers are needed around original Go bindings.

There's a single Go file, which uses the Podman Go bindings to provide interface to execute following steps from C application:

  1. Pull Image
  2. List Images
  3. Start Container
  4. List Containers
  5. Inspect Container
  6. Stop Container

There is example main.c which demonstrates the usage of above operations.

Running the application

  1. Clone the repo and enter to the directory.

  2. Ensure podman.socket is activated

$ systemctl --user start podman.socket
  1. Start service (here using podman command)
$ podman system service -t 0
  1. Build go wrapper library (this step will generate C header file as well)
$ go build -buildmode=c-shared -o libpodc.so libpodc.go
  1. Build example C application
$ gcc -O2 -L. -Wl,-rpath=. -Wall -o main main.c -lpodc
  1. Run it
$ ./main
Trying to pull registry.fedoraproject.org/fedora-minimal:latest...
Getting image source signatures
Copying blob sha256:2fa61fedb54d576e17d9129a27fbd3c1ff8503b1e0c45622ba8de6a51fb6a9ef
Copying config sha256:fa011f8784baff6b77fc56152b5024c368809c0f4c6b1279dbd9b173f534028a
Writing manifest to image destination
Storing signatures
Listing images...
[k8s.gcr.io/pause:3.2 docker.io/jess/chromium:latest registry.fedoraproject.org/fedora:latest docker.io/library/busybox:latest registry.fedoraproject.org/fedora-minimal:latest]
INFO[0002] Going to start container "a6171bb2da55377d58e0bd05e1469a9a1f4ab83e406050c0521e23f40c5a8518" 
Status of the container with imgName: registry.fedoraproject.org/fedora-minimal:latest is: running

Additional info

  1. Go wrapper library is based on demo application: https://github.com/containers/Demos/tree/master/podman_go_bindings
  2. For go troubleshooting refer to: https://podman.io/blogs/2020/08/10/podman-go-bindings.html

About

Use Go functionality to provide Podman bindings in C, C++ and other languages (via C shared lib)

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published