Merge branch 'master' of github.com:OpenHFT/Java-Thread-Affinity

epickrram · epickrram · commit 99c84cea4281 · 2017-12-12T15:44:57.000Z
diff --git a/README.md b/README.md
@@ -43,7 +43,7 @@ for the artifacts `jna` and `jna-platform` in the project's `pom` file.
     sudo yum install jna
 
 
-## How CPU does allocation work?
+## How does CPU allocation work?
 The library will read your `/proc/cpuinfo` if you have one or provide one and it will determine your CPU layout.  If you don't have one it will assume every CPU is on one CPU socket.
 
 The library looks for isolated CPUs determined by looking at the CPUs you are not running on by default. 
@@ -66,9 +66,9 @@ http://vanillajava.blogspot.co.uk/2013/07/micro-jitter-busy-waiting-and-binding.
 
 ## isolcpus
 
-Java-Thread-Affinity requires that you first ioslcate some CPU's for its to use.
+Java-Thread-Affinity requires that you first isolate some CPU's.
 
-Once a CPU core is isolated, the Linux scheduler will not use the CPU core to run any user-space processes. The isolated CPUs will not participate in load balancing, and will not have tasks running on them unless explicitly assigned. You can manually assign processes to be run on the isolated CPU cores using taskset.
+Once a CPU core is isolated, the Linux scheduler will not use the CPU core to run any user-space processes. The isolated CPUs will not participate in load balancing, and will not have tasks running on them unless explicitly assigned.
 
 To isolate the 1st and 3rd CPU cores (CPU numbers start from 0) on your system, add the following to the kernel command line during boot:
 
diff --git a/affinity/src/main/java/net/openhft/affinity/AffinityLock.java b/affinity/src/main/java/net/openhft/affinity/AffinityLock.java
@@ -167,6 +167,19 @@ public static AffinityLock acquireLock(boolean bind) {
         return acquireLock(bind, -1, AffinityStrategies.ANY);
     }
 
+
+    /**
+     * Assign a cpu which can be bound to the current thread or another thread. <p> This can be used
+     * for defining your thread layout centrally and passing the handle via dependency injection.
+     *
+     * @param cpuId the CPU id to bind to
+     * @return A handle for an affinity lock.
+     */
+    public static AffinityLock acquireLock(int cpuId) {
+        return acquireLock(true, cpuId, AffinityStrategies.ANY);
+    }
+
+
     /**
      * Assign a core(and all its cpus) which can be bound to the current thread or another thread.
      * <p> This can be used for defining your thread layout centrally and passing the handle via
