On Tue, 25 Jan 2022 11:21:23 -0500
Steven Rostedt <rostedt@xxxxxxxxxxx> wrote:
> On Tue, 25 Jan 2022 21:11:57 +0900
> Masami Hiramatsu <mhiramat@xxxxxxxxxx> wrote:
>
> > The fprobe is a wrapper API for ftrace function tracer.
> > Unlike kprobes, this probes only supports the function entry, but
> > it can probe multiple functions by one fprobe. The usage is almost
> > same as the kprobe, user will specify the function names by
> > fprobe::syms, the number of syms by fprobe::nentry,
> > and the user handler by fprobe::entry_handler.
> >
> > struct fprobe fp = { 0 };
> > const char *targets[] = { "func1", "func2", "func3"};
> >
> > fp.handler = user_handler;
> > fp.nentry = ARRAY_SIZE(targets);
> > fp.syms = targets;
> >
> > ret = register_fprobe(&fp);
> >
> > CAUTION: if user entry handler changes registers including
> > ip address, it will be applied when returns from the
> > entry handler. So user handler must recover it.
>
> Can you rephrase the above, I'm not sure what you mean by it.
OK, but I think this should be written in the document.
I meant entry_handler can change the regs, but that will change
the execution path. So for some reason if it needs to change the
registers, those should be recovered in the same entry_handler.
[SNIP]
> > +/* Convert ftrace location address from symbols */
> > +static int convert_func_addresses(struct fprobe *fp)
> > +{
> > + unsigned long addr, size;
> > + unsigned int i;
> > +
> > + /* Convert symbols to symbol address */
> > + if (fp->syms) {
> > + fp->addrs = kcalloc(fp->nentry, sizeof(*fp->addrs), GFP_KERNEL);
> > + if (!fp->addrs)
> > + return -ENOMEM;
> > +
> > + for (i = 0; i < fp->nentry; i++) {
> > + fp->addrs[i] = kallsyms_lookup_name(fp->syms[i]);
> > + if (!fp->addrs[i]) /* Maybe wrong symbol */
> > + goto error;
> > + }
> > + }
>
> I wonder if we should just copy the addrs when fp->syms is not set, and
> not have to worry about not freeing addrs (see below). This will make
> things easier to maintain. Or better yet, have the syms and addrs passed
> in, and then we assign it.
>
> static int convert_func_addresses(struct fprobe *fp, const char **syms,
> unsigned long *addrs)
> {
> unsigned int i;
>
> fp->addrs = kcalloc(fp->nentry, sizeof(*fp->addrs), GFP_KERNEL);
> if (!fp->addrs)
> return -ENOMEM;
>
> if (syms) {
> for (i = 0; i < fp->nentry; i++) {
> fp->addrs[i] = kallsyms_lookup_name(fp->syms[i]);
> if (!fp->addrs[i]) /* Maybe wrong symbol */
> goto error;
> }
> } else {
> memcpy(fp->addrs, addrs, fp->nentry * sizeof(*addrs));
> }
Actually, since fprobe doesn't touch the addrs and syms except for the
registering time, instead of changing the fp->addrs, I would like
to make a temporary address array just for ftrace_filter_ips(). Then
we don't need to free it later.
>
> > +
> > + /* Convert symbol address to ftrace location. */
> > + for (i = 0; i < fp->nentry; i++) {
> > + if (!kallsyms_lookup_size_offset(fp->addrs[i], &size, NULL))
> > + size = MCOUNT_INSN_SIZE;
> > + addr = ftrace_location_range(fp->addrs[i], fp->addrs[i] + size);
> > + if (!addr) /* No dynamic ftrace there. */
> > + goto error;
> > + fp->addrs[i] = addr;
> > + }
> > +
> > + return 0;
> > +
> > +error:
> > + kfree(fp->addrs);
>
> The above doesn't check if fp->syms was set, so if it wasn't we just freed
> the addrs that was passed in. Again, I think these should be passed into
> the register function as separate parameters and not via the fp handle.
Agreed. I also would like to remove those params from struct fprobe.
>
> > + fp->addrs = NULL;
> > + return -ENOENT;
> > +}
> > +
> > +/**
> > + * register_fprobe() - Register fprobe to ftrace
> > + * @fp: A fprobe data structure to be registered.
> > + *
> > + * This expects the user set @fp::entry_handler, @fp::syms or @fp:addrs,
> > + * and @fp::nentry. If @fp::addrs are set, that will be updated to point
> > + * the ftrace location. If @fp::addrs are NULL, this will generate it
> > + * from @fp::syms.
> > + * Note that you do not set both of @fp::addrs and @fp::syms.
>
> Again, I think this should pass in the syms and addrs as parameters.
That's good to me :)
Thank you,
>
> -- Steve
>
> > + */
> > +int register_fprobe(struct fprobe *fp)
> > +{
> > + int ret;
> > +
> > + if (!fp || !fp->nentry || (!fp->syms && !fp->addrs) ||
> > + (fp->syms && fp->addrs))
> > + return -EINVAL;
> > +
> > + ret = convert_func_addresses(fp);
> > + if (ret < 0)
> > + return ret;
> > +
> > + fp->nmissed = 0;
> > + fp->ops.func = fprobe_handler;
> > + fp->ops.flags = FTRACE_OPS_FL_SAVE_REGS;
> > +
> > + ret = ftrace_set_filter_ips(&fp->ops, fp->addrs, fp->nentry, 0, 0);
> > + if (!ret)
> > + ret = register_ftrace_function(&fp->ops);
> > +
> > + if (ret < 0 && fp->syms) {
> > + kfree(fp->addrs);
> > + fp->addrs = NULL;
> > + }
> > +
> > + return ret;
> > +}
> > +EXPORT_SYMBOL_GPL(register_fprobe);
> > +
> > +/**
> > + * unregister_fprobe() - Unregister fprobe from ftrace
> > + * @fp: A fprobe data structure to be unregistered.
> > + *
> > + * Unregister fprobe (and remove ftrace hooks from the function entries).
> > + * If the @fp::addrs are generated by register_fprobe(), it will be removed
> > + * automatically.
> > + */
> > +int unregister_fprobe(struct fprobe *fp)
> > +{
> > + int ret;
> > +
> > + if (!fp || !fp->nentry || !fp->addrs)
> > + return -EINVAL;
> > +
> > + ret = unregister_ftrace_function(&fp->ops);
> > +
> > + if (!ret && fp->syms) {
> > + kfree(fp->addrs);
> > + fp->addrs = NULL;
> > + }
> > + return ret;
> > +}
> > +EXPORT_SYMBOL_GPL(unregister_fprobe);
>
--
Masami Hiramatsu <mhiramat@xxxxxxxxxx>
