{"id":16602748,"url":"https://github.com/bbidulock/wmnetload","last_synced_at":"2025-06-17T17:33:05.341Z","repository":{"id":73515504,"uuid":"56648692","full_name":"bbidulock/wmnetload","owner":"bbidulock","description":"Import of the wmnetload WindowMaker dock app","archived":false,"fork":false,"pushed_at":"2020-08-18T12:01:59.000Z","size":39,"stargazers_count":1,"open_issues_count":1,"forks_count":1,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-01-17T08:45:18.395Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bbidulock.png","metadata":{"files":{"readme":"README","changelog":"ChangeLog","contributing":null,"funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS","dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-04-20T02:28:22.000Z","updated_at":"2022-11-28T09:11:18.000Z","dependencies_parsed_at":"2023-06-01T06:30:38.477Z","dependency_job_id":null,"html_url":"https://github.com/bbidulock/wmnetload","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bbidulock%2Fwmnetload","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bbidulock%2Fwmnetload/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bbidulock%2Fwmnetload/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bbidulock%2Fwmnetload/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bbidulock","download_url":"https://codeload.github.com/bbidulock/wmnetload/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":242692347,"owners_count":20170228,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-12T00:23:35.956Z","updated_at":"2025-03-09T12:55:19.126Z","avatar_url":"https://github.com/bbidulock.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"wmnetload - A dockapp to monitor network interface usage.\n\nCopyright (c) 2002 Peter Memishian \u003cmeem@gnu.org\u003e\n\nOverview\n========\n\nThe wmnetload dockapp is a simple network interface monitoring tool.  It was\nwritten for use under Window Maker, but will likely work under other window\nmanagers such as AfterStep, BlackBox and Enlightenment.\n\nThe dockapp has been designed with the following goals:\n\n\t1. Look-and-feel like Seiichi SATO's kick-ass wmcpuload (see\n\t   \"Configuring the Look\", below, for details).\n\n\t2. Provide useful information.  When monitoring an interface,\n\t   the information I frequently want to know is:\n\n\t\t(a) Is the interface functioning?\n\n\t\t(b) How loaded is the interface?\n\n\t\t(c) What are the recent traffic patterns on the interface,\n\t\t    for both incoming and outgoing traffic?\n\n\t3. Provide information clearly.  To that end, wmnetload:\n\n\t\t(a) Turns the entire digital display area red when an\n\t\t    interface is malfunctioning, so that you're quickly\n\t\t    alerted to the problem.\n\n\t\t(b) Uses a large font for the total network throughput.\n\t\t    It's important; it should be easy to read.  See\n\t\t    \"Understanding wmnetload Statistics\", below, for\n\t\t    help on interpreting throughput.\n\n\t\t(c) Separates incoming and outgoing traffic in the network\n\t\t    traffic graph in a intuitive, simple manner: incoming\n\t\t    traffic is considered to be \"pulled down\" from the\n\t\t    network and thus is shown descending from the top of the\n\t\t    graph, whereas outgoing traffic is considered to be\n\t\t    \"pushed up\" into the network and thus is shown growing\n\t\t    up from the bottom of the graph.\n\n\t\t    This approach may take some getting used to, but once\n\t\t    you do, I hope you'll agree that it's much easier to\n\t\t    read than the traditional multi-color approach, not to\n\t\t    mention easier to remember.\n\nA number of other features you may find useful described below.\n\nIf you have additional suggestions for how to improve wmnetload and still\nmeet the aforementioned goals, don't hesitate to email.\n\nBuilding and Installation\n=========================\n\nThis program uses standard GNU configure; please see the file `INSTALL' for\ngeneric instructions.  \n\nUnfortunately, wmnetload makes use of a couple of libraries that aren't\ninstalled by default on some versions of Unix.  In particular, you'll need\nboth libXpm and libdockapp to compile wmnetload.  If you do not have these\nlibraries one your system, you can grab them from:\n\n\tlibXpm\t\thttp://freshmeat.net/projects/libxpm\n\tlibdockapp\tftp://truffula.com/pub/libdockapp-0.4.tgz\n\nPlease note that if you install these libraries in a location other than\n/usr/lib or /usr/local/lib, you'll need pass the --with-libs-from and\n--with-incs-from options to `configure'.  For instance, if you install these\nlibraries in /usr/shared/i686/lib and the headers in /usr/shared/include,\nthen you'll need to pass `--with-libs-from=/usr/shared/i686/lib\n--with-incs-from=/usr/shared/include' to `configure'.\n\nConfiguring the Look\n====================\n\nSince one of the main goals of wmnetload is to match the look-and-feel of\nwmcpuload, and since the look of wmcpuload was changed as of version 0.9, the\nlook of wmnetload has also been revised.  However, those who prefer the\n\"classic\" wmnetload look (or who are still using older versions of wmcpuload)\ncan compile wmnetload to present the original look by passing\n--with-classic-look to `configure'. \n\nInterface Cycling\n=================\n\nAlthough wmnetload can monitor only a single interface at a time, the\ninterface being monitored can be selected by using mouse buton 3 to cycle\nthrough each of the available interfaces.  Note that with the classic look,\nwmnetload does not display the name of the interface, which makes interface\ncycling hard to use without getting confused.\n\nAlarm Mode\n==========\n\nLike wmcpuload, wmnetload allows you to set an alarm value (in kbits/sec)\nthat causes the display backlight to be turned on whenever it is exceeded.\nThis is chiefly useful for alerting you to unusual or aberrant network\nbehavior.\n\nNetBSD Limitations\n==================\n\nPlease note that wmnetload must execute as a kmem reader on NetBSD in order\nto retrieve interface statistics, which means that it must be run with a real\nor effective gid of `kmem'.  If you attempt to run wmnetload with a gid other\nthan `kmem', it will fail with:\n\n  wmnetload: cannot access raw kernel memory: /dev/mem: Permission denied\n  wmnetload: fatal: cannot initialize interface statistics: Permission denied\n\nNote that wmnetload immediately drops `kmem' privileges at startup and only\nre-acquires them for the duration of the call to kvm_open(), so this should\nnot pose a security risk.  However, since there's an inherent danger\nassociated with setgid applications, wmnetload is never installed as setgid\nby default; you must do this yourself by executing:\n\n\t# chgrp kmem wmnetload\n\t# chmod 2755 wmnetload\n\nSolaris Limitations\n===================\n\nSolaris does not export the kstats wmnetload needs in order to track network\nactivity on the loopback interface.  As a result, attempts to monitor\nthe loopback interface will display \"Err\" on Solaris.\n\nAfterStep Limitations\n=====================\n\nSeveral users have reported issues trying to get wmnetload to be correctly\nswallowed when used under AfterStep.  Investigation has revealed that this\nproblem is due to bugs in libdockapp, not wmnetload.  Unfortunately,\nlibdockapp is currently unmaintained, so it's not really possible to roll\nfixes into it (without taking over as maintainer, a task which I simply do\nnot have time for).  If you feel strongly about this issue, I encourage you\nto work on the core issue, which is getting libdockapp back in active\ndevelopment.\n\nUnderstanding wmnetload Statistics\n==================================\n\nFirst, this probably seems obvious, but wmnetload only provides statistics\non packets *received* by the network card.  This means that if you're on a\ntraditional non-switched Ethernet, and your network interface is not in\npromiscuous mode, wmnetload will be unaware of unicast traffic between other\nnodes on your network. \n\nSecond, depending on your operating system and whether it does accounting\nbefore or after firewalling rules, wmnetload statistics may or may not\ninclude traffic filtered by the firewall.\n\nBy default, all throughput is displayed in either kilobits, megabits, or\ngigabits per second, as appropriate (the corresponding letter will light up\nto indicate the scale).  If you'd prefer your throughput displayed in bytes,\nthen pass the `-b' option to wmnetload.\n\nContributions\n=============\n\nPlease send all bug reports, bug fixes, and enhancements to \u003cmeem@gnu.org\u003e.\nI'm particularly interested in contributions that would lead to additional\ninterface statistics \"backends\" for other POSIX-compliant systems.  Please\nlet me know if you wish to contribute one or provide access to a machine I\ncould use to write one myself.\n\nCopyright\n=========\n\nAll code is under GPL.\n\nFresh Bits\n==========\n\nThe latest version of wmnetload is available from:\n\n\thttp://freshmeat.net/projects/wmnetload\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbbidulock%2Fwmnetload","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbbidulock%2Fwmnetload","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbbidulock%2Fwmnetload/lists"}