12#include "ruby/internal/config.h"
25#include "internal/array.h"
26#include "internal/bignum.h"
27#include "internal/class.h"
28#include "internal/encoding.h"
29#include "internal/error.h"
30#include "internal/hash.h"
31#include "internal/marshal.h"
32#include "internal/numeric.h"
33#include "internal/object.h"
34#include "internal/re.h"
35#include "internal/struct.h"
36#include "internal/symbol.h"
37#include "internal/util.h"
38#include "internal/vm.h"
47#define BITSPERSHORT (2*CHAR_BIT)
48#define SHORTMASK ((1<<BITSPERSHORT)-1)
49#define SHORTDN(x) RSHIFT((x),BITSPERSHORT)
51#if SIZEOF_SHORT == SIZEOF_BDIGIT
52#define SHORTLEN(x) (x)
55shortlen(
size_t len, BDIGIT *ds)
65 return (
len - 1)*SIZEOF_BDIGIT/2 + offset;
67#define SHORTLEN(x) shortlen((x),d)
70#define MARSHAL_MAJOR 4
71#define MARSHAL_MINOR 8
76#define TYPE_FIXNUM 'i'
78#define TYPE_EXTENDED 'e'
79#define TYPE_UCLASS 'C'
80#define TYPE_OBJECT 'o'
82#define TYPE_USERDEF 'u'
83#define TYPE_USRMARSHAL 'U'
85#define TYPE_BIGNUM 'l'
86#define TYPE_STRING '"'
87#define TYPE_REGEXP '/'
90#define TYPE_HASH_DEF '}'
91#define TYPE_STRUCT 'S'
92#define TYPE_MODULE_OLD 'M'
94#define TYPE_MODULE 'm'
96#define TYPE_SYMBOL ':'
97#define TYPE_SYMLINK ';'
102static ID s_dump, s_load, s_mdump, s_mload;
103static ID s_dump_data, s_load_data, s_call;
104static ID s_getbyte, s_read, s_write, s_binmode;
105static ID s_encoding_short, s_ruby2_keywords_flag;
106#define s_encoding_long rb_id_encoding()
108#define name_s_dump "_dump"
109#define name_s_load "_load"
110#define name_s_mdump "marshal_dump"
111#define name_s_mload "marshal_load"
112#define name_s_dump_data "_dump_data"
113#define name_s_load_data "_load_data"
114#define name_s_call "call"
115#define name_s_getbyte "getbyte"
116#define name_s_read "read"
117#define name_s_write "write"
118#define name_s_binmode "binmode"
119#define name_s_encoding_short "E"
120#define name_s_encoding_long "encoding"
121#define name_s_ruby2_keywords_flag "K"
126 VALUE (*dumper)(VALUE);
127 VALUE (*loader)(VALUE, VALUE);
130static st_table *compat_allocator_tbl;
131static VALUE compat_allocator_tbl_wrapper;
132static VALUE rb_marshal_dump_limited(VALUE obj, VALUE port, int limit);
133static VALUE rb_marshal_load_with_proc(VALUE port, VALUE proc, bool freeze);
135static st_table *compat_allocator_table(void);
138rb_marshal_define_compat(VALUE newclass, VALUE oldclass, VALUE (*dumper)(VALUE), VALUE (*loader)(VALUE, VALUE))
140 marshal_compat_t *compat;
141 rb_alloc_func_t allocator = rb_get_alloc_func(newclass);
144 rb_raise(rb_eTypeError, "no allocator");
147 compat_allocator_table();
148 compat = ALLOC(marshal_compat_t);
149 compat->newclass = newclass;
150 compat->oldclass = oldclass;
151 compat->dumper = dumper;
152 compat->loader = loader;
154 st_insert(compat_allocator_table(), (st_data_t)allocator, (st_data_t)compat);
155 RB_OBJ_WRITTEN(compat_allocator_tbl_wrapper, Qundef, newclass);
156 RB_OBJ_WRITTEN(compat_allocator_tbl_wrapper, Qundef, oldclass);
159/* The rb_marshal_define_compat entry for an instance of klass, if any, so the Ractor
160 * courier can dump and load it the way Marshal does. */
162rb_marshal_compat_lookup(VALUE klass, VALUE (**dumper)(VALUE), VALUE (**loader)(VALUE, VALUE))
165 rb_alloc_func_t allocator = RCLASS_SINGLETON_P(klass) ? 0 : rb_get_alloc_func(klass);
166 if (!allocator || !st_lookup(compat_allocator_tbl, (st_data_t)allocator, &data)) return false;
167 marshal_compat_t *compat = (marshal_compat_t *)data;
168 if (!compat->dumper || !compat->loader) return false;
169 if (dumper) *dumper = compat->dumper;
170 if (loader) *loader = compat->loader;
178 st_table *compat_tbl;
181 st_index_t num_entries;
184struct dump_call_arg {
186 struct dump_arg *arg;
191check_dump_arg(VALUE ret, struct dump_arg *arg, const char *name)
194 rb_raise(rb_eRuntimeError, "Marshal.dump reentered at %s",
201check_userdump_arg(VALUE obj, ID sym, int argc, const VALUE *argv,
202 struct dump_arg *arg, const char *name)
204 VALUE ret = rb_funcallv(obj, sym, argc, argv);
205 VALUE klass = CLASS_OF(obj);
206 if (CLASS_OF(ret) == klass) {
207 rb_raise(rb_eRuntimeError, "%"PRIsVALUE"#%s returned same class instance",
210 return check_dump_arg(ret, arg, name);
213#define dump_funcall(arg, obj, sym, argc, argv) \
214 check_userdump_arg(obj, sym, argc, argv, arg, name_##sym)
215#define dump_check_funcall(arg, obj, sym, argc, argv) \
216 check_dump_arg(rb_check_funcall(obj, sym, argc, argv), arg, name_##sym)
218static void clear_dump_arg(struct dump_arg *arg);
221mark_dump_arg(void *ptr)
223 struct dump_arg *p = ptr;
226 rb_mark_set(p->symbols);
227 rb_mark_set(p->data);
228 rb_mark_hash(p->compat_tbl);
229 rb_mark_set(p->userdefs);
234free_dump_arg(void *ptr)
240memsize_dump_arg(const void *ptr)
242 const struct dump_arg *p = (struct dump_arg *)ptr;
244 if (p->symbols) memsize += rb_st_memsize(p->symbols);
245 if (p->data) memsize += rb_st_memsize(p->data);
246 if (p->compat_tbl) memsize += rb_st_memsize(p->compat_tbl);
247 if (p->userdefs) memsize += rb_st_memsize(p->userdefs);
248 if (p->encodings) memsize += rb_st_memsize(p->encodings);
252static const rb_data_type_t dump_arg_data = {
254 {mark_dump_arg, free_dump_arg, memsize_dump_arg,},
255 0, 0, RUBY_TYPED_THREAD_SAFE_FREE | RUBY_TYPED_EMBEDDABLE
259must_not_be_anonymous(const char *type, VALUE path)
261 char *n = RSTRING_PTR(path);
263 if (!rb_enc_asciicompat(rb_enc_get(path))) {
265 rb_raise(rb_eTypeError, "can't dump non-ascii %s name % "PRIsVALUE,
269 rb_raise(rb_eTypeError, "can't dump anonymous %s % "PRIsVALUE,
276class2path(VALUE klass)
278 VALUE path = rb_class_path(klass);
280 must_not_be_anonymous((RB_TYPE_P(klass, T_CLASS) ? "class" : "module"), path);
281 if (rb_path_to_class(path) != rb_class_real(klass)) {
282 rb_raise(rb_eTypeError, "% "PRIsVALUE" can't be referred to", path);
287int ruby_marshal_write_long(long x, char *buf);
288static void w_long(long, struct dump_arg*);
289static int w_encoding(VALUE encname, struct dump_call_arg *arg);
290static VALUE encoding_name(VALUE obj, struct dump_arg *arg);
293w_nbyte(const char *s, long n, struct dump_arg *arg)
295 VALUE buf = arg->str;
296 rb_str_buf_cat(buf, s, n);
297 if (arg->dest && RSTRING_LEN(buf) >= BUFSIZ) {
298 rb_io_write(arg->dest, buf);
299 rb_str_resize(buf, 0);
304w_byte(char c, struct dump_arg *arg)
310w_bytes(const char *s, long n, struct dump_arg *arg)
316#define w_cstr(s, arg) w_bytes((s), strlen(s), (arg))
319w_short(int x, struct dump_arg *arg)
321 w_byte((char)((x >> 0) & 0xff), arg);
322 w_byte((char)((x >> 8) & 0xff), arg);
326w_long(long x, struct dump_arg *arg)
328 char buf[sizeof(long)+1];
329 int i = ruby_marshal_write_long(x, buf);
331 rb_raise(rb_eTypeError, "long too big to dump");
333 w_nbyte(buf, i, arg);
337ruby_marshal_write_long(long x, char *buf)
342 if (!(RSHIFT(x, 31) == 0 || RSHIFT(x, 31) == -1)) {
343 /* big long does not fit in 4 bytes */
352 if (0 < x && x < 123) {
353 buf[0] = (char)(x + 5);
356 if (-124 < x && x < 0) {
357 buf[0] = (char)((x - 5)&0xff);
360 for (i=1;i<(int)sizeof(long)+1;i++) {
361 buf[i] = (char)(x & 0xff);
376#define DECIMAL_MANT (53-16) /* from IEEE754 double precision */
380#elif DBL_MANT_DIG > 24
382#elif DBL_MANT_DIG > 16
389load_mantissa(double d, const char *buf, long len)
392 if (--len > 0 && !*buf++) { /* binary mantissa mark */
393 int e, s = d < 0, dig = 0;
396 modf(ldexp(frexp(fabs(d), &e), DECIMAL_MANT), &d);
400 default: m = *buf++ & 0xff; /* fall through */
402 case 3: m = (m << 8) | (*buf++ & 0xff); /* fall through */
405 case 2: m = (m << 8) | (*buf++ & 0xff); /* fall through */
408 case 1: m = (m << 8) | (*buf++ & 0xff);
411 dig -= len < MANT_BITS / 8 ? 8 * (unsigned)len : MANT_BITS;
412 d += ldexp((double)m, dig);
413 } while ((len -= MANT_BITS / 8) > 0);
414 d = ldexp(d, e - DECIMAL_MANT);
420#define load_mantissa(d, buf, len) (d)
424#define FLOAT_DIG (DBL_DIG+2)
430w_float(double d, struct dump_arg *arg)
432 char buf[FLOAT_DIG + (DECIMAL_MANT + 7) / 8 + 10];
435 if (d < 0) w_cstr("-inf", arg);
436 else w_cstr("inf", arg);
442 if (signbit(d)) w_cstr("-0", arg);
443 else w_cstr("0", arg);
446 int decpt, sign, digs, len = 0;
447 char *e, *p = ruby_dtoa(d, 0, 0, &decpt, &sign, &e);
448 if (sign) buf[len++] = '-';
450 if (decpt < -3 || decpt > digs) {
452 if (--digs > 0) buf[len++] = '.';
453 memcpy(buf + len, p + 1, digs);
455 len += snprintf(buf + len, sizeof(buf) - len, "e%d", decpt - 1);
457 else if (decpt > 0) {
458 memcpy(buf + len, p, decpt);
460 if ((digs -= decpt) > 0) {
462 memcpy(buf + len, p + decpt, digs);
470 memset(buf + len, '0', -decpt);
473 memcpy(buf + len, p, digs);
477 w_bytes(buf, len, arg);
483w_encivar(VALUE str, struct dump_arg *arg)
485 VALUE encname = encoding_name(str, arg);
486 if (NIL_P(encname) ||
487 is_ascii_string(str)) {
490 w_byte(TYPE_IVAR, arg);
495w_encname(VALUE encname, struct dump_arg *arg)
497 if (!NIL_P(encname)) {
498 struct dump_call_arg c_arg;
502 w_encoding(encname, &c_arg);
507w_symbol(VALUE sym, struct dump_arg *arg)
512 if (st_lookup(arg->symbols, sym, &num)) {
513 w_byte(TYPE_SYMLINK, arg);
514 w_long((long)num, arg);
517 const VALUE orig_sym = sym;
518 sym = rb_sym2str(sym);
520 rb_raise(rb_eTypeError, "can't dump anonymous ID %"PRIdVALUE, sym);
522 encname = w_encivar(sym, arg);
523 w_byte(TYPE_SYMBOL, arg);
524 w_bytes(RSTRING_PTR(sym), RSTRING_LEN(sym), arg);
525 st_add_direct(arg->symbols, orig_sym, arg->symbols->num_entries);
526 w_encname(encname, arg);
531w_unique(VALUE s, struct dump_arg *arg)
533 must_not_be_anonymous("class", s);
534 w_symbol(rb_str_intern(s), arg);
537static void w_object(VALUE,struct dump_arg*,int);
540hash_each(VALUE key, VALUE value, VALUE v)
542 struct dump_call_arg *arg = (void *)v;
543 w_object(key, arg->arg, arg->limit);
544 w_object(value, arg->arg, arg->limit);
548#define SINGLETON_DUMP_UNABLE_P(klass) \
549 (rb_id_table_size(RCLASS_M_TBL(klass)) > 0 || \
550 rb_ivar_count(klass) > 0)
553w_extended(VALUE klass, struct dump_arg *arg, int check)
555 if (check && RCLASS_SINGLETON_P(klass)) {
556 VALUE origin = RCLASS_ORIGIN(klass);
557 if (SINGLETON_DUMP_UNABLE_P(klass) ||
558 (origin != klass && SINGLETON_DUMP_UNABLE_P(origin))) {
559 rb_raise(rb_eTypeError, "singleton can't be dumped");
561 klass = RCLASS_SUPER(klass);
563 while (BUILTIN_TYPE(klass) == T_ICLASS) {
564 if (!RICLASS_IS_ORIGIN_P(klass) ||
565 BUILTIN_TYPE(RBASIC(klass)->klass) != T_MODULE) {
566 VALUE path = rb_class_name(RBASIC(klass)->klass);
567 w_byte(TYPE_EXTENDED, arg);
570 klass = RCLASS_SUPER(klass);
575w_class(char type, VALUE obj, struct dump_arg *arg, int check)
581 if (arg->compat_tbl &&
582 st_lookup(arg->compat_tbl, (st_data_t)obj, &real_obj)) {
583 obj = (VALUE)real_obj;
585 klass = CLASS_OF(obj);
586 w_extended(klass, arg, check);
588 path = class2path(rb_class_real(klass));
593w_uclass(VALUE obj, VALUE super, struct dump_arg *arg)
595 VALUE klass = CLASS_OF(obj);
597 w_extended(klass, arg, TRUE);
598 klass = rb_class_real(klass);
599 if (klass != super) {
600 w_byte(TYPE_UCLASS, arg);
601 w_unique(class2path(klass), arg);
606rb_hash_ruby2_keywords_p(VALUE obj)
608 return (RHASH(obj)->basic.flags & RHASH_PASS_AS_KEYWORDS) != 0;
612rb_hash_ruby2_keywords(VALUE obj)
614 RHASH(obj)->basic.flags |= RHASH_PASS_AS_KEYWORDS;
618 * if instance variable name `id` is a special name to be skipped,
619 * returns the name of it. otherwise it cannot be dumped (unnamed),
620 * returns `name` as-is. returns NULL for ID that can be dumped.
622static inline const char *
623skipping_ivar_name(const ID id, const char *name)
625#define IS_SKIPPED_IVAR(idname) \
626 ((id == idname) && (name = name_##idname, true))
627 if (IS_SKIPPED_IVAR(s_encoding_short)) return name;
628 if (IS_SKIPPED_IVAR(s_ruby2_keywords_flag)) return name;
629 if (IS_SKIPPED_IVAR(s_encoding_long)) return name;
630 if (!rb_id2str(id)) return name;
635 struct dump_call_arg *dump;
640w_obj_each(ID id, VALUE value, st_data_t a)
642 struct w_ivar_arg *ivarg = (struct w_ivar_arg *)a;
643 struct dump_call_arg *arg = ivarg->dump;
644 const char unnamed[] = "", *ivname = skipping_ivar_name(id, unnamed);
647 if (ivname != unnamed) {
648 rb_warn("instance variable '%s' on class %"PRIsVALUE" is not dumped",
649 ivname, CLASS_OF(arg->obj));
654 w_symbol(ID2SYM(id), arg->arg);
655 w_object(value, arg->arg, arg->limit);
660obj_count_ivars(ID id, VALUE val, st_data_t a)
662 if (!skipping_ivar_name(id, "") && UNLIKELY(!++*(st_index_t *)a)) {
663 rb_raise(rb_eRuntimeError, "too many instance variables");
669encoding_name(VALUE obj, struct dump_arg *arg)
671 if (rb_enc_capable(obj)) {
672 int encidx = rb_enc_get_index(obj);
673 rb_encoding *enc = 0;
676 if (encidx <= 0 || !(enc = rb_enc_from_index(encidx))) {
680 /* special treatment for US-ASCII and UTF-8 */
681 if (encidx == rb_usascii_encindex()) {
684 else if (encidx == rb_utf8_encindex()) {
689 !st_lookup(arg->encodings, (st_data_t)rb_enc_name(enc), &name) :
690 (arg->encodings = st_init_strcasetable(), 1)) {
691 name = (st_data_t)rb_str_new_cstr(rb_enc_name(enc));
692 st_insert(arg->encodings, (st_data_t)rb_enc_name(enc), name);
702w_encoding(VALUE encname, struct dump_call_arg *arg)
704 int limit = arg->limit;
705 if (limit >= 0) ++limit;
709 w_symbol(ID2SYM(s_encoding_short), arg->arg);
710 w_object(encname, arg->arg, limit);
715 w_symbol(ID2SYM(rb_id_encoding()), arg->arg);
716 w_object(encname, arg->arg, limit);
721has_ivars(VALUE obj, VALUE encname, VALUE *ivobj)
723 st_index_t num = !NIL_P(encname);
725 if (SPECIAL_CONST_P(obj)) goto generic;
726 switch (BUILTIN_TYPE(obj)) {
730 break; /* counted elsewhere */
732 if (rb_hash_ruby2_keywords_p(obj)) ++num;
736 rb_ivar_foreach(obj, obj_count_ivars, (st_data_t)&num);
737 if (num) *ivobj = obj;
744w_ivar_each(VALUE obj, st_index_t num, struct dump_call_arg *arg)
746 struct w_ivar_arg ivarg = {arg, num};
748 rb_ivar_foreach_buffered(obj, w_obj_each, (st_data_t)&ivarg);
752w_ivar(st_index_t num, VALUE ivobj, VALUE encname, struct dump_call_arg *arg)
754 w_long(num, arg->arg);
755 num -= w_encoding(encname, arg);
756 if (RB_TYPE_P(ivobj, T_HASH) && rb_hash_ruby2_keywords_p(ivobj)) {
757 int limit = arg->limit;
758 if (limit >= 0) ++limit;
759 w_symbol(ID2SYM(s_ruby2_keywords_flag), arg->arg);
760 w_object(Qtrue, arg->arg, limit);
763 if (!UNDEF_P(ivobj) && num) {
764 w_ivar_each(ivobj, num, arg);
769w_objivar(VALUE obj, struct dump_call_arg *arg)
773 rb_ivar_foreach(obj, obj_count_ivars, (st_data_t)&num);
774 w_long(num, arg->arg);
775 w_ivar_each(obj, num, arg);
779// Optimized dump for fixnum larger than 31-bits
781w_bigfixnum(VALUE obj, struct dump_arg *arg)
783 RUBY_ASSERT(FIXNUM_P(obj));
785 w_byte(TYPE_BIGNUM, arg);
787#if SIZEOF_LONG == SIZEOF_VALUE
791 long long num, slen_num;
795 char sign = num < 0 ? '-' : '+';
798 // Guaranteed not to overflow, as FIXNUM is 1-bit less than long
799 if (num < 0) num = -num;
801 // calculate the size in shorts
807 slen_num = SHORTDN(slen_num);
811 RUBY_ASSERT(slen > 0 && slen <= SIZEOF_LONG / 2);
813 w_long((long)slen, arg);
815 for (int i = 0; i < slen; i++) {
816 w_short(num & SHORTMASK, arg);
820 // We aren't adding this object to the link table, but we need to increment
824 RUBY_ASSERT(num == 0);
829w_remember(VALUE obj, struct dump_arg *arg)
831 st_add_direct(arg->data, obj, arg->num_entries++);
835w_object(VALUE obj, struct dump_arg *arg, int limit)
837 struct dump_call_arg c_arg;
838 VALUE ivobj = Qundef;
840 st_index_t hasiv = 0;
841 VALUE encname = Qnil;
844 rb_raise(rb_eArgError, "exceed depth limit");
848 w_byte(TYPE_NIL, arg);
850 else if (obj == Qtrue) {
851 w_byte(TYPE_TRUE, arg);
853 else if (obj == Qfalse) {
854 w_byte(TYPE_FALSE, arg);
856 else if (FIXNUM_P(obj)) {
858 w_byte(TYPE_FIXNUM, arg);
859 w_long(FIX2INT(obj), arg);
861 if (RSHIFT((long)obj, 31) == 0 || RSHIFT((long)obj, 31) == -1) {
862 w_byte(TYPE_FIXNUM, arg);
863 w_long(FIX2LONG(obj), arg);
866 w_bigfixnum(obj, arg);
870 else if (SYMBOL_P(obj)) {
874 if (st_lookup(arg->data, obj, &num)) {
875 w_byte(TYPE_LINK, arg);
876 w_long((long)num, arg);
880 if (limit > 0) limit--;
886 w_remember(obj, arg);
887 w_byte(TYPE_FLOAT, arg);
888 w_float(RFLOAT_VALUE(obj), arg);
894 if (!RBASIC_CLASS(obj)) {
895 rb_raise(rb_eTypeError, "can't dump internal %s",
896 rb_builtin_type_name(BUILTIN_TYPE(obj)));
899 if (rb_obj_respond_to(obj, s_mdump, TRUE)) {
900 w_remember(obj, arg);
902 v = dump_funcall(arg, obj, s_mdump, 0, 0);
903 w_class(TYPE_USRMARSHAL, obj, arg, FALSE);
904 w_object(v, arg, limit);
907 if (rb_obj_respond_to(obj, s_dump, TRUE)) {
908 VALUE ivobj2 = Qundef;
912 if (arg->userdefs && st_is_member(arg->userdefs, (st_data_t)obj)) {
913 rb_raise(rb_eRuntimeError, "can't dump recursive object using _dump()");
916 v = dump_funcall(arg, obj, s_dump, 1, &v);
917 if (!RB_TYPE_P(v, T_STRING)) {
918 rb_raise(rb_eTypeError, "_dump() must return string");
920 hasiv = has_ivars(obj, (encname = encoding_name(obj, arg)), &ivobj);
921 hasiv2 = has_ivars(v, (encname2 = encoding_name(v, arg)), &ivobj2);
927 if (hasiv) w_byte(TYPE_IVAR, arg);
928 w_class(TYPE_USERDEF, obj, arg, FALSE);
929 w_bytes(RSTRING_PTR(v), RSTRING_LEN(v), arg);
931 st_data_t userdefs = (st_data_t)obj;
932 if (!arg->userdefs) {
933 arg->userdefs = rb_init_identtable();
935 st_add_direct(arg->userdefs, userdefs, 0);
936 w_ivar(hasiv, ivobj, encname, &c_arg);
937 st_delete(arg->userdefs, &userdefs, NULL);
939 w_remember(obj, arg);
943 w_remember(obj, arg);
945 hasiv = has_ivars(obj, (encname = encoding_name(obj, arg)), &ivobj);
947 st_data_t compat_data;
948 VALUE klass = CLASS_OF(obj);
949 rb_alloc_func_t allocator = RCLASS_SINGLETON_P(klass) ? 0 : rb_get_alloc_func(klass);
950 if (allocator && st_lookup(compat_allocator_tbl,
951 (st_data_t)allocator,
953 marshal_compat_t *compat = (marshal_compat_t*)compat_data;
954 VALUE real_obj = obj;
955 obj = compat->dumper(real_obj);
956 if (!arg->compat_tbl) {
957 arg->compat_tbl = rb_init_identtable();
959 st_insert(arg->compat_tbl, (st_data_t)obj, (st_data_t)real_obj);
960 if (obj != real_obj && UNDEF_P(ivobj)) hasiv = 0;
963 if (hasiv) w_byte(TYPE_IVAR, arg);
965 switch (BUILTIN_TYPE(obj)) {
967 if (FL_TEST(obj, FL_SINGLETON)) {
968 rb_raise(rb_eTypeError, "singleton class can't be dumped");
971 VALUE path = class2path(obj);
972 VALUE encname = w_encivar(path, arg);
973 w_byte(TYPE_CLASS, arg);
974 w_bytes(RSTRING_PTR(path), RSTRING_LEN(path), arg);
975 w_encname(encname, arg);
982 VALUE path = class2path(obj);
983 VALUE encname = w_encivar(path, arg);
984 w_byte(TYPE_MODULE, arg);
985 w_bytes(RSTRING_PTR(path), RSTRING_LEN(path), arg);
986 w_encname(encname, arg);
992 w_byte(TYPE_FLOAT, arg);
993 w_float(RFLOAT_VALUE(obj), arg);
997 w_byte(TYPE_BIGNUM, arg);
999 char sign = BIGNUM_SIGN(obj) ? '+' : '-';
1000 size_t len = BIGNUM_LEN(obj);
1003 BDIGIT *d = BIGNUM_DIGITS(obj);
1005 slen = SHORTLEN(len);
1006 if (LONG_MAX < slen) {
1007 rb_raise(rb_eTypeError, "too big Bignum can't be dumped");
1011 w_long((long)slen, arg);
1012 for (j = 0; j < len; j++) {
1013#if SIZEOF_BDIGIT > SIZEOF_SHORT
1017 for (i=0; i<SIZEOF_BDIGIT; i+=SIZEOF_SHORT) {
1018 w_short(num & SHORTMASK, arg);
1020 if (j == len - 1 && num == 0) break;
1031 w_uclass(obj, rb_cString, arg);
1032 w_byte(TYPE_STRING, arg);
1033 w_bytes(RSTRING_PTR(obj), RSTRING_LEN(obj), arg);
1037 w_uclass(obj, rb_cRegexp, arg);
1038 w_byte(TYPE_REGEXP, arg);
1040 int opts = rb_reg_options(obj);
1041 w_bytes(RREGEXP_SRC_PTR(obj), RREGEXP_SRC_LEN(obj), arg);
1042 w_byte((char)opts, arg);
1047 w_uclass(obj, rb_cArray, arg);
1048 w_byte(TYPE_ARRAY, arg);
1050 long i, len = RARRAY_LEN(obj);
1053 for (i=0; i<RARRAY_LEN(obj); i++) {
1054 w_object(RARRAY_AREF(obj, i), arg, limit);
1055 if (len != RARRAY_LEN(obj)) {
1056 rb_raise(rb_eRuntimeError, "array modified during dump");
1063 w_uclass(obj, rb_cHash, arg);
1064 if (rb_hash_compare_by_id_p(obj)) {
1065 w_byte(TYPE_UCLASS, arg);
1066 w_symbol(rb_sym_intern_ascii_cstr("Hash"), arg);
1068 if (NIL_P(RHASH_IFNONE(obj))) {
1069 w_byte(TYPE_HASH, arg);
1071 else if (FL_TEST(obj, RHASH_PROC_DEFAULT)) {
1072 rb_raise(rb_eTypeError, "can't dump hash with default proc");
1075 w_byte(TYPE_HASH_DEF, arg);
1077 w_long(rb_hash_size_num(obj), arg);
1078 rb_hash_foreach(obj, hash_each, (st_data_t)&c_arg);
1079 if (!NIL_P(RHASH_IFNONE(obj))) {
1080 w_object(RHASH_IFNONE(obj), arg, limit);
1085 w_class(TYPE_STRUCT, obj, arg, TRUE);
1087 long len = RSTRUCT_LEN_RAW(obj);
1092 mem = rb_struct_members(obj);
1093 for (i=0; i<len; i++) {
1094 w_symbol(RARRAY_AREF(mem, i), arg);
1095 w_object(RSTRUCT_GET_RAW(obj, i), arg, limit);
1101 w_class(TYPE_OBJECT, obj, arg, TRUE);
1102 w_objivar(obj, &c_arg);
1109 if (!rb_obj_respond_to(obj, s_dump_data, TRUE)) {
1110 rb_raise(rb_eTypeError,
1111 "no _dump_data is defined for class %"PRIsVALUE,
1114 v = dump_funcall(arg, obj, s_dump_data, 0, 0);
1115 w_class(TYPE_DATA, obj, arg, TRUE);
1116 w_object(v, arg, limit);
1121 rb_raise(rb_eTypeError, "can't dump %"PRIsVALUE,
1128 w_ivar(hasiv, ivobj, encname, &c_arg);
1133clear_dump_arg(struct dump_arg *arg)
1135 if (!arg->symbols) return;
1136 st_free_table(arg->symbols);
1138 st_free_table(arg->data);
1140 arg->num_entries = 0;
1141 if (arg->compat_tbl) {
1142 st_free_table(arg->compat_tbl);
1143 arg->compat_tbl = 0;
1145 if (arg->encodings) {
1146 st_free_table(arg->encodings);
1149 if (arg->userdefs) {
1150 st_free_table(arg->userdefs);
1155NORETURN(static inline void io_needed(void));
1159 rb_raise(rb_eTypeError, "instance of IO needed");
1164 * dump( obj [, anIO] , limit=-1 ) -> anIO
1166 * Serializes obj and all descendant objects. If anIO is
1167 * specified, the serialized data will be written to it, otherwise the
1168 * data will be returned as a String. If limit is specified, the
1169 * traversal of subobjects will be limited to that depth. If limit is
1170 * negative, no checking of depth will be performed.
1173 * def initialize(str)
1181 * (produces no output)
1183 * o = Klass.new("hello\n")
1184 * data = Marshal.dump(o)
1185 * obj = Marshal.load(data)
1186 * obj.say_hello #=> "hello\n"
1188 * Marshal can't dump following objects:
1189 * * anonymous Class/Module.
1190 * * objects which are related to system (ex: Dir, File::Stat, IO, File, Socket
1192 * * an instance of MatchData, Method, UnboundMethod, Proc, Thread,
1193 * ThreadGroup, Continuation
1194 * * objects which define singleton methods
1197marshal_dump(int argc, VALUE *argv, VALUE _)
1199 VALUE obj, port, a1, a2;
1203 rb_scan_args(argc, argv, "12", &obj, &a1, &a2);
1205 if (!NIL_P(a2)) limit = NUM2INT(a2);
1206 if (NIL_P(a1)) io_needed();
1209 else if (argc == 2) {
1210 if (FIXNUM_P(a1)) limit = FIX2INT(a1);
1211 else if (NIL_P(a1)) io_needed();
1214 return rb_marshal_dump_limited(obj, port, limit);
1218rb_marshal_dump_limited(VALUE obj, VALUE port, int limit)
1220 struct dump_arg *arg;
1221 VALUE wrapper; /* used to avoid memory leak in case of exception */
1223 wrapper = TypedData_Make_Struct(0, struct dump_arg, &dump_arg_data, arg);
1225 arg->symbols = st_init_numtable();
1226 arg->data = rb_init_identtable();
1227 arg->num_entries = 0;
1228 arg->compat_tbl = 0;
1231 arg->str = rb_str_buf_new(0);
1233 if (!rb_respond_to(port, s_write)) {
1237 dump_check_funcall(arg, port, s_binmode, 0, 0);
1243 w_byte(MARSHAL_MAJOR, arg);
1244 w_byte(MARSHAL_MINOR, arg);
1246 w_object(obj, arg, limit);
1248 rb_io_write(arg->dest, arg->str);
1249 rb_str_resize(arg->str, 0);
1251 clear_dump_arg(arg);
1252 RB_GC_GUARD(wrapper);
1266 st_table *partial_objects;
1268 st_table *compat_tbl;
1273check_load_arg(VALUE ret, struct load_arg *arg, const char *name)
1275 if (!arg->symbols) {
1276 rb_raise(rb_eRuntimeError, "Marshal.load reentered at %s",
1281#define load_funcall(arg, obj, sym, argc, argv) \
1282 check_load_arg(rb_funcallv(obj, sym, argc, argv), arg, name_##sym)
1284static void clear_load_arg(struct load_arg *arg);
1287mark_load_arg(void *ptr)
1289 struct load_arg *p = ptr;
1292 rb_mark_tbl(p->symbols);
1293 rb_mark_tbl(p->data);
1294 if (p->partial_objects) rb_mark_tbl(p->partial_objects);
1295 rb_mark_hash(p->compat_tbl);
1299free_load_arg(void *ptr)
1301 clear_load_arg(ptr);
1305memsize_load_arg(const void *ptr)
1307 const struct load_arg *p = (struct load_arg *)ptr;
1309 if (p->symbols) memsize += rb_st_memsize(p->symbols);
1310 if (p->data) memsize += rb_st_memsize(p->data);
1311 if (p->partial_objects) memsize += rb_st_memsize(p->partial_objects);
1312 if (p->compat_tbl) memsize += rb_st_memsize(p->compat_tbl);
1316static const rb_data_type_t load_arg_data = {
1318 {mark_load_arg, free_load_arg, memsize_load_arg,},
1319 0, 0, RUBY_TYPED_THREAD_SAFE_FREE | RUBY_TYPED_EMBEDDABLE
1322#define r_entry(v, arg) r_entry0((v), (arg)->data->num_entries, (arg))
1323static VALUE r_object(struct load_arg *arg);
1324static VALUE r_symbol(struct load_arg *arg);
1326NORETURN(static void too_short(void));
1330 rb_raise(rb_eArgError, "marshal data too short");
1334r_prepare(struct load_arg *arg)
1336 st_index_t idx = arg->data->num_entries;
1338 st_insert(arg->data, (st_data_t)idx, (st_data_t)Qundef);
1343r_byte1_buffered(struct load_arg *arg)
1345 if (arg->buflen == 0) {
1346 long readable = arg->readable < arg->bufsize ? arg->readable : arg->bufsize;
1348 VALUE str, n = LONG2NUM(readable);
1350 str = load_funcall(arg, arg->src, s_read, 1, &n);
1351 if (NIL_P(str)) too_short();
1353 read_len = RSTRING_LEN(str);
1354 if (UNLIKELY(read_len < readable)) too_short();
1355 if (UNLIKELY(read_len > arg->bufsize)) {
1356 arg->buf = ruby_sized_realloc_n(arg->buf, read_len, 1, arg->bufsize);
1357 arg->bufsize = read_len;
1359 memcpy(arg->buf, RSTRING_PTR(str), read_len);
1361 arg->buflen = read_len;
1365 return arg->buf[arg->offset++];
1369r_byte(struct load_arg *arg)
1373 if (RB_TYPE_P(arg->src, T_STRING)) {
1374 if (RSTRING_LEN(arg->src) > arg->offset) {
1375 c = (unsigned char)RSTRING_PTR(arg->src)[arg->offset++];
1382 if (arg->readable >0 || arg->buflen > 0) {
1383 c = r_byte1_buffered(arg);
1386 VALUE v = load_funcall(arg, arg->src, s_getbyte, 0, 0);
1387 if (NIL_P(v)) rb_eof_error();
1388 c = (unsigned char)NUM2CHR(v);
1394NORETURN(static void long_toobig(int size));
1397long_toobig(int size)
1399 rb_raise(rb_eTypeError, "long too big for this architecture (size "
1400 STRINGIZE(SIZEOF_LONG)", given %d)", size);
1404r_long(struct load_arg *arg)
1407 int c = (signed char)r_byte(arg);
1410 if (c == 0) return 0;
1412 if (4 < c && c < 128) {
1415 if (c > (int)sizeof(long)) long_toobig(c);
1418 x |= (long)r_byte(arg) << (8*i);
1422 if (-129 < c && c < -4) {
1426 if (c > (int)sizeof(long)) long_toobig(c);
1429 x &= ~((long)0xff << (8*i));
1430 x |= (long)r_byte(arg) << (8*i);
1437ruby_marshal_read_long(const char **buf, long len)
1440 struct RString src = {RBASIC_INIT};
1441 struct load_arg arg;
1442 memset(&arg, 0, sizeof(arg));
1443 arg.src = rb_setup_fake_str(&src, *buf, len, 0);
1450r_keep_readable(struct load_arg *arg, long len, size_t size)
1452 if (UNLIKELY(len < 0)) {
1453 rb_raise(rb_eArgError, "negative length");
1455 if (UNLIKELY((unsigned long)len > SIZE_MAX / size || arg->readable >= LONG_MAX - len)) {
1456 rb_raise(rb_eArgError, "marshaled data too big");
1462r_bytes1(long len, struct load_arg *arg)
1464 VALUE str, n = LONG2NUM(len);
1466 str = load_funcall(arg, arg->src, s_read, 1, &n);
1467 if (NIL_P(str)) too_short();
1469 if (RSTRING_LEN(str) != len) too_short();
1475r_bytes1_buffered(long len, struct load_arg *arg)
1479 if (len <= arg->buflen) {
1480 str = rb_str_new(arg->buf+arg->offset, len);
1485 long buflen = arg->buflen;
1486 long readable = arg->readable + 1;
1487 long tmp_len, read_len, need_len = len - buflen;
1490 readable = readable < arg->bufsize ? readable : arg->bufsize;
1491 read_len = need_len > readable ? need_len : readable;
1492 n = LONG2NUM(read_len);
1493 tmp = load_funcall(arg, arg->src, s_read, 1, &n);
1494 if (NIL_P(tmp)) too_short();
1497 tmp_len = RSTRING_LEN(tmp);
1499 if (tmp_len < need_len) too_short();
1501 str = rb_str_new(arg->buf+arg->offset, buflen);
1502 rb_str_cat(str, RSTRING_PTR(tmp), need_len);
1504 if (tmp_len > need_len) {
1505 buflen = tmp_len - need_len;
1506 if (UNLIKELY(buflen > arg->bufsize)) {
1507 arg->buf = ruby_sized_realloc_n(arg->buf, buflen, 1, arg->bufsize);
1508 arg->bufsize = buflen;
1510 memcpy(arg->buf, RSTRING_PTR(tmp)+need_len, buflen);
1511 arg->buflen = buflen;
1522#define r_bytes(arg) r_bytes0(r_long(arg), (arg))
1525r_bytes0(long len, struct load_arg *arg)
1529 if (len == 0) return rb_str_new(0, 0);
1530 if (RB_TYPE_P(arg->src, T_STRING)) {
1531 if (RSTRING_LEN(arg->src) - arg->offset >= len) {
1532 str = rb_str_new(RSTRING_PTR(arg->src)+arg->offset, len);
1540 if (arg->readable > 0 || arg->buflen > 0) {
1541 str = r_bytes1_buffered(len, arg);
1544 str = r_bytes1(len, arg);
1551name_equal(const char *name, size_t nlen, const char *p, long l)
1553 if ((size_t)l != nlen || *p != *name) return 0;
1554 return nlen == 1 || memcmp(p+1, name+1, nlen-1) == 0;
1558sym2encidx(VALUE sym, VALUE val)
1560 RBIMPL_ATTR_NONSTRING() static const char name_encoding[8] = "encoding";
1563 if (rb_enc_get_index(sym) != ENCINDEX_US_ASCII) return -1;
1564 RSTRING_GETMEM(sym, p, l);
1565 if (l <= 0) return -1;
1566 if (name_equal(name_encoding, sizeof(name_encoding), p, l)) {
1567 int idx = rb_enc_find_index(StringValueCStr(val));
1570 if (name_equal(name_s_encoding_short, rb_strlen_lit(name_s_encoding_short), p, l)) {
1571 if (val == Qfalse) return rb_usascii_encindex();
1572 else if (val == Qtrue) return rb_utf8_encindex();
1579symname_equal(VALUE sym, const char *name, size_t nlen)
1583 if (rb_enc_get_index(sym) != ENCINDEX_US_ASCII) return 0;
1584 RSTRING_GETMEM(sym, p, l);
1585 return name_equal(name, nlen, p, l);
1588#define BUILD_ASSERT_POSITIVE(n) \
1589 /* make 0 negative to workaround the "zero size array" GCC extension, */ \
1590 ((sizeof(char [2*(ssize_t)(n)-1])+1)/2) /* assuming no overflow */
1591#define symname_equal_lit(sym, sym_name) \
1592 symname_equal(sym, sym_name, BUILD_ASSERT_POSITIVE(rb_strlen_lit(sym_name)))
1595r_symlink(struct load_arg *arg)
1598 long num = r_long(arg);
1600 if (!st_lookup(arg->symbols, num, &sym)) {
1601 rb_raise(rb_eArgError, "bad symbol");
1607r_symreal(struct load_arg *arg, int ivar)
1609 VALUE s = r_bytes(arg);
1612 st_index_t n = arg->symbols->num_entries;
1614 if (rb_enc_str_asciionly_p(s)) rb_enc_associate_index(s, ENCINDEX_US_ASCII);
1615 st_insert(arg->symbols, (st_data_t)n, (st_data_t)s);
1617 long num = r_long(arg);
1619 sym = r_symbol(arg);
1620 idx = sym2encidx(sym, r_object(arg));
1624 rb_enc_associate_index(s, idx);
1625 if (is_broken_string(s)) {
1626 rb_raise(rb_eArgError, "invalid byte sequence in %s: %+"PRIsVALUE,
1627 rb_enc_name(rb_enc_from_index(idx)), s);
1635r_symbol(struct load_arg *arg)
1640 switch ((type = r_byte(arg))) {
1642 rb_raise(rb_eArgError, "dump format error for symbol(0x%x)", type);
1647 return r_symreal(arg, ivar);
1650 rb_raise(rb_eArgError, "dump format error (symlink with encoding)");
1652 return r_symlink(arg);
1657r_unique(struct load_arg *arg)
1659 return r_symbol(arg);
1663r_string(struct load_arg *arg)
1665 return r_bytes(arg);
1669r_entry0(VALUE v, st_index_t num, struct load_arg *arg)
1671 st_data_t real_obj = (st_data_t)v;
1672 if (arg->compat_tbl) {
1673 /* real_obj is kept if not found */
1674 st_lookup(arg->compat_tbl, v, &real_obj);
1676 st_insert(arg->data, num, real_obj);
1677 if (arg->partial_objects) {
1678 st_insert(arg->partial_objects, (st_data_t)real_obj, Qtrue);
1684r_fixup_compat(VALUE v, struct load_arg *arg)
1687 st_data_t key = (st_data_t)v;
1688 if (arg->compat_tbl && st_delete(arg->compat_tbl, &key, &data)) {
1689 VALUE real_obj = (VALUE)data;
1690 rb_alloc_func_t allocator = rb_get_alloc_func(CLASS_OF(real_obj));
1691 if (st_lookup(compat_allocator_tbl, (st_data_t)allocator, &data)) {
1692 marshal_compat_t *compat = (marshal_compat_t*)data;
1693 compat->loader(real_obj, v);
1701r_post_proc(VALUE v, struct load_arg *arg)
1704 v = load_funcall(arg, arg->proc, s_call, 1, &v);
1710r_leave(VALUE v, struct load_arg *arg, bool partial)
1712 v = r_fixup_compat(v, arg);
1714 if (arg->partial_objects) {
1716 st_data_t key = (st_data_t)v;
1717 st_delete(arg->partial_objects, &key, &data);
1720 if (RB_TYPE_P(v, T_MODULE) || RB_TYPE_P(v, T_CLASS)) {
1723 else if (RB_TYPE_P(v, T_STRING)) {
1724 v = rb_str_to_interned_str(v);
1730 v = r_post_proc(v, arg);
1736copy_ivar_i(ID vid, VALUE value, st_data_t arg)
1738 VALUE obj = (VALUE)arg;
1740 if (!rb_ivar_defined(obj, vid))
1741 rb_ivar_set(obj, vid, value);
1746r_copy_ivar(VALUE v, VALUE data)
1748 rb_ivar_foreach(data, copy_ivar_i, (st_data_t)v);
1752#define override_ivar_error(type, str) \
1753 rb_raise(rb_eTypeError, \
1754 "can't override instance variable of "type" '%"PRIsVALUE"'", \
1758r_ivar_encoding(VALUE obj, struct load_arg *arg, VALUE sym, VALUE val)
1760 int idx = sym2encidx(sym, val);
1762 if (rb_enc_capable(obj)) {
1763 // Check if needed to avoid rb_check_frozen() check for Regexps
1764 if (rb_enc_get_index(obj) != idx) {
1765 rb_enc_associate_index(obj, idx);
1769 rb_raise(rb_eArgError, "%"PRIsVALUE" is not enc_capable", obj);
1777r_encname(VALUE obj, struct load_arg *arg)
1779 long len = r_long(arg);
1781 VALUE sym = r_symbol(arg);
1782 VALUE val = r_object(arg);
1783 len -= r_ivar_encoding(obj, arg, sym, val);
1789r_ivar(VALUE obj, int *has_encoding, struct load_arg *arg)
1795 if (RB_TYPE_P(obj, T_MODULE)) {
1796 override_ivar_error("module", rb_mod_name(obj));
1798 else if (RB_TYPE_P(obj, T_CLASS)) {
1799 override_ivar_error("class", rb_class_name(obj));
1802 VALUE sym = r_symbol(arg);
1803 VALUE val = r_object(arg);
1804 if (r_ivar_encoding(obj, arg, sym, val)) {
1805 if (has_encoding) *has_encoding = TRUE;
1807 else if (symname_equal_lit(sym, name_s_ruby2_keywords_flag)) {
1808 if (RB_TYPE_P(obj, T_HASH)) {
1809 rb_hash_ruby2_keywords(obj);
1812 rb_raise(rb_eArgError, "ruby2_keywords flag is given but %"PRIsVALUE" is not a Hash", obj);
1816 rb_ivar_set(obj, rb_intern_str(sym), val);
1818 } while (--len > 0);
1823path2class(VALUE path)
1825 VALUE v = rb_path_to_class(path);
1827 if (!RB_TYPE_P(v, T_CLASS)) {
1828 rb_raise(rb_eArgError, "%"PRIsVALUE" does not refer to class", path);
1833#define path2module(path) must_be_module(rb_path_to_class(path), path)
1836must_be_module(VALUE v, VALUE path)
1838 if (!RB_TYPE_P(v, T_MODULE)) {
1839 rb_raise(rb_eArgError, "%"PRIsVALUE" does not refer to module", path);
1845obj_alloc_by_klass(VALUE klass, struct load_arg *arg, VALUE *oldclass)
1848 rb_alloc_func_t allocator;
1850 allocator = rb_get_alloc_func(klass);
1851 if (st_lookup(compat_allocator_tbl, (st_data_t)allocator, &data)) {
1852 marshal_compat_t *compat = (marshal_compat_t*)data;
1853 VALUE real_obj = rb_obj_alloc(klass);
1854 VALUE obj = rb_obj_alloc(compat->oldclass);
1855 if (oldclass) *oldclass = compat->oldclass;
1857 if (!arg->compat_tbl) {
1858 arg->compat_tbl = rb_init_identtable();
1860 st_insert(arg->compat_tbl, (st_data_t)obj, (st_data_t)real_obj);
1864 return rb_obj_alloc(klass);
1868obj_alloc_by_path(VALUE path, struct load_arg *arg)
1870 return obj_alloc_by_klass(path2class(path), arg, 0);
1874append_extmod(VALUE obj, VALUE extmod)
1876 long i = RARRAY_LEN(extmod);
1878 VALUE m = RARRAY_AREF(extmod, --i);
1879 rb_extend_object(obj, m);
1884#define prohibit_ivar(type, str) do { \
1885 if (!ivp || !*ivp) break; \
1886 override_ivar_error(type, str); \
1889static VALUE r_object_for(struct load_arg *arg, bool partial, int *ivp, VALUE klass, VALUE extmod, int type);
1892r_object0(struct load_arg *arg, bool partial, int *ivp, VALUE extmod)
1894 int type = r_byte(arg);
1895 return r_object_for(arg, partial, ivp, 0, extmod, type);
1899r_object_for(struct load_arg *arg, bool partial, int *ivp, VALUE klass, VALUE extmod, int type)
1901 VALUE (*hash_new_capa)(long) = rb_hash_new_capa;
1909 if (!st_lookup(arg->data, (st_data_t)id, &link)) {
1910 rb_raise(rb_eArgError, "dump format error (unlinked)");
1913 if (arg->partial_objects &&
1914 !st_lookup(arg->partial_objects, (st_data_t)v, &link)) {
1915 if (arg->freeze && RB_TYPE_P(v, T_STRING)) {
1916 v = rb_str_to_interned_str(v);
1918 v = r_post_proc(v, arg);
1925 v = r_object0(arg, true, &ivar, extmod);
1926 if (ivar) r_ivar(v, NULL, arg);
1927 v = r_leave(v, arg, partial);
1933 VALUE path = r_unique(arg);
1934 VALUE m = rb_path_to_class(path);
1935 if (NIL_P(extmod)) extmod = rb_ary_hidden_new(0);
1937 if (RB_TYPE_P(m, T_CLASS)) { /* prepended */
1940 v = r_object0(arg, true, 0, Qnil);
1942 if (c != m || FL_TEST(c, FL_SINGLETON)) {
1943 rb_raise(rb_eArgError,
1944 "prepended class %"PRIsVALUE" differs from class %"PRIsVALUE,
1945 path, rb_class_name(c));
1947 c = rb_singleton_class(v);
1948 while (RARRAY_LEN(extmod) > 0) {
1949 m = rb_ary_pop(extmod);
1950 rb_prepend_module(c, m);
1954 must_be_module(m, path);
1955 rb_ary_push(extmod, m);
1957 v = r_object0(arg, true, 0, extmod);
1958 while (RARRAY_LEN(extmod) > 0) {
1959 m = rb_ary_pop(extmod);
1960 rb_extend_object(v, m);
1963 v = r_leave(v, arg, partial);
1969 VALUE c = path2class(r_unique(arg));
1971 if (FL_TEST(c, FL_SINGLETON)) {
1972 rb_raise(rb_eTypeError, "singleton can't be loaded");
1975 if ((c == rb_cHash) &&
1976 /* Hack for compare_by_identity */
1977 (type == TYPE_HASH || type == TYPE_HASH_DEF)) {
1978 hash_new_capa = rb_ident_hash_new_capa;
1981 v = r_object_for(arg, partial, 0, c, extmod, type);
1982 if (RB_SPECIAL_CONST_P(v) || RB_TYPE_P(v, T_OBJECT) || RB_TYPE_P(v, T_CLASS)) {
1985 if (RB_TYPE_P(v, T_MODULE) || !RTEST(rb_class_inherited_p(c, RBASIC(v)->klass))) {
1986 VALUE tmp = rb_obj_alloc(c);
1988 if (TYPE(v) != TYPE(tmp)) goto format_error;
1990 if (RB_TYPE_P(v, T_STRUCT) &&
1991 RSTRUCT_LEN_RAW(v) != RARRAY_LEN(rb_struct_s_members(c))) {
1992 rb_raise(rb_eTypeError, "struct %"PRIsVALUE" not compatible (struct size differs)",
1995 RBASIC_SET_CLASS(v, c);
2000 rb_raise(rb_eArgError, "dump format error (user class)");
2004 v = r_leave(v, arg, false);
2009 v = r_leave(v, arg, false);
2014 v = r_leave(v, arg, false);
2019 long i = r_long(arg);
2022 v = r_leave(v, arg, false);
2028 VALUE str = r_bytes(arg);
2029 const char *ptr = RSTRING_PTR(str);
2031 if (strcmp(ptr, "nan") == 0) {
2034 else if (strcmp(ptr, "inf") == 0) {
2037 else if (strcmp(ptr, "-inf") == 0) {
2042 d = strtod(ptr, &e);
2043 d = load_mantissa(d, e, RSTRING_LEN(str) - (e - ptr));
2046 v = r_entry(v, arg);
2047 v = r_leave(v, arg, false);
2058 if (sign != '+' && sign != '-') {
2059 rb_raise(rb_eArgError, "invalid Bignum sign");
2061 len = r_keep_readable(arg, r_long(arg), 2);
2063 if (SIZEOF_VALUE >= 8 && len <= 4) {
2064 // Representable within uintptr, likely FIXNUM
2066 for (int i = 0; i < len; i++) {
2067 num |= (VALUE)r_byte(arg) << (i * 16);
2068 num |= (VALUE)r_byte(arg) << (i * 16 + 8);
2070#if SIZEOF_VALUE == SIZEOF_LONG
2076 v = rb_int_uminus(v);
2080 data = r_bytes0(len * 2, arg);
2081 v = rb_integer_unpack(RSTRING_PTR(data), len, 2, 0,
2082 INTEGER_PACK_LITTLE_ENDIAN | (sign == '-' ? INTEGER_PACK_NEGATIVE : 0));
2083 rb_str_resize(data, 0L);
2085 v = r_entry(v, arg);
2086 v = r_leave(v, arg, false);
2091 v = r_entry(r_string(arg), arg);
2092 v = r_leave(v, arg, partial);
2097 VALUE str = r_bytes(arg);
2098 int options = r_byte(arg);
2099 int has_encoding = FALSE;
2100 st_index_t idx = r_prepare(arg);
2103 r_ivar(str, &has_encoding, arg);
2106 if (!has_encoding) {
2107 /* 1.8 compatibility; remove escapes undefined in 1.8 */
2108 char *ptr = RSTRING_PTR(str), *dst = ptr, *src = ptr;
2109 long len = RSTRING_LEN(str);
2111 for (; len-- > 0; *dst++ = *src++) {
2113 case '\\': bs++; break;
2114 case 'g': case 'h': case 'i': case 'j': case 'k': case 'l':
2115 case 'm': case 'o': case 'p': case 'q': case 'u': case 'y':
2116 case 'E': case 'F': case 'H': case 'I': case 'J': case 'K':
2117 case 'L': case 'N': case 'O': case 'P': case 'Q': case 'R':
2118 case 'S': case 'T': case 'U': case 'V': case 'X': case 'Y':
2121 default: bs = 0; break;
2124 rb_str_set_len(str, dst - ptr);
2129 VALUE regexp = rb_reg_init_str(rb_reg_s_alloc(klass), str, options);
2130 r_copy_ivar(regexp, str);
2132 v = r_entry0(regexp, idx, arg);
2133 v = r_leave(v, arg, partial);
2139 long len = r_keep_readable(arg, r_long(arg), 1);
2141 v = rb_ary_new2(len);
2142 v = r_entry(v, arg);
2143 arg->readable += len - 1;
2145 rb_ary_push(v, r_object(arg));
2148 v = r_leave(v, arg, partial);
2157 long len = r_keep_readable(arg, r_long(arg), 2);
2159 v = hash_new_capa(len);
2160 v = r_entry(v, arg);
2161 arg->readable += (len - 1) * 2;
2163 VALUE key = r_object(arg);
2164 VALUE value = r_object(arg);
2165 rb_hash_aset(v, key, value);
2169 if (type == TYPE_HASH_DEF) {
2170 RHASH_SET_IFNONE(v, r_object(arg));
2172 v = r_leave(v, arg, partial);
2181 st_index_t idx = r_prepare(arg);
2182 VALUE klass = path2class(r_unique(arg));
2183 long len = r_keep_readable(arg, r_long(arg), 2);
2185 v = rb_obj_alloc(klass);
2186 if (!RB_TYPE_P(v, T_STRUCT)) {
2187 rb_raise(rb_eTypeError, "class %"PRIsVALUE" not a struct", rb_class_name(klass));
2189 mem = rb_struct_s_members(klass);
2190 if (RARRAY_LEN(mem) != len) {
2191 rb_raise(rb_eTypeError, "struct %"PRIsVALUE" not compatible (struct size differs)",
2192 rb_class_name(klass));
2195 arg->readable += (len - 1) * 2;
2196 v = r_entry0(v, idx, arg);
2197 values = rb_ary_new2(len);
2199 VALUE keywords = Qfalse;
2200 if (RTEST(rb_struct_s_keyword_init(klass))) {
2201 keywords = rb_hash_new();
2202 rb_ary_push(values, keywords);
2205 for (i=0; i<len; i++) {
2206 VALUE n = rb_sym2str(RARRAY_AREF(mem, i));
2207 slot = r_symbol(arg);
2209 if (!rb_str_equal(n, slot)) {
2210 rb_raise(rb_eTypeError, "struct %"PRIsVALUE" not compatible (:%"PRIsVALUE" for :%"PRIsVALUE")",
2211 rb_class_name(klass),
2215 rb_hash_aset(keywords, RARRAY_AREF(mem, i), r_object(arg));
2218 rb_ary_push(values, r_object(arg));
2223 rb_struct_initialize(v, values);
2224 v = r_leave(v, arg, partial);
2231 VALUE name = r_unique(arg);
2232 VALUE klass = path2class(name);
2236 if (!rb_obj_respond_to(klass, s_load, TRUE)) {
2237 rb_raise(rb_eTypeError, "class %"PRIsVALUE" needs to have method '_load'",
2240 data = r_string(arg);
2242 r_ivar(data, NULL, arg);
2245 v = load_funcall(arg, klass, s_load, 1, &data);
2246 v = r_entry(v, arg);
2247 if (st_lookup(compat_allocator_tbl, (st_data_t)rb_get_alloc_func(klass), &d)) {
2248 marshal_compat_t *compat = (marshal_compat_t*)d;
2249 v = compat->loader(klass, v);
2255 v = r_post_proc(v, arg);
2260 case TYPE_USRMARSHAL:
2262 VALUE name = r_unique(arg);
2263 VALUE klass = path2class(name);
2267 v = obj_alloc_by_klass(klass, arg, &oldclass);
2268 if (!NIL_P(extmod)) {
2269 /* for the case marshal_load is overridden */
2270 append_extmod(v, extmod);
2272 if (!rb_obj_respond_to(v, s_mload, TRUE)) {
2273 rb_raise(rb_eTypeError, "instance of %"PRIsVALUE" needs to have method 'marshal_load'",
2276 v = r_entry(v, arg);
2277 data = r_object(arg);
2278 load_funcall(arg, v, s_mload, 1, &data);
2279 v = r_fixup_compat(v, arg);
2280 v = r_copy_ivar(v, data);
2284 v = r_post_proc(v, arg);
2285 if (!NIL_P(extmod)) {
2286 if (oldclass) append_extmod(v, extmod);
2287 rb_ary_clear(extmod);
2294 st_index_t idx = r_prepare(arg);
2295 v = obj_alloc_by_path(r_unique(arg), arg);
2296 if (!RB_TYPE_P(v, T_OBJECT)) {
2297 rb_raise(rb_eArgError, "dump format error");
2299 v = r_entry0(v, idx, arg);
2300 r_ivar(v, NULL, arg);
2301 v = r_leave(v, arg, partial);
2307 VALUE name = r_unique(arg);
2308 VALUE klass = path2class(name);
2312 v = obj_alloc_by_klass(klass, arg, &oldclass);
2313 if (!RB_TYPE_P(v, T_DATA)) {
2314 rb_raise(rb_eArgError, "dump format error");
2316 v = r_entry(v, arg);
2317 if (!rb_obj_respond_to(v, s_load_data, TRUE)) {
2318 rb_raise(rb_eTypeError,
2319 "class %"PRIsVALUE" needs to have instance method '_load_data'",
2322 r = r_object0(arg, partial, 0, extmod);
2323 load_funcall(arg, v, s_load_data, 1, &r);
2324 v = r_leave(v, arg, partial);
2328 case TYPE_MODULE_OLD:
2330 VALUE str = r_bytes(arg);
2332 v = rb_path_to_class(str);
2333 prohibit_ivar("class/module", str);
2334 v = r_entry(v, arg);
2335 v = r_leave(v, arg, partial);
2341 VALUE str = r_bytes(arg);
2343 if (ivp && *ivp > 0) *ivp = r_encname(str, arg) > 0;
2344 v = path2class(str);
2345 prohibit_ivar("class", str);
2346 v = r_entry(v, arg);
2347 v = r_leave(v, arg, partial);
2353 VALUE str = r_bytes(arg);
2355 if (ivp && *ivp > 0) *ivp = r_encname(str, arg) > 0;
2356 v = path2module(str);
2357 prohibit_ivar("module", str);
2358 v = r_entry(v, arg);
2359 v = r_leave(v, arg, partial);
2365 v = r_symreal(arg, *ivp);
2369 v = r_symreal(arg, 0);
2371 v = rb_str_intern(v);
2372 v = r_leave(v, arg, partial);
2376 v = rb_str_intern(r_symlink(arg));
2380 rb_raise(rb_eArgError, "dump format error(0x%x)", type);
2385 rb_raise(rb_eArgError, "dump format error (bad link)");
2392r_object(struct load_arg *arg)
2394 return r_object0(arg, false, 0, Qnil);
2398clear_load_arg(struct load_arg *arg)
2400 ruby_xfree_sized(arg->buf, arg->bufsize);
2406 if (!arg->symbols) return;
2407 st_free_table(arg->symbols);
2409 st_free_table(arg->data);
2411 if (arg->partial_objects) {
2412 st_free_table(arg->partial_objects);
2413 arg->partial_objects = 0;
2415 if (arg->compat_tbl) {
2416 st_free_table(arg->compat_tbl);
2417 arg->compat_tbl = 0;
2422rb_marshal_load_with_proc(VALUE port, VALUE proc, bool freeze)
2426 VALUE wrapper; /* used to avoid memory leak in case of exception */
2427 struct load_arg *arg;
2429 v = rb_check_string_type(port);
2433 else if (rb_respond_to(port, s_getbyte) && rb_respond_to(port, s_read)) {
2434 rb_check_funcall(port, s_binmode, 0, 0);
2439 wrapper = TypedData_Make_Struct(0, struct load_arg, &load_arg_data, arg);
2442 arg->symbols = st_init_numtable();
2443 arg->data = rb_init_identtable();
2444 arg->partial_objects = (RTEST(proc) || freeze) ? rb_init_identtable() : NULL;
2445 arg->compat_tbl = 0;
2448 arg->freeze = freeze;
2451 arg->bufsize = BUFSIZ;
2452 arg->buf = xmalloc(BUFSIZ);
2459 major = r_byte(arg);
2460 minor = r_byte(arg);
2461 if (major != MARSHAL_MAJOR || minor > MARSHAL_MINOR) {
2462 clear_load_arg(arg);
2463 rb_raise(rb_eTypeError, "incompatible marshal file format (can't be read)\n\
2464\tformat version %d.%d required; %d.%d given",
2465 MARSHAL_MAJOR, MARSHAL_MINOR, major, minor);
2467 if (RTEST(ruby_verbose) && minor != MARSHAL_MINOR) {
2468 rb_warn("incompatible marshal file format (can be read)\n\
2469\tformat version %d.%d required; %d.%d given",
2470 MARSHAL_MAJOR, MARSHAL_MINOR, major, minor);
2473 if (!NIL_P(proc)) arg->proc = proc;
2475 clear_load_arg(arg);
2476 RB_GC_GUARD(wrapper);
2482marshal_load(rb_execution_context_t *ec, VALUE mod, VALUE source, VALUE proc, VALUE freeze)
2484 return rb_marshal_load_with_proc(source, proc, RTEST(freeze));
2487#include "marshal.rbinc"
2490 * The marshaling library converts collections of Ruby objects into a
2491 * byte stream, allowing them to be stored outside the currently
2492 * active script. This data may subsequently be read and the original
2493 * objects reconstituted.
2495 * Marshaled data has major and minor version numbers stored along
2496 * with the object information. In normal use, marshaling can only
2497 * load data written with the same major version number and an equal
2498 * or lower minor version number. If Ruby's ``verbose'' flag is set
2499 * (normally using -d, -v, -w, or --verbose) the major and minor
2500 * numbers must match exactly. Marshal versioning is independent of
2501 * Ruby's version numbers. You can extract the version by reading the
2502 * first two bytes of marshaled data.
2504 * str = Marshal.dump("thing")
2505 * RUBY_VERSION #=> "1.9.0"
2509 * Some objects cannot be dumped: if the objects to be dumped include
2510 * bindings, procedure or method objects, instances of class IO, or
2511 * singleton objects, a TypeError will be raised.
2513 * If your class has special serialization needs (for example, if you
2514 * want to serialize in some specific format), or if it contains
2515 * objects that would otherwise not be serializable, you can implement
2516 * your own serialization strategy.
2518 * There are two methods of doing this, your object can define either
2519 * marshal_dump and marshal_load or _dump and _load. marshal_dump will take
2520 * precedence over _dump if both are defined. marshal_dump may result in
2521 * smaller Marshal strings.
2523 * == Security considerations
2525 * By design, Marshal.load can deserialize almost any class loaded into the
2526 * Ruby process. In many cases this can lead to remote code execution if the
2527 * Marshal data is loaded from an untrusted source.
2529 * As a result, Marshal.load is not suitable as a general purpose serialization
2530 * format and you should never unmarshal user supplied input or other untrusted
2533 * If you need to deserialize untrusted data, use JSON or another serialization
2534 * format that is only able to load simple, 'primitive' types such as String,
2535 * Array, Hash, etc. Never allow user input to specify arbitrary types to
2538 * == marshal_dump and marshal_load
2540 * When dumping an object the method marshal_dump will be called.
2541 * marshal_dump must return a result containing the information necessary for
2542 * marshal_load to reconstitute the object. The result can be any object.
2544 * When loading an object dumped using marshal_dump the object is first
2545 * allocated then marshal_load is called with the result from marshal_dump.
2546 * marshal_load must recreate the object from the information in the result.
2551 * def initialize name, version, data
2553 * @version = version
2561 * def marshal_load array
2562 * @name, @version = array
2566 * == _dump and _load
2568 * Use _dump and _load when you need to allocate the object you're restoring
2571 * When dumping an object the instance method _dump is called with an Integer
2572 * which indicates the maximum depth of objects to dump (a value of -1 implies
2573 * that you should disable depth checking). _dump must return a String
2574 * containing the information necessary to reconstitute the object.
2576 * The class method _load should take a String and use it to return an object
2577 * of the same class.
2582 * def initialize name, version, data
2584 * @version = version
2589 * [@name, @version].join ':'
2592 * def self._load args
2593 * new(*args.split(':'))
2597 * Since Marshal.dump outputs a string you can have _dump return a Marshal
2598 * string which is Marshal.loaded in _load for complex objects.
2603 VALUE rb_mMarshal = rb_define_module("Marshal");
2604#define set_id(sym) sym = rb_intern_const(name_##sym)
2609 set_id(s_dump_data);
2610 set_id(s_load_data);
2616 set_id(s_encoding_short);
2617 set_id(s_ruby2_keywords_flag);
2619 rb_define_module_function(rb_mMarshal, "dump", marshal_dump, -1);
2622 rb_define_const(rb_mMarshal, "MAJOR_VERSION", INT2FIX(MARSHAL_MAJOR));
2624 rb_define_const(rb_mMarshal, "MINOR_VERSION", INT2FIX(MARSHAL_MINOR));
2628marshal_compat_table_mark_and_move_i(st_data_t key, st_data_t value, st_data_t _)
2630 marshal_compat_t *p = (marshal_compat_t *)value;
2631 rb_gc_mark_and_move(&p->newclass);
2632 rb_gc_mark_and_move(&p->oldclass);
2637marshal_compat_table_mark_and_move(void *tbl)
2640 st_foreach(tbl, marshal_compat_table_mark_and_move_i, 0);
2644marshal_compat_table_free_i(st_data_t key, st_data_t value, st_data_t _)
2646 SIZED_FREE((marshal_compat_t *)value);
2651marshal_compat_table_free(void *data)
2653 st_foreach(data, marshal_compat_table_free_i, 0);
2654 st_free_table(data);
2658marshal_compat_table_memsize(const void *data)
2660 return st_memsize(data) + sizeof(marshal_compat_t) * st_table_size(data);
2663static const rb_data_type_t marshal_compat_type = {
2664 .wrap_struct_name = "marshal_compat_table",
2666 .dmark = marshal_compat_table_mark_and_move,
2667 .dfree = marshal_compat_table_free,
2668 .dsize = marshal_compat_table_memsize,
2669 .dcompact = marshal_compat_table_mark_and_move,
2671 .flags = RUBY_TYPED_WB_PROTECTED | RUBY_TYPED_THREAD_SAFE_FREE,
2675compat_allocator_table(void)
2677 if (compat_allocator_tbl) return compat_allocator_tbl;
2678 compat_allocator_tbl = st_init_numtable();
2679 compat_allocator_tbl_wrapper =
2680 TypedData_Wrap_Struct(0, &marshal_compat_type, compat_allocator_tbl);
2681 rb_vm_register_global_object(compat_allocator_tbl_wrapper);
2682 return compat_allocator_tbl;
2686rb_marshal_dump(VALUE obj, VALUE port)
2688 return rb_marshal_dump_limited(obj, port, -1);
2692rb_marshal_load(VALUE port)
2694 return rb_marshal_load_with_proc(port, Qnil, false);
Defines RBIMPL_HAS_BUILTIN.
int len
Length of the buffer.
Defines RBIMPL_ATTR_NONSTRING.