{ "info": { "author": "peo3", "author_email": "peo314159265@gmail.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Environment :: Console", "Intended Audience :: System Administrators", "License :: OSI Approved :: GNU General Public License v2 (GPLv2)", "Operating System :: POSIX :: Linux", "Programming Language :: C", "Programming Language :: Python", "Topic :: System :: Operating System Kernels :: Linux", "Topic :: System :: Systems Administration", "Topic :: Utilities" ], "description": "What is cgroup-utils?\n=====================\n\ncgroup-utils provides utility tools and libraries for control groups of\nLinux. For example, cgutil top is a top-like tool which shows activities\nof running processes in control groups.\n\nInstallation\n============\n\nFor users\n---------\n\n::\n\n $ sudo pip install cgroup-utils\n\nFor developers\n--------------\n\n::\n\n $ git clone git://github.com/peo3/cgroup-utils.git\n $ cd cgroup-utils\n $ python setup.py build\n $ sudo python setup.py install\n\nPackaging (rpm)\n~~~~~~~~~~~~~~~\n\n::\n\n $ python setup.py bdist --formats=rpm\n\nAvailable commands\n==================\n\n- configs\n- event\n- mkdir\n- pgrep\n- rmdir\n- stats\n- top\n- tree\n\ncgutil configs\n--------------\n\nThis command show you configurations of cgroups. By default, it shows\nonly changed configurations.\n\nExample output\n~~~~~~~~~~~~~~\n\n::\n\n $ cgutil configs -o memory\n \n notify_on_release=1\n release_agent=/usr/lib/ulatencyd/ulatencyd_cleanup.lua\n sys_essential\n swappiness=0\n notify_on_release=1\n sys_bg\n swappiness=100\n notify_on_release=1\n\ncgutil event\n------------\n\nThis command makes cgroup.event_control easy to use. It exits when a\nstate of a target cgroup crosses a threshold which you set, thus, you\ncan know the state of the cgroup has changed.\n\n.. _example-output-1:\n\nExample output\n~~~~~~~~~~~~~~\n\n::\n\n $ cgutil event /sys/fs/cgroup/memory/system/sshd.service/memory.usage_in_bytes +1M\n $ # It exits when memory usage of processes in the cgroup has increased one more MB.\n\ncgutil pgrep\n------------\n\nThis command is alike ``pgrep`` command but it shows cgroups in addtion\nto PIDs.\n\n.. _example-output-2:\n\nExample output\n~~~~~~~~~~~~~~\n\n::\n\n $ cgutil pgrep ssh\n /: 15072\n /: 15074\n /system/sshd.service: 630\n $ cgutil pgrep ssh -l -f\n /: 15072 sshd: ozaki-r [priv]\n /: 15074 sshd: ozaki-r@pts/2\n /: 15157 /bin/python /bin/cgutil pgrep ssh -l -f\n /system/sshd.service: 630 /usr/sbin/sshd -D\n\ncgutil stats\n------------\n\nThis command shows you states of cgroups.\n\n.. _example-output-3:\n\nExample output\n~~~~~~~~~~~~~~\n\n::\n\n $ cgutil stats\n \n stat={'throttled_time': 0L, 'nr_periods': 0L, 'nr_throttled': 0L}\n system \n stat={'throttled_time': 0L, 'nr_periods': 0L, 'nr_throttled': 0L}\n system/sm-client.service\n stat={'throttled_time': 0L, 'nr_periods': 0L, 'nr_throttled': 0L}\n system/sendmail.service\n stat={'throttled_time': 0L, 'nr_periods': 0L, 'nr_throttled': 0L}\n system/vboxadd-service.service\n stat={'throttled_time': 0L, 'nr_periods': 0L, 'nr_throttled': 0L}\n system/colord.service\n stat={'throttled_time': 0L, 'nr_periods': 0L, 'nr_throttled': 0L}\n system/colord-sane.service\n stat={'throttled_time': 0L, 'nr_periods': 0L, 'nr_throttled': 0L}\n system/udisks2.service\n stat={'throttled_time': 0L, 'nr_periods': 0L, 'nr_throttled': 0L}\n system/cups.service\n stat={'throttled_time': 0L, 'nr_periods': 0L, 'nr_throttled': 0L}\n\ncgutil top\n----------\n\nThis command is alike ``top`` command but it shows activities in a unit\nof cgroups.\n\n.. _example-output-4:\n\nExample output\n~~~~~~~~~~~~~~\n\n::\n\n $ cgutil top -i -n 2 -b\n 18.1 msec to collect statistics\n [ CPUACCT ] [ BLKIO ] [ MEMORY ]\n USR SYS READ WRITE TOTAL RSS SWAP # NAME\n 0.0% 0.0% 0.0 /s 0.0 /s 0.0 48.0k 0.0 97 usr_1000/default\n 20.5 msec to collect statistics\n [ CPUACCT ] [ BLKIO ] [ MEMORY ]\n USR SYS READ WRITE TOTAL RSS SWAP # NAME\n 0.0% 0.0% 0.0 /s 0.0 /s 128.0k 4.0k 0.0 104 sys_daemon\n 0.0% 0.0% 0.0 /s 0.0 /s -64.0k 0.0 0.0 0 sys_essential\n 0.0% 0.0% 0.0 /s 0.0 /s 108.0k 32.0k 0.0 97 usr_1000/default\n\ncgutil tree\n-----------\n\nThis command shows you tree structure of cgroups.\n\nExample outputs\n~~~~~~~~~~~~~~~\n\n::\n\n $ cgutil tree -o blkio\n \n `system\n +sm-client.service\n +sendmail.service\n +vboxadd-service.service\n +colord.service\n +colord-sane.service\n +udisks2.service\n +cups.service\n +rtkit-daemon.service\n\n (snip)\n\n +fsck@.service\n +udev.service\n `systemd-journald.service\n\nSupported Linux Version\n=======================\n\n4.20.y\n\nSupported subsystems\n--------------------\n\n- blkio (and its debug feature)\n- cpuset\n- cpu and cpuacct\n- devices\n- freezer\n- hugetlb\n- memory\n- net_cls\n- net_prio\n- pids\n- rdma\n\nSupported Python\n================\n\n- python2: 2.6 and above\n\n - deprecated\n\n- python3: 3.4 and above\n\n - 3.0 to 3.3 may work but not tested\n\nLicense\n=======\n\nThe tools are distributed under GPLv2. See COPYING for more detail.\n\nChangelog\n=========\n\n0.7\n---\n\n- Support PID and RDMA subsystems\n- Support new control files\n- Mark python2 deprecated\n\n.. _section-1:\n\n0.6\n---\n\n- Support new control files added between Linux 3.9 and 3.18\n- Support Python 3\n- Drop Python 2.5 support\n- Fix several bugs. Thanks lebauce and pavel-odintsov!\n\n.. _section-2:\n\n0.5\n---\n\n- Support hugetlb subsystem\n- Support additional cgroup files of blkio, memory and freezer\n- Use argparse instead of optparse\n- Fix several bugs. Thanks novas0x2a and unicell!\n\n.. _section-3:\n\n0.4\n---\n\n- Add unit tests for control file parsers and a test for PEP8\n compliance\n- Support dynamic cgroups hierarchy update for top command\n- Support missing net_prio subsystem\n- Complete event_control supports in event command\n- Implement mkdir/rmdir commands\n- Fix a bunch of bugs", "description_content_type": "", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/peo3/cgroup-utils", "keywords": "", "license": "GPLv2", "maintainer": "", "maintainer_email": "", "name": "cgroup-utils", "package_url": "https://pypi.org/project/cgroup-utils/", "platform": "", "project_url": "https://pypi.org/project/cgroup-utils/", "project_urls": { "Homepage": "https://github.com/peo3/cgroup-utils" }, "release_url": "https://pypi.org/project/cgroup-utils/0.7/", "requires_dist": null, "requires_python": "", "summary": "Utility tools for control groups of Linux", "version": "0.7" }, "last_serial": 5052230, "releases": { "0.3": [ { "comment_text": "", "digests": { "md5": "a370f6abc1462423f56e199ce168c958", "sha256": "89dfb34bdd446ca4cc15a4d749e4f6ee2761dde4148a5c460c5aab909aa59c2e" }, "downloads": -1, "filename": "cgroup-utils-0.3.tar.gz", "has_sig": false, "md5_digest": "a370f6abc1462423f56e199ce168c958", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 18411, "upload_time": "2012-07-28T22:44:19", "url": "https://files.pythonhosted.org/packages/87/3b/d4d20e929e005684cab16ad1750ecaf41ae1e94dc0c00229385011d21cb2/cgroup-utils-0.3.tar.gz" } ], "0.4": [ { "comment_text": "", "digests": { "md5": "a22d3040e336728e6f014d8c92eec9c1", "sha256": "3d6bfbf46eb2b3593bda22da1f3081413c7a8f161b0f2c4657101471575c8ca1" }, "downloads": -1, "filename": "cgroup-utils-0.4.tar.gz", "has_sig": false, "md5_digest": "a22d3040e336728e6f014d8c92eec9c1", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 23217, "upload_time": "2012-08-25T11:50:34", "url": "https://files.pythonhosted.org/packages/50/52/0b706b847b8c9b9d72591a81148f7a999d6b270193169431539cf6d4ebc8/cgroup-utils-0.4.tar.gz" } ], "0.5": [ { "comment_text": "", "digests": { "md5": "54260e20711fdda8ae00c0938e22c647", "sha256": "f70a24e54da9cd58697c877b0b29297dba2502436101033fe200a65312884d2f" }, "downloads": -1, "filename": "cgroup-utils-0.5.tar.gz", "has_sig": false, "md5_digest": "54260e20711fdda8ae00c0938e22c647", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 22633, "upload_time": "2013-02-24T15:53:19", "url": "https://files.pythonhosted.org/packages/62/12/faeeacebd30bf8b81c8013581ebc8647594cb355cfb58be9642d3b8160b8/cgroup-utils-0.5.tar.gz" } ], "0.6": [ { "comment_text": "", "digests": { "md5": "f3aef725e959d705d49a3d3c87409265", "sha256": "4f465150084d571beedf6dd1070af3b751cce8b0ce98207db202c58d3559f515" }, "downloads": -1, "filename": "cgroup-utils-0.6.tar.gz", "has_sig": false, "md5_digest": "f3aef725e959d705d49a3d3c87409265", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 23927, "upload_time": "2019-04-02T15:00:30", "url": "https://files.pythonhosted.org/packages/64/9a/4ab281dd38508e546866c0b4fbcfc2b82e464d9bf53b887253586cfe0c33/cgroup-utils-0.6.tar.gz" } ], "0.7": [ { "comment_text": "", "digests": { "md5": "0b8a4e929f3e2474be175e13ffa32d4a", "sha256": "f3e2442738906b89714a66aaceba88720cc161626bef552bce4ae77808f000f5" }, "downloads": -1, "filename": "cgroup-utils-0.7.tar.gz", "has_sig": false, "md5_digest": "0b8a4e929f3e2474be175e13ffa32d4a", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 24286, "upload_time": "2019-04-02T15:00:31", "url": "https://files.pythonhosted.org/packages/a7/60/0b1772e959096cfde48ddff0ead21286dd5ea38777dc3327fbf4b9e72f11/cgroup-utils-0.7.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "0b8a4e929f3e2474be175e13ffa32d4a", "sha256": "f3e2442738906b89714a66aaceba88720cc161626bef552bce4ae77808f000f5" }, "downloads": -1, "filename": "cgroup-utils-0.7.tar.gz", "has_sig": false, "md5_digest": "0b8a4e929f3e2474be175e13ffa32d4a", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 24286, "upload_time": "2019-04-02T15:00:31", "url": "https://files.pythonhosted.org/packages/a7/60/0b1772e959096cfde48ddff0ead21286dd5ea38777dc3327fbf4b9e72f11/cgroup-utils-0.7.tar.gz" } ] }