mirror of
git://git.code.sf.net/p/dhcpd-pools/code
synced 2025-12-16 15:57:00 +00:00
README and THANKS files to support git
Signed-off-by: Sami Kerola <kerolasa@iki.fi>
This commit is contained in:
parent
74aef1c34e
commit
eaa3ae9be3
2 changed files with 141 additions and 21 deletions
160
README
160
README
|
|
@ -1,28 +1,148 @@
|
||||||
This is dhcpd-pools which is made for ISC dhcpd pool range
|
This is dhcpd-pools which is made for ISC dhcpd pool range analysis.
|
||||||
analysis.
|
|
||||||
|
|
||||||
With this command you can check usage of pool addresses when
|
== General information
|
||||||
address space is great. Command is designed so that it will not
|
|
||||||
get slow even there is thousands of IPs in lease file. This kind
|
|
||||||
of huge dhcpd installation can be near by DSL DSLAMs or some other
|
|
||||||
public access connection points.
|
|
||||||
|
|
||||||
This command will not print nice to know information like
|
With this command you can check usage of pool addresses when address space
|
||||||
DHCPStatus does. Output is limited only to list only usage for
|
is great. Command is designed so that it will not get slow even there is
|
||||||
ranges, shared network and total address space. Limiting what is
|
thousands of IPs in lease file. This kind of huge dhcpd installation can be
|
||||||
printed is the right thing to do when there is thousands of
|
near by DSL DSLAMs or some other public access connection points.
|
||||||
addresses. If your address space is small some other dhcp
|
|
||||||
analyzer might be more suitable for you.
|
|
||||||
|
|
||||||
Source code is pretty printed by using indent command switches.
|
This command will not print nice to know information like DHCPStatus does.
|
||||||
|
Output is limited only to list only usage for ranges, shared network and
|
||||||
|
total address space. Limiting what is printed is the right thing to do when
|
||||||
|
there is thousands of addresses. If your address space is small some other
|
||||||
|
dhcp analyzer might be more suitable for you.
|
||||||
|
|
||||||
-kr -i8
|
== Instructions for developers
|
||||||
|
|
||||||
If you write a patch please use same coding style. In general the
|
AUTOTOOLS:
|
||||||
style is copy from Linux kernel.
|
|
||||||
|
|
||||||
http://git.kernel.org/?p=linux/kernel/git/torvalds/linux-2.6.git;a=blob_plain;f=Documentation/CodingStyle;hb=HEAD
|
* "./autogen.sh" generates all files needed to compile and install the
|
||||||
|
code (run it after checkout from git)
|
||||||
|
|
||||||
A dhcpd-pools home page is located at SourceForge.
|
* "make distclean" removes all unnecessary files, but the code can
|
||||||
|
still be recompiled with "./configure; make"
|
||||||
|
|
||||||
http://dhcpd-pools.sourceforge.net/
|
PATCHES:
|
||||||
|
|
||||||
|
* First get familiar with git. In case you are completely lost watch
|
||||||
|
Greg Kroah-Hartman explaining the very basics.
|
||||||
|
http://archive.fosdem.org/2010/schedule/events/linuxkernelpatch
|
||||||
|
|
||||||
|
* Get up to date version of the code base.
|
||||||
|
|
||||||
|
$ git clone git://dhcpd-pools.git.sourceforge.net/gitroot/dhcpd-pools/dhcpd-pools
|
||||||
|
|
||||||
|
* Don't include generated (autotools) stuff to your patches (hint: use
|
||||||
|
git-clean [-X])
|
||||||
|
|
||||||
|
* Add a Signed-off-by line, use "git commit -s"
|
||||||
|
|
||||||
|
* Patches are delivered via email only. The following commands will do
|
||||||
|
the correct thing.
|
||||||
|
|
||||||
|
$ git format-patch -C origin/master..yourbranch -o ~/patches
|
||||||
|
|
||||||
|
When you send only one patch use the following.
|
||||||
|
|
||||||
|
$ git send-email --to kerolasa@iki.fi 0001*
|
||||||
|
|
||||||
|
The command above expects you have configured email sending properly.
|
||||||
|
See git.wiki for help.
|
||||||
|
https://git.wiki.kernel.org/index.php/GitTips#Mail
|
||||||
|
|
||||||
|
* One patch per email, with the changelog in the body of the email.
|
||||||
|
|
||||||
|
* When you send series of pathes include introductory message.
|
||||||
|
|
||||||
|
$ git send-email --compose --to kerolasa@iki.fi ~/00*
|
||||||
|
|
||||||
|
Good introductory message will have at least
|
||||||
|
|
||||||
|
-- snip
|
||||||
|
Your Name (3):
|
||||||
|
firstfile.c: short description
|
||||||
|
secondfile.c: another description
|
||||||
|
|
||||||
|
firstfile.c | 2 +-
|
||||||
|
secondfile.c | 2 +-
|
||||||
|
secondfile.c | 2 +-
|
||||||
|
2 files changed, 3 insertions(+), 3 deletions(-)
|
||||||
|
-- snip
|
||||||
|
|
||||||
|
Above introductory can be generated with git.
|
||||||
|
|
||||||
|
$ git shortlog master..yourbranch
|
||||||
|
$ git diff --stat master..yourbranch
|
||||||
|
|
||||||
|
* Subject: [PATCH] subsystem: description. Following ~/.gitconfig will
|
||||||
|
help you a little.
|
||||||
|
|
||||||
|
-- snip
|
||||||
|
[user]
|
||||||
|
name = Your Name
|
||||||
|
email = your.name@example.com
|
||||||
|
|
||||||
|
[format]
|
||||||
|
subjectprefix = PATCH
|
||||||
|
numbered = auto
|
||||||
|
signoff = yes
|
||||||
|
|
||||||
|
[sendemail]
|
||||||
|
chainreplyto = false
|
||||||
|
cc = your.name@example.com
|
||||||
|
-- snip
|
||||||
|
|
||||||
|
* If someone else wrote the patch, they should be credited (and blamed)
|
||||||
|
for it. To communicate this, add a line:
|
||||||
|
|
||||||
|
From: John Doe <jdoe@wherever.com>
|
||||||
|
|
||||||
|
The sign-off is a simple line at the end of the explanation for the
|
||||||
|
patch, which certifies that you wrote it or otherwise have the right
|
||||||
|
to pass it on as a open-source patch. The rules are pretty simple: if
|
||||||
|
you can certify the below:
|
||||||
|
|
||||||
|
By making a contribution to this project, I certify that:
|
||||||
|
|
||||||
|
(a) The contribution was created in whole or in part by me and I
|
||||||
|
have the right to submit it under the open source license
|
||||||
|
indicated in the file; or
|
||||||
|
|
||||||
|
(b) The contribution is based upon previous work that, to the
|
||||||
|
best of my knowledge, is covered under an appropriate open
|
||||||
|
source license and I have the right under that license to
|
||||||
|
submit that work with modifications, whether created in whole
|
||||||
|
or in part by me, under the same open source license (unless
|
||||||
|
I am permitted to submit under a different license), as
|
||||||
|
indicated in the file; or
|
||||||
|
|
||||||
|
(c) The contribution was provided directly to me by some other
|
||||||
|
person who certified (a), (b) or (c) and I have not modified
|
||||||
|
it.
|
||||||
|
|
||||||
|
(d) I understand and agree that this project and the contribution
|
||||||
|
are public and that a record of the contribution (including
|
||||||
|
all personal information I submit with it, including my
|
||||||
|
sign-off) is maintained indefinitely and may be redistributed
|
||||||
|
consistent with this project or the open source license(s)
|
||||||
|
involved.
|
||||||
|
|
||||||
|
then you just add a line saying
|
||||||
|
|
||||||
|
Signed-off-by: Random J Developer <random@developer.example.org>
|
||||||
|
|
||||||
|
using your real name (sorry, no pseudonyms or anonymous contributions.)
|
||||||
|
|
||||||
|
* If the the business with git is too difficult just send source code
|
||||||
|
files as is as email attachment to maintainer.
|
||||||
|
|
||||||
|
CODING STYLE:
|
||||||
|
|
||||||
|
* The preferred coding style is based on the linux kernel Documentation/CodingStyle.
|
||||||
|
For more details see:
|
||||||
|
|
||||||
|
http://git.kernel.org/?p=linux/kernel/git/torvalds/linux-2.6.git;a=blob_plain;f=Documentation/CodingStyle
|
||||||
|
|
||||||
|
* Source code is pretty printed by using two, and only the two, indent
|
||||||
|
command switches -kr -i8
|
||||||
|
|
|
||||||
2
THANKS
2
THANKS
|
|
@ -1,6 +1,6 @@
|
||||||
dhcpd-pools THANKS file
|
dhcpd-pools THANKS file
|
||||||
|
|
||||||
Project is originated by Sami Kerola.
|
Project is maintained by Sami Kerola <kerolasa@iki.fi>
|
||||||
|
|
||||||
People who reported problems, give improvement suggestions or even
|
People who reported problems, give improvement suggestions or even
|
||||||
contributed code.
|
contributed code.
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue