----- Original Message ----- > On Fri, 17 Apr 2015, Mathieu Desnoyers wrote: > > +/** > > + * enum membarrier_cmd - membarrier system call command > > + * > > * @MEMBARRIER_CMD_QUERY: Explanatory blurb...... > > Hint: Create a kerneldoc document and build it.
Oops, fixed, and figured out how to build it. Next version should be ok. > > > + * Command to be passed to the membarrier system call. > > Please epxlain, that the commands need to be a single bit each. OK > > > +config MEMBARRIER > > + bool "Enable membarrier() system call" if EXPERT > > + default y > > + depends on SMP > > + help > > + Enable the membarrier() system call that allows issuing memory > > + barriers across all running threads, which can be used to distribute > > + the cost of user-space memory barriers asymmetrically by transforming > > + pairs of memory barriers into pairs consisting of membarrier() and a > > + compiler barrier. > > + > > + If unsure, say Y. > > Is it really worth to make this configurable? Josh Triplett asked for it to be made configurable. I don't have any strong opinion one way or the other. > > > +/** > > + * sys_membarrier - issue memory barriers on a set of threads > > + * @cmd: MEMBARRIER_CMD_QUERY: > > + * Query the set of supported commands. It returns a bitmask > > of > > + * supported commands. > > + * MEMBARRIER_CMD_SHARED: > > + * Execute a memory barrier on all running threads. Upon > > + * return from system call, the caller thread is ensured that > > + * all running threads have passed through a state where all > > + * memory accesses to user-space addresses match program order > > + * between entry to and return from the system call > > (non-running > > + * threads are de facto in such a state). This covers threads > > + * from all processes running on the system. This command > > + * returns 0. > > I think the explanation for the commands should be in the enum > documentation. This here should explain that @cmd takes command values > defined in the enum. OK > > > +SYSCALL_DEFINE2(membarrier, int, cmd, int, flags) > > +{ > > + switch (cmd) { > > + case MEMBARRIER_CMD_QUERY: > > + return MEMBARRIER_CMD_BITMASK; > > + case MEMBARRIER_CMD_SHARED: > > + if (num_online_cpus() > 1) > > + synchronize_sched(); > > + return 0; > > + default: > > + return -EINVAL; > > + } > > +} > > This looks way cleaner now :) Much smaller too :) Thanks, Mathieu > > Thanks, > > tglx > -- Mathieu Desnoyers EfficiOS Inc. http://www.efficios.com -- To unsubscribe from this list: send the line "unsubscribe linux-kernel" in the body of a message to majord...@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html Please read the FAQ at http://www.tux.org/lkml/