LXR linux/include/linux/kobject

   1/* Kernel object name space definitions
   2 *
   3 * Copyright (c) 2002-2003 Patrick Mochel
   4 * Copyright (c) 2002-2003 Open Source Development Labs
   5 * Copyright (c) 2006-2008 Greg Kroah-Hartman <greg@kroah.com>
   6 * Copyright (c) 2006-2008 Novell Inc.
   7 *
   8 * Split from kobject.h by David Howells (dhowells@redhat.com)
   9 *
  10 * This file is released under the GPLv2.
  11 *
  12 * Please read Documentation/kobject.txt before using the kobject
  13 * interface, ESPECIALLY the parts about reference counts and object
  14 * destructors.
  15 */
  16
  17#ifndef _LINUX_KOBJECT_NS_H
  18#define _LINUX_KOBJECT_NS_H
  19#include <linux/rh_kabi.h>
  20
  21struct sock;
  22struct kobject;
  23
  24/*
  25 * Namespace types which are used to tag kobjects and sysfs entries.
  26 * Network namespace will likely be the first.
  27 */
  28enum kobj_ns_type {
  29        KOBJ_NS_TYPE_NONE = 0,
  30        KOBJ_NS_TYPE_NET,
  31        KOBJ_NS_TYPES
  32};
  33
  34/*
  35 * Callbacks so sysfs can determine namespaces
  36 *   @grab_current_ns: return a new reference to calling task's namespace
  37 *   @netlink_ns: return namespace to which a sock belongs (right?)
  38 *   @initial_ns: return the initial namespace (i.e. init_net_ns)
  39 *   @drop_ns: drops a reference to namespace
  40 */
  41struct kobj_ns_type_operations {
  42        enum kobj_ns_type type;
  43        void *(*grab_current_ns)(void);
  44        const void *(*netlink_ns)(struct sock *sk);
  45        const void *(*initial_ns)(void);
  46        void (*drop_ns)(void *);
  47        RH_KABI_EXTEND(bool (*current_may_mount)(void))
  48};
  49
  50int kobj_ns_type_register(const struct kobj_ns_type_operations *ops);
  51int kobj_ns_type_registered(enum kobj_ns_type type);
  52const struct kobj_ns_type_operations *kobj_child_ns_ops(struct kobject *parent);
  53const struct kobj_ns_type_operations *kobj_ns_ops(struct kobject *kobj);
  54
  55bool kobj_ns_current_may_mount(enum kobj_ns_type type);
  56void *kobj_ns_grab_current(enum kobj_ns_type type);
  57const void *kobj_ns_netlink(enum kobj_ns_type type, struct sock *sk);
  58const void *kobj_ns_initial(enum kobj_ns_type type);
  59void kobj_ns_drop(enum kobj_ns_type type, void *ns);
  60
  61#endif /* _LINUX_KOBJECT_NS_H */
  62