Skip to main content
Help improve PyPI by participating in a 5-minute user interface survey!

Enter kernel namespaces from Python

Project Description

Travis CI build status

This Python package allows entering Linux kernel namespaces (mount, IPC, net, PID, user and UTS) by doing the “setns” syscall. The command line interface tries to be similar to the nsenter C program.

Requires Python 2.6 or higher

See the introductory blog post “Entering Kernel Namespaces from Python”.

Install from PyPI:

sudo pip3 install nsenter

Install from git source:

python3 setup.py install

Example command line usage:

docker run -d --name=redis -t redis
sudo nsenter --all --target=`docker inspect --format '{{ .State.Pid }}' redis` /bin/bash

Example usage from Python:

import subprocess
from nsenter import Namespace

with Namespace(mypid, 'net'):
    # output network interfaces as seen from within the mypid's net NS:
    subprocess.check_output(['ip', 'a'])

# or enter an arbitrary namespace:
with Namespace('/var/run/netns/foo', 'net'):
    # output network interfaces as seen from within the net NS "foo":
    subprocess.check_output(['ip', 'a'])

Release history Release notifications

This version
History Node

0.2

History Node

0.1.7

History Node

0.1.6

History Node

0.1.5

History Node

0.1.4-2

History Node

0.1.4-1

History Node

0.1.4

History Node

0.1.3

History Node

0.1.2

History Node

0.1.1

History Node

0.1

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
nsenter-0.2-py3-none-any.whl (12.3 kB) Copy SHA256 hash SHA256 Wheel 3.4 Jan 8, 2016
nsenter-0.2.tar.gz (4.3 kB) Copy SHA256 hash SHA256 Source None Jan 8, 2016

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page