https://github.com/shubham1172/unshare

Python extension for C's unshare call
https://github.com/shubham1172/unshare

Last synced: 3 months ago
JSON representation

Python extension for C's unshare call

• Host: GitHub
• URL: https://github.com/shubham1172/unshare
• Owner: shubham1172
• License: gpl-3.0
• Created: 2019-06-16T17:12:37.000Z (about 6 years ago)
• Default Branch: master
• Last Pushed: 2022-09-13T11:41:14.000Z (almost 3 years ago)
• Last Synced: 2025-03-25T17:21:13.795Z (4 months ago)
• Language: C
• Homepage:
• Size: 17.6 KB
• Stars: 4
• Watchers: 1
• Forks: 2
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# unshare

[![PyPI](https://img.shields.io/pypi/v/unshare.svg?color=green&logo=unshare&style=plastic)](https://pypi.org/project/unshare/)

```bash

pip3 install unshare

```



Python extension for C's unshare call. 


See [man 2 unshare](http://man7.org/linux/man-pages/man2/unshare.2.html).

**Note**: This is targeted for only Linux based platforms.

# Usage

`unshare(flags)` where supported flags are `CLONE_NEWNS`, `CLONE_NEWUTS`, `CLONE_NEWPID`, `CLONE_NEWUSER`, `CLONE_NEWIPC`, `CLONE_NEWNET`, `CLONE_THREAD`. 


Multiple flags can be used using the bitwise or operator.

# Example usage

```python3

import unshare

unshare.unshare(unshare.CLONE_NEWUTS)

```

The following screenshot is taken from [a sample script](https://gist.github.com/shubham1172/7c53130e6e0258f998f331955564dc4c#file-container-py) which uses the unshare library.

![](https://i.imgur.com/B8X0LT8.png)

See [shubham1172/pocket](https://github.com/shubham1172/pocket) for a tiny python container runtime using this library.

# License

This project is licensed under [GPLv3](./LICENSE).