1#ifndef QUOTE_H 2#define QUOTE_H 3 4#include <stddef.h> 5 6/* Help to copy the thing properly quoted for the shell safety. 7 * any single quote is replaced with '\'', any exclamation point 8 * is replaced with '\!', and the whole thing is enclosed in a 9 * single quote pair. 10 * 11 * For example, if you are passing the result to system() as an 12 * argument: 13 * 14 * sprintf(cmd, "foobar %s %s", sq_quote(arg0), sq_quote(arg1)) 15 * 16 * would be appropriate. If the system() is going to call ssh to 17 * run the command on the other side: 18 * 19 * sprintf(cmd, "git-diff-tree %s %s", sq_quote(arg0), sq_quote(arg1)); 20 * sprintf(rcmd, "ssh %s %s", sq_quote(host), sq_quote(cmd)); 21 * 22 * Note that the above examples leak memory! Remember to free result from 23 * sq_quote() in a real application. 24 * 25 * sq_quote_buf() writes to an existing buffer of specified size; it 26 * will return the number of characters that would have been written 27 * excluding the final null regardless of the buffer size. 28 */ 29 30char*sq_quote(const char*src); 31size_tsq_quote_buf(char*dst,size_t n,const char*src); 32 33#endif