Git Branch Management
Net-SNMP has a number of scripts or shell functions which help manage a git-repo. Specifically, we have a bunch of tools that help test patches, apply patches and perform upward merges based on our Git Workflow.
Contents
Getting Started
The bash aliases require that you source the local/gittools/shell-functions in order to get started:
# . ./local/gittools/shell-functions
Once this is done, the rest of the commands on this page will work.
Patch Management
Our Git Workflow states that patches should be applied to the lowest branch possible. IE, if you have a bug fix for nearly every version it should be applied to the lowest current supported version branch. EG, V5-4-patches. But which branch will it apply against cleanly?? How do I do this quickly? We have an answer for you:
Note: all these routines require a clean source tree to start, and will warn you if you have modified files in the tree
nspatchtry
The nspatchtest command can be used to apply a patch to each (currently supported) branch in the tree to see which it will successfully apply to. This is much faster than figuring this out by hand. It takes patch arguments to apply the patch with. The -i switch is required to specify where the patch file is located.
# nspatchtry -p 1 -i /tmp/thepatch
::: Net-SNMP: checking out and applying patch in V5-4-patches
Switched to branch 'V5-4-patches'
Your branch is ahead of 'origin/V5-4-patches' by 5 commits.
::: Net-SNMP: Appling patch
patching file net-snmp/README.snmpv3
::: Net-SNMP: Patch succeeded on V5-4-patches
::: Net-SNMP: cleaning source tree
::: Net-SNMP: checking out and applying patch in V5-5-patches
Switched to branch 'V5-5-patches'
Your branch is ahead of 'origin/V5-5-patches' by 12824 commits.
::: Net-SNMP: Appling patch
patching file net-snmp/README.snmpv3
::: Net-SNMP: Patch succeeded on V5-5-patches
::: Net-SNMP: cleaning source tree
::: Net-SNMP: checking out and applying patch in V5-6-patches
Switched to branch 'V5-6-patches'
Your branch is ahead of 'origin/V5-6-patches' by 25983 commits.
::: Net-SNMP: Appling patch
patching file net-snmp/README.snmpv3
::: Net-SNMP: Patch succeeded on V5-6-patches
::: Net-SNMP: cleaning source tree
::: Net-SNMP: checking out and applying patch in master
Switched to branch 'master'
Your branch is ahead of 'origin/master' by 14786 commits.
::: Net-SNMP: Appling patch
patching file net-snmp/README.snmpv3
::: Net-SNMP: Patch succeeded on master
::: Net-SNMP: cleaning source tree
Patch application results:
Success: V5-4-patches V5-5-patches V5-6-patches master
Fail:
Note the important ending: my patch succeeded against all those branches.
nspatchapply
Now that we know where the patch should be applied, actually applying it is very simple. Simply call the nspatchapply script, which:
- checks out the earliest branch that worked with nspatchtry
- applies the patch
- runs git diff so you can make sure it looks ok
- asks you if it looks ok and if so:
- runs git commit on the results, with any arguments you pass it, to commit the results.
# nspatchapply -m "applying the wonderful patch. Isn't it pretty?" ::: Net-SNMP: Checking out V5-4-patches Switched to branch 'V5-4-patches' Your branch is ahead of 'origin/V5-4-patches' by 5 commits. ::: Net-SNMP: applying the patch -p 1 -i /tmp/thepatch patching file net-snmp/README.snmpv3 diff --git a/net-snmp/README.snmpv3 b/net-snmp/README.snmpv3 index 263c955..8294035 100644 --- a/net-snmp/README.snmpv3 +++ b/net-snmp/README.snmpv3 @@ -1,4 +1,4 @@ -README.snmpv3 +README.snmpv3foo ------------- How to setup SNMPv3, a very brief document for Dave to elaborate and do a better job on since I suck at writing documentation and he commit the results to V5-4-patches? [y/n] y [V5-4-patches 102bde5] applying the wonderful patch. Isn't it pretty? 1 files changed, 1 insertions(+), 1 deletions(-)
Done! Wasn't that easy?
== Git Repository Management
